ABabacatepay

Reembolsar um Checkout

Changed on

Reembolsa integralmente um Checkout pago (PIX ou Cartão). O valor reembolsado é igual ao valor original da transação — reembolsos parciais não são suportados.

Cobranças de assinatura não podem ser reembolsadas pela API v2.

post/checkouts/refund

Request

  • Base URL
    https://api.abacatepay.com/v2
  • URL
    https://api.abacatepay.com/v2/checkouts/refund
  • Auth
    HTTP bearer

Request body

idstring required

ID público do checkout a reembolsar. Aceita o bill_ do checkout (resolvido para a cobrança paga) ou o ID da cobrança (char_, pix_char_ ou card_).

reasonstring

Motivo do reembolso. Aparece no histórico da transação.

Example request

{
  "id": "bill_abc123xyz",
  "reason": "Pedido cancelado pelo cliente."
}

Response

Reembolso criado com sucesso.

errorstring nullable
successboolean

Se a requisição obteve sucesso ou não.

Example response

{
  "data": {
    "id": "tran_abc123xyz",
    "status": "COMPLETE",
    "amount": 10000,
    "reason": "Pedido cancelado pelo cliente.",
    "originalId": "bill_abc123xyz",
    "createdAt": "2026-10-05T14:30:00.000Z"
  },
  "success": true
}

Changes

  • 0ac54d6c2796Revision changes
    • warning

      removed the optional property / from the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status