Devoluções
Pelo painel, abra o pagamento e clique em Devolver. Você escolhe o valor, total ou parcial.
Pelo código:
curl -X POST https://api.suypay.com/v1/payments/pay_.../refund \
-H "Authorization: Bearer suy_live_..." \
-H "Content-Type: application/json" \
-d '{ "amount": 500 }'
Sem amount, devolve tudo o que ainda não foi devolvido. Você pode fazer várias devoluções parciais.
Mande o cabeçalho Idempotency-Key para poder repetir o pedido sem medo: se a primeira tentativa já tinha passado, a resposta traz a mesma devolução, e o dinheiro não sai duas vezes.
{
"refund": {
"id": "re_9Lm...",
"object": "refund",
"payment_id": "pay_3kXy...",
"amount": 500,
"status": "pending",
"source": "suypay"
},
"payment": { "id": "pay_3kXy...", "status": "partially_refunded", "amount_refunded": 500 }
}
Situação da devolução
status |
O que quer dizer |
|---|---|
pending |
a conta recebeu o pedido e ainda está devolvendo |
succeeded |
o dinheiro voltou para o cliente |
failed |
a conta não conseguiu devolver. O valor volta a contar como recebido |
Muitas contas devolvem na hora. Algumas, como a Appmax e o Pix de várias contas, levam um tempo. Quando a situação muda, chega o aviso refund.updated. A SuyPay também confere de novo, todo dia, as devoluções que ainda estão em andamento.
Devoluções feitas no painel da conta
Se você devolver direto no painel do Mercado Pago, do Asaas ou de outra conta, a SuyPay fica sabendo pelo aviso da conta (ou na conferência) e registra a devolução com source: "provider". O pagamento, o valor devolvido e os relatórios ficam certos sem você fazer nada, e chega o aviso refund.created.
| Conta | O que a SuyPay vê |
|---|---|
| Mercado Pago, Stripe, Efí Bank (Pix) | cada devolução, com a situação dela |
| Asaas, Appmax, Efí Bank (cartão) | o total devolvido |
| Woovi | só as devoluções pedidas pela SuyPay |
Chargeback e MED perdidos não aparecem como devolução: eles ficam em Contestações.
O que cada conta permite
| Conta | Pix | Cartão | Boleto |
|---|---|---|---|
| Mercado Pago | sim | sim | sim |
| Asaas | sim | sim | não |
| Efí Bank | sim | sim | não |
| Stripe | sim | sim | não |
| Appmax | sim | sim | não |
| Woovi | sim | — | — |
Quando a conta não deixa devolver por aqui, a resposta vem com code: "not_refundable". Devolva pelo painel dela: a SuyPay registra do mesmo jeito.
Atenção: no modo Real, o dinheiro volta para o cliente de verdade.