Cartão de crédito

Chargeback

Consulta de contestações em andamento ou concluídas e o que enviar na defesa.

A chave da API de cartão vai no header X-API-KEY. A URL base é entregue pela BW na habilitação do meio. Nos exemplos, BASE representa essa URL.

Quando o status vai para em disputa, a BW pede a documentação da defesa. Se a contestação for aceita, o status termina em chargeback e o valor sai do estabelecimento. Se for recusada, o status vai para devolução de contestação.

GET /v2/chargeback/get

Informe id do chargeback ou idTransaction da venda.

JSON

{
  "ResponseDetail": {
    "IdChargeback": 4052,
    "CaseNumber": "33906321",
    "ChargebackStatus": "Aguardando Defesa",
    "Customer": {
      "Name": "CLIENTE DE TESTE",
      "Identity": "99999999999",
      "Email": "cliente@exemplo.com",
      "Phone": "51999999999"
    },
    "ReasonMessage": "Outras Fraudes - Cartao Ausente",
    "ChargebackDate": "2020-12-03",
    "DisputeDueDate": "2020-12-09",
    "IdTransaction": 7245612,
    "Amount": 290,
    "UrlFiles": [
      { "Name": "comprovante.png", "Url": "https://arquivos.exemplo/comprovante.png" }
    ]
  },
  "HasError": false
}

Campo	Descrição
ChargebackStatus	Situação da defesa. Ex.: Aguardando Defesa.
ReasonMessage	Motivo informado pela bandeira ou pelo emissor.
DisputeDueDate	Prazo para enviar a documentação.
UrlFiles	Arquivos já anexados à disputa.

GET /v2/chargeback/list

Lista contestações em andamento e concluídas. Query obrigatória: pageNumber e rowsPerPage.

cURL

curl --request GET \
  --url 'BASE/v2/chargeback/list?pageNumber=1&rowsPerPage=10' \
  --header 'X-API-KEY: SUA_CHAVE'

A resposta traz TotalItems e a lista em Objects, com os mesmos campos da busca, sem os arquivos.