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=="
    }
  ]
}

NOTA

Todos os campos são de preenchimento obrigatório, exceto o campo observation.

No campo documents é possível preencher até 3 itens e o campo data de cada documento deve estar no formato base64. Nesse campo poderão ser submetidos os documentos que comprovem a abertura do chargeback, assim como os dados da contestação e da transação. Somente arquivos no formato PDF serão aceitos.

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:

HTTP Code	Código	Descrição	Motivo
400	40032	transaction state is invalid	Não é possível solicitar análise de chargeback para a transação informada (algum pré-requisito não foi atendido: status, data de criação, tipo de transação)
400	40033	replicated chargeback	A análise de chargeback já existe para a transação informada
403	40301	not allowed	O usuário não tem permissão para fazer tal ação
500	50001	internal error	Falha interna no 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.