Verificar estorno
POST
/v1/withdraw/verify-refundDispara a verificação de estorno de um saque via PIX Copia e Cola já concluído. Use quando o pagamento foi concluído mas você suspeita que o recebedor devolveu (estornou) o valor. Se o estorno for confirmado, o valor volta ao seu saldo automaticamente, o saque muda para REFUNDED e você recebe o webhook withdraw.refunded. A taxa do saque original não é devolvida.
Permissão necessária: WITHDRAW:CREATE
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
idobrig. | string | ID do saque (wd_… / tx). Precisa ser um saque COMPLETE feito via Copia e Cola (pixKeyType COPIAECOLA). |
Regras
| Parâmetro | Tipo | Descrição |
|---|---|---|
Elegibilidade | regra | Somente saques PIX Copia e Cola (COPIAECOLA) com status COMPLETE. |
Janela | regra | Até 72 horas após a criação do saque. |
Rate limit | regra | 1 verificação a cada 15 minutos por transação (HTTP 429 se exceder). |
Assíncrono | importante | A verificação não credita na hora: acompanhe com refund-status ou aguarde o webhook withdraw.refunded. |
Requisição
bash
curl -X POST https://lynxpix.cc/api/v1/withdraw/verify-refund \
-H "Authorization: Bearer lynx_test_sua_chave" \
-H "Content-Type: application/json" \
-d '{"id":"wd_1a2b3c"}'Resposta
json
{
"data": {
"transactionId": "wd_1a2b3c",
"refundRequested": true,
"refunded": false,
"refundAmount": null,
"refundType": null,
"status": "checking"
},
"error": null
}