Listar os reembolsos de uma transação
Os reembolsos pedidos para a transação, do mais novo para o mais antigo.
Permissão da chave: refunds:read.
x-api-key<token>Sua chave de API, criada no painel em Desenvolvedores → Chaves de API.
id*stringO id da transação (txn_…).
Os reembolsos.
application/json- response
data*array<>hasMore*booleantrue quando há mais itens: peça de novo com startingAfter = o id do último.
curl -X GET "https://example.com/api/v1/transactions/string/refunds"{ "data": [ { "id": "ref_01k6g8m2v4x7z9b3c5d7f9h0j2", "transactionId": "txn_01k6g8m2v4x7z9b3c5d7f9h0j2", "amountCents": 8990, "status": "PROCESSING", "reason": "Produto fora de estoque", "failureReason": "string", "livemode": true, "createdAt": "2026-10-04T15:30:00.000Z", "completedAt": "2026-10-04T15:30:00.000Z" } ], "hasMore": true}Reembolsar uma transação POST
Devolve ao pagador todo o valor ainda não reembolsado ou só uma parte (`amountCents`). O valor sai do seu saldo na hora: primeiro do que a venda ainda tem a liberar, depois do disponível. A taxa da venda não é devolvida. O reembolso começa em `PROCESSING`; o webhook `transaction.refunded` confirma, e `refund.failed` avisa quando o banco recusa (o valor volta ao saldo). Vale para vendas pagas há até 90 dias, sem MED aberto. Precisa da permissão `refunds:write`, que vem desligada. Com chave de teste, conclui na hora. Permissão da chave: `refunds:write`.
Consultar o saldo GET
Consulta o saldo da conta: disponível, a liberar e bloqueado por MED, e quanto dá para sacar agora num saque só, já com a taxa de saque. Permissão da chave: `balance:read`.