curl -X POST 'https://api.wovepay.com/v1/billings/refund' \
-H 'X-API-Key: wp_live_SUA_CHAVE' \
-H 'Content-Type: application/json' \
-d '{ "id": "clx_billing", "amount": 50, "reason": "Devolução parcial" }'
{
"success": true,
"message": "Estorno solicitado com sucesso",
"data": {
"id": "clx_billing",
"status": "REFUNDED",
"statusLabel": "Estornado",
"method": "PIX",
"amount": 79.9,
"netAmount": 76.91,
"feeAmount": 2.99,
"description": "Pedido 123",
"externalId": "pay_abc123",
"externalReference": "pedido-123",
"refundExternalId": "ref_xyz",
"createdAt": "2026-05-30T10:00:00.000Z",
"customer": {
"id": "clx_customer",
"name": "Cliente Exemplo",
"taxId": "12345678909"
}
},
"requestId": "req_abc123"
}
Estornar cobrança avulsa
Estorno total ou parcial de cobrança já paga.
POST
/
billings
/
refund
curl -X POST 'https://api.wovepay.com/v1/billings/refund' \
-H 'X-API-Key: wp_live_SUA_CHAVE' \
-H 'Content-Type: application/json' \
-d '{ "id": "clx_billing", "amount": 50, "reason": "Devolução parcial" }'
{
"success": true,
"message": "Estorno solicitado com sucesso",
"data": {
"id": "clx_billing",
"status": "REFUNDED",
"statusLabel": "Estornado",
"method": "PIX",
"amount": 79.9,
"netAmount": 76.91,
"feeAmount": 2.99,
"description": "Pedido 123",
"externalId": "pay_abc123",
"externalReference": "pedido-123",
"refundExternalId": "ref_xyz",
"createdAt": "2026-05-30T10:00:00.000Z",
"customer": {
"id": "clx_customer",
"name": "Cliente Exemplo",
"taxId": "12345678909"
}
},
"requestId": "req_abc123"
}
curl -X POST 'https://api.wovepay.com/v1/billings/refund' \
-H 'X-API-Key: wp_live_SUA_CHAVE' \
-H 'Content-Type: application/json' \
-d '{ "id": "clx_billing", "amount": 50, "reason": "Devolução parcial" }'
{
"success": true,
"message": "Estorno solicitado com sucesso",
"data": {
"id": "clx_billing",
"status": "REFUNDED",
"statusLabel": "Estornado",
"method": "PIX",
"amount": 79.9,
"netAmount": 76.91,
"feeAmount": 2.99,
"description": "Pedido 123",
"externalId": "pay_abc123",
"externalReference": "pedido-123",
"refundExternalId": "ref_xyz",
"createdAt": "2026-05-30T10:00:00.000Z",
"customer": {
"id": "clx_customer",
"name": "Cliente Exemplo",
"taxId": "12345678909"
}
},
"requestId": "req_abc123"
}
Corpo da requisição
string
required
ID interno da cobrança (
clx_...) ou externalId (pay_...).number
Valor parcial em reais; omita para estorno total.
string
Motivo do estorno (opcional).
Estorno disponível para cobranças com status
RECEIVED ou CONFIRMED.Authorizations
Chave wp_live_... criada em Integrações → Chaves de API no dashboard.
Body
application/json

