Solicitar Análise de Chargeback

Introdução​

Este guia explica como solicitar análise de chargeback através da API REST.

Esse método é utilizado para solicitar a análise de chargeback de transações que tiveram a identidade do titular do cartão de crédito validada pelo IDPay. O cliente IDPay pode ser ressarcido pela Unico no equivalente ao valor da transação caso haja uma reclamação que derive em um processo de chargeback oficial, que tenha sido devidamente formalizado junto ao adquirente/bandeira, e desde que comprovada, após devidas apurações, a responsabilidade da Unico e erro na decisão do IDPay.

Quando usar essa opção?​

Quando você tiver recebido uma solicitação de chargeback por fraude e acredita que houve erro por parte do IDPay ao validar a identidade do titular do cartão de crédito.

O que é chargeback?​

Chargeback é o processo de apuração de uma contestação de uma compra/transação realizada com cartões de crédito/débito em plataformas online, e que poderá resultar no estorno/cancelamento desta compra/transação. O chargeback pode ser classificado em dois grandes grupos:

• Chargeback por Desacordo Comercial: Quando a transação precisa ser cancelada por algum problema na relação consumidor x estabelecimento. Exemplos: Mercadoria não entregue, mercadoria com defeito, desistência da compra, compra em duplicidade, serviço não prestado, etc.

• Chargeback por Fraude: Quando o titular do cartão alega não ter realizado uma compra em seu nome, se inicia então o processo de disputa entre as partes (quem fica com o prejuízo).

A análise de chargeback somente poderá ser solicitada em casos de chargeback por fraude.

Pré-requisitos para solicitar análise de chargeback​

A análise de chargeback somente poderá ser solicitada para transações que seguem todas as regras abaixo:

• A transação deve ter sido aprovada (status approved);

• A transação deve ter sido criada há menos de 90 dias;

• A transação não ter sido submetida a outra análise de chargeback;

• A transação deve ser do tipo "crédito".

Como usar?​

Faça uma requisição POST para o endpoint /credit/transactions/{transaction_id}/chargeback​

Com o token de acesso válido, faça uma requisição para o endpoint (POST/credit/transactions/{transaction_id}/chargeback) enviando os seguintes parâmetros no corpo da requisição:

{
  "datetime": "2023-01-05T03:00:00.000Z",
  "requestor": {
    "key": "cpf",
    "value": "CPF_DO_USUARIO"
  },
  "name": "NOME_DO_USUARIO",
  "reason": "MOTIVO_DA_SOLICITACAO",
  "observation": "OBSERVACOES_GERAIS",
  "documents": [
    {
      "label": "NOME_DO_ARQUIVO",
      "data": "JVBERi0xLjQKMSAwI=="
    }
  ]
}

A resposta esperada no sucesso da requisição é um JSON contendo o ID da análise de chargeback recém-criada:

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"
}

Caso algum erro aconteça, a resposta esperada é um JSON contendo o código e a mensagem de erro, como no exemplo abaixo:

{
  "code": "40004",
  "message": "transaction id is invalid"
}

A seguir uma lista dos possíveis erros retornados pelo serviço:

Dúvidas?​

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.