Chargebacks

Consultar chargeback

Detalhe de um chargeback: os mesmos campos da listagem, mais evidence, a defesa com os anexos.

GET/v1/disputes/:caseId

Base URL Produção:https://api.validapay.com.br

Base URL Sandbox:https://sandbox.validapay.com.br

evidence

status: DRAFT ou SUBMITTED.
description: o texto da defesa. null até o envio.
attachments: arquivos anexados, com fileId para baixar ou remover.
submission: andamento depois do envio — status (PENDING, IN_REVIEW, SENT, REJECTED, RESOLVED), sentAt e protocol, o número de protocolo da contestação quando houver. null antes do envio.

Chargeback de outra conta responde 404 CHARGEBACK_CASE_NOT_FOUND, igual a um ID inexistente.

Escopos requeridos

charges/read

Path Parameters

caseIdstringobrigatório

Identificador do chargeback (`caseId`), devolvido na listagem

Query Parameters

typeobrigatório

sempre CHARGEBACK nesta seção

CHARGEBACK

← Anterior

Resumo de chargebacks

Anexar arquivo à defesa

const url = 'https://sandbox.validapay.com.br/v1/disputes/:caseId?type=CHARGEBACK';

const options = {
  method: 'GET',
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Response Examples

200Sucesso▾

JSON

{
    "caseId": "cbk_1790512345678_k3m9q2xwz",
    "type": "CHARGEBACK",
    "status": "DISPUTE",
    "accountId": "460851686",
    "chargeId": "cha_1790012345678_a8f2k1pqz",
    "transactionId": "a1b2c3d4-0000-0000-0000-000000000000",
    "amount": 297.0,
    "originalAmount": 297.0,
    "currency": "BRL",
    "installments": 1,
    "openedAt": "2026-10-20T13:05:41.000Z",
    "updatedAt": "2026-10-20T13:05:41.000Z",
    "closedAt": null,
    "evidenceStatus": "SUBMITTED",
    "evidenceSubmittedAt": "2026-10-21T10:15:27.000Z",
    "evidenceAttachmentCount": 1,
    "submissionStatus": "PENDING",
    "evidence": {
        "description": "Produto entregue em 02/10/2026, conforme comprovante assinado pelo comprador.",
        "status": "SUBMITTED",
        "submittedAt": "2026-10-21T10:15:27.000Z",
        "attachments": [
            {
                "fileId": "evd_1790598765432_r7t2n5vbc",
                "fileName": "comprovante-entrega.pdf",
                "contentType": "application/pdf",
                "size": 184320,
                "uploadedAt": "2026-10-21T10:12:03.000Z"
            }
        ],
        "submission": {
            "status": "PENDING",
            "sentAt": null,
            "protocol": null
        }
    },
    "charge": {
        "chargeId": "cha_1790012345678_a8f2k1pqz",
        "amount": 297.0,
        "status": "DISPUTE",
        "paymentType": "CREDIT_CARD",
        "customerName": "Maria Souza",
        "customerDocument": "12345678901",
        "customerEmail": "maria@exemplo.com.br",
        "productName": "Plano Pro"
    }
}

404Chargeback não encontrado▾

JSON

{
    "error": {
        "message": "Caso de chargeback não encontrado",
        "code": "CHARGEBACK_CASE_NOT_FOUND",
        "details": null,
        "timestamp": "2026-10-28T14:20:00.000Z"
    }
}

400Tipo inválido▾

JSON

{
    "error": {
        "message": "Parâmetro 'type' é obrigatório e deve ser MED, CHARGEBACK ou REFUND",
        "code": "INVALID_DISPUTE_TYPE",
        "details": null,
        "timestamp": "2026-10-28T14:20:00.000Z"
    }
}

← Anterior

Resumo de chargebacks

Anexar arquivo à defesa