LYNX
DocsCartão (recebimento)Estornar venda
1 min de leitura

Estornar venda no cartão

POST/v1/card/refund

Estorna (total ou parcial) uma venda no cartão, devolvendo o valor ao portador. Recebíveis ainda agendados são cancelados; a parte já liquidada é debitada do seu saldo. A taxa da venda NÃO é reembolsada.

Permissão necessária: CARD:REFUND

Boas práticas

  • Chargebacks (contestações do portador) chegam pelo webhook card.chargeback e debitam o saldo automaticamente.

Requisição

bash
curl -X POST https://lynxpix.cc/api/v1/card/refund \
  -H "Authorization: Bearer lynx_test_sua_chave" \
  -H "Content-Type: application/json" \
  -d '[{"name":"id","type":"string","desc":"ID da venda (retornado em /v1/card/in). Informe id OU externalId."},{"name":"externalId","type":"string","desc":"Sua referência externa da venda (alternativa ao id)."},{"name":"amountCents","type":"integer","desc":"Valor a estornar em centavos. Se omitido, estorna o total."}]'

Resposta

json
{
  "data": {
    "refunded": true,
    "chargeback": false,
    "refundedAmountCents": 45000,
    "clawbackCents": 19125,
    "canceledReceivables": 2,
    "full": true
  },
  "error": null
}