curl --request POST \
--url https://sandbox.4seletpay.com.br/api/v2/charges/{id}/refund \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"id": "cha_8Kq2Lm9XvB3nT7pZ",
"object": "charge",
"amount": 10000,
"currency": "brl",
"status": "refund_processing",
"paid": true,
"captured": true,
"amount_refunded": 0,
"amount_refundable": 0,
"payment_method_details": {
"type": "card"
},
"payment_intent": "cha_8Kq2Lm9XvB3nT7pZ"
}Estornar cobrança
Estorna uma cobrança paga, total ou parcialmente. Sem amount, estorna todo o saldo restante. Um estorno parcial precisa ser de pelo menos 100 centavos e só um estorno por vez pode estar em processamento.
O estorno é assíncrono. A resposta traz a cobrança em refund_processing. A conclusão chega pelos webhooks charge.refunded ou charge.partial_refunded. O suporte a estorno, inclusive parcial, depende da adquirente da cobrança: quando ela não suporta, a resposta é 422 (refund_not_supported).
curl --request POST \
--url https://sandbox.4seletpay.com.br/api/v2/charges/{id}/refund \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"id": "cha_8Kq2Lm9XvB3nT7pZ",
"object": "charge",
"amount": 10000,
"currency": "brl",
"status": "refund_processing",
"paid": true,
"captured": true,
"amount_refunded": 0,
"amount_refundable": 0,
"payment_method_details": {
"type": "card"
},
"payment_intent": "cha_8Kq2Lm9XvB3nT7pZ"
}amount, o estorno devolve todo o saldo restante da cobrança. Para um estorno parcial, envie amount em centavos (mínimo de 100).200 traz status: "refund_processing". O resultado final chega pelos webhooks charge.refunded ou charge.partial_refunded.422 (refund_not_supported).partially_refunded, e amount_refunded e amount_refundable mostram o valor estornado e o saldo restante.Idempotency-Key para reenviar com segurança. Veja Idempotência e limites.Authorizations
Chave de API (secret key) da conta, no formato sk_live_... (produção) ou sk_test_... (Dev mode). Envie no header Authorization: Bearer <chave>. Autentica todas as rotas da API v2 e as rotas de Análise de Fraude. A chave identifica a conta, então a API v2 não usa o header account. Uma chave só é aceita no ambiente em que foi criada. Gere a sua no dashboard em Configurações → Chaves de API.
Headers
Chave de idempotência opcional e recomendada. Tem até 128 caracteres e vale por 24 horas, por conta. A mesma chave com o mesmo corpo devolve a resposta original (mesmo status e mesmo corpo), sem processar de novo. Só respostas 2xx ficam guardadas: depois de um erro, a mesma chave pode ser reutilizada. A mesma chave com um corpo diferente retorna 422 (idempotency_key_conflict), uma requisição original ainda em andamento retorna 409 (idempotency_key_in_use) e uma chave com mais de 128 caracteres retorna 400 (idempotency_key_invalid).
128"pedido-1024-tentativa-1"
Path Parameters
Identificador do recurso (o campo id devolvido pela API)
Body
Valor a estornar, em centavos. Sem amount, estorna todo o saldo restante. Um estorno parcial precisa ser de pelo menos 100 centavos.
x >= 13000
Response
Estorno solicitado. A cobrança fica em refund_processing até a confirmação
Visão financeira de um pagamento
"cha_8Kq2Lm9XvB3nT7pZ"
charge Valor em centavos
10000
"brl"
failed também cobre cobranças canceladas e expiradas. refund_processing: um estorno foi pedido e aguarda confirmação.
pending, paid, refund_processing, partially_refunded, refunded, chargeback, failed A cobrança foi paga (inclusive se depois foi estornada)
A cobrança foi capturada (mesmo valor de paid)
Valor já estornado, em centavos
0
Valor que ainda pode ser estornado, em centavos
10000
Show child attributes
Show child attributes
O id do pagamento correspondente no pedido ou na fatura
"cha_8Kq2Lm9XvB3nT7pZ"