Interprete chargebacks em cobranças

Quando uma cobrança entra em processo de chargeback, o objeto chargeback informa a situação atual da contestação e o motivo registrado.

Use essas informações para atualizar seus controles internos, direcionar a análise operacional e acompanhar a cobrança contestada.

Quando utilizar

Consulte o objeto chargeback para:

• identificar cobranças contestadas;
• acompanhar a etapa atual do processo;
• classificar o motivo informado;
• atualizar fluxos de atendimento e conciliação;
• direcionar a análise para o time responsável.

Como interpretar

Exemplo simplificado:

{
  "chargeback": {
    "status": "IN_DISPUTE",
    "reason": "COMMERCIAL_DISAGREEMENT"
  }
}

Nesse exemplo:

• IN_DISPUTE: o chargeback está em disputa;
• COMMERCIAL_DISAGREEMENT: o motivo informado é desacordo comercial.

Status do chargeback

O campo chargeback.status pode retornar:

Motivos do chargeback

O campo chargeback.reason pode retornar:

Trate o chargeback na integração

Quando o objeto chargeback for retornado:

1. leia chargeback.status;
2. armazene o valor exato recebido;
3. atualize a situação da cobrança no seu sistema;
4. utilize chargeback.reason para direcionar a análise;
5. mantenha o histórico das alterações.

Também trate valores ainda não mapeados pela sua aplicação. Nesses casos, preserve o valor original recebido para evitar falhas no processamento.

Próximos passos

• Consulte os eventos de cobranças
• Configure Webhooks
• Entenda os estornos
• Saiba mais sobre chargeback