Processa um reembolso para uma venda existente. Permite reembolso total ou parcial.
Autenticação
Requer um token de acesso válido (CHARGEFY_ACCESS_TOKEN) no header Authorization.
Parâmetros do Body
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|
saleId | string | Sim | ID da venda a ser reembolsada |
amount | integer | Não | Valor em centavos (omitir para reembolso total) |
reason | string | Não | Motivo do reembolso |
Campos da Resposta
| Campo | Tipo | Descrição |
|---|
id | string | ID do reembolso |
saleId | string | ID da venda |
amount | integer | Valor reembolsado em centavos |
currency | string | Moeda |
reason | string | Motivo do reembolso |
status | string | Status (pending, succeeded, failed) |
createdAt | datetime | Data de criação |
Exemplo de Requisição
curl -X POST "https://api.chargefy.io/api/v1/refunds/" \
-H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"saleId": "sale_abc123",
"amount": 5000,
"reason": "Cliente solicitou cancelamento"
}'
Exemplo de Resposta
{
"id": "ref_xyz789",
"saleId": "sale_abc123",
"amount": 5000,
"currency": "brl",
"reason": "Cliente solicitou cancelamento",
"status": "succeeded",
"createdAt": "2026-03-12T14:30:00Z"
}
