Skip to main content
POST
Reembolsar Checkout Transparente
Reembolsa o valor total de uma cobrança do checkout transparente paga por Pix ou cartão. Boleto não tem reembolso.
Requer a permissão REFUND:CREATE.

Entenda os reembolsos

Regras, status, cartão já liquidado, webhooks e todas as mensagens de erro.
O id é o que voltou na criação da cobrança.
reason é opcional, com até 500 caracteres.

Erros desta rota

As demais mensagens, como saldo insuficiente ou cobrança em disputa, estão em Reembolsos.

Authorizations

Authorization
string
header
required

Todas as requisições devem incluir sua chave de API no header Authorization usando o formato Bearer <abacatepay-api-key>. Sem esse header a requisição será rejeitada.

Saiba mais sobre como criar e usar chaves de API na documentação de autenticação.

Body

application/json
id
string
required

ID da cobrança transparente (pix_char_, card_ ou char_). O bill_ de checkouts e links é recusado nesta rota.

Example:

"pix_char_abc123xyz"

reason
string

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

Maximum string length: 500
Example:

"Cliente pagou em duplicidade."

Response

Reembolso criado com sucesso.

data
object
error
string | null
Example:

null

success
boolean

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

Example:

true