Consultar análise de chargeback
Introdução
Este guia explica como consultar andamento de uma análise de chargeback através da API REST. Para entender melhor o que é um chargeback e como o IDPay atua nesses casos, veja a guia Solicitar análise de chargeback.
Como usar?
Faça uma requisição GET para o endpoint /credit/transactions/{transaction_id}/chargeback/{chargeback_id}
Com um token de acesso válido, faça uma requisição para o endpoint (GET/credit/transactions/{transaction_id}/chargeback/{chargeback_id}).
A resposta esperada no sucesso da requisição é um JSON contendo o ID da análise de chargeback e seu status, como o exemplo seguinte:
{
"id": "8263a268-5388-492a-bca2-28e1ff4a69f0",
"status": "waiting"
}
Para mais informações sobre o status de análise de chargeback, veja a guia Enumerados.
Caso algum erro aconteça, a resposta de retorno é um JSON contendo o erro e o código do erro:
{
"error": {
"code": "40004",
"description": "transaction id is invalid"
}
}
A seguir uma lista dos possíveis erros retornados pelo serviço:
HTTP Code | Código | Descrição | Motivo |
---|---|---|---|
400 | 40004 | transaction id is invalid | O ID da transação é inválido (formato) |
403 | 40301 | not allowed | O usuário não tem permissão para fazer tal ação |
404 | 40407 | chargeback not found | A análise de chargeback não foi encontrada |
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.