Bunne Docs
Estornos

Estornar uma cobrança paga.

Estorna uma cobrança paga ou parcialmente estornada. Omita amount_cents para estornar o saldo restante.

POST
/charges/{id}/refund

Estorna uma cobrança paga ou parcialmente estornada. Omita amount_cents para estornar o saldo restante.

Autorização

ApiKeyAuth
AutorizaçãoBearer <token>

Em: header

Parâmetros de caminho

id*string
Match^ch_[A-Za-z0-9]+$

Parâmetros de cabeçalho

Idempotency-Key?string
Tamanho1 <= length <= 255

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body em TypeScript.

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/charges/ch_xxx/refund" \  -H "Idempotency-Key: order_123_attempt_1" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "string",  "object": "refund",  "status": "pending",  "charge_id": "string",  "amount_cents": 1,  "currency": "BRL",  "reason": "string",  "provider_reference": "string",  "succeeded_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "request_id": "req_xxx"}

Atualizar a reserva de hospedagem de uma cobrança. PATCH

Avisa o gateway de que a reserva por trás de uma venda paga mudou. Recalcula os recebíveis AINDA EM ABERTO daquela venda contra as novas datas. Recebível já liberado nunca é puxado de volta — a resposta informa quantos foram pulados, para o integrador descobrir na hora em vez de por acidente. `status: canceled|no_show` é INFORMATIVO: não movimenta dinheiro e não abre o portão de liberação; o estorno continua saindo por POST /charges/{id}/refund, por quem é dono da política de tarifa. Exige a permissão charges:create — mexer na reserva é mexer no cronograma do dinheiro.

Consultar o saldo do seller. GET

Retorna o saldo pendente, disponível, reservado e passível de solicitação para uma API key com escopo de seller, com o detalhamento do que está retido: reserve_held_cents (rolling reserve, que não entra em pending_cents/available_cents e volta ao saldo na liberação), clawback_held_cents (retido por dívida de chargeback/estorno) e held_back_cents (total retido do liberado = available_cents − requestable_cents). Exige a permissão balance:read e uma key com escopo de seller.