Consultar uma solicitação de reembolso

GET

/api/partner/v1/refunds/{code}

Retorna o estado atual da solicitação e o histórico completo de
transições em events.

Use esta rota para reconciliar quando perder a entrega de um webhook
refund, ou para confirmar o desfecho antes de liberar/estornar algo do
seu lado.

A busca é escopada pelo dono do token: uma solicitação de outro seller
responde 404 com corpo idêntico ao de um código inexistente.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Respostas

🟢200

application/json

Solicitação encontrada, com histórico de eventos.

Bodyapplication/json

🟠404

🟠401Unauthorized

🟠403FeatureDisabled

🟠429TooManyRequests

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/partner/v1/refunds/rfd_7c02e5a1b3' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "data": {
        "code": "rfd_7c02e5a1b3",
        "status": "rejected",
        "status_label": "Reprovado",
        "amount": "250.00",
        "fee": "1.00",
        "total": "251.00",
        "reason": "product_not_delivered",
        "reason_label": "Produto não entregue",
        "reason_details": "Cliente relatou que o produto nunca foi entregue e solicitou a devolução do valor.",
        "rejection_category": "insufficient_documentation",
        "rejection_category_label": "Documentação insuficiente",
        "rejection_reason": "Documentação insuficiente para comprovar o pedido de reembolso.",
        "provider_receipt": null,
        "executed_at": null,
        "requested_at": "2026-08-10T14:35:00.000000Z",
        "approved_at": null,
        "rejected_at": "2026-08-11T09:12:00.000000Z",
        "completed_at": null,
        "cancelled_at": null,
        "transaction": {
            "reference_id": "9c1e2f3a-5b47-4d8e-9f21-6a0b3c4d5e6f",
            "end_to_end_id": "E1234567820260810143000abcdef123",
            "amount": "250.00",
            "paid_at": "2026-08-01T12:00:00.000000Z",
            "method": "pix",
            "fees": "12.45",
            "product": {
                "name": "Curso de Fotografia"
            },
            "client": {
                "name": "Maria Silva",
                "email": "maria@example.com",
                "document": "12345678901",
                "phone": "+5511999999999"
            }
        },
        "events": [
            {
                "event": "created",
                "actor_type": "partner",
                "payload": {
                    "reason": "product_not_delivered"
                },
                "occurred_at": "2026-08-10T14:35:00.000000Z"
            },
            {
                "event": "rejected",
                "actor_type": "admin",
                "payload": {
                    "category": "insufficient_documentation",
                    "reason": "Documentação insuficiente para comprovar o pedido de reembolso."
                },
                "occurred_at": "2026-08-11T09:12:00.000000Z"
            }
        ]
    }
}

Modificado em 2026-08-14 16:36:50

Página anterior

Solicitar reembolso de uma venda

Próxima página

Cash-in criado (cobrança PIX gerada)