Status de transação
Cada linha de transação no painel tem um destes status. O status reflete o evento mais recente daquela transação; reembolsos e disputas atualizam a linha existente em vez de inserir uma irmã.
| Status | Significado |
|---|---|
succeeded | Pagamento concluído. O dinheiro está na sua conta (líquido das taxas do provedor). |
pending | O pagamento está em trânsito. Comum com métodos de pagamento assíncronos (ACH, alguns métodos de cripto) onde a confirmação leva de minutos a horas. |
failed | O pagamento não foi concluído: cartão recusado, autorização expirada, rejeição rígida. Nenhum dinheiro se moveu. |
partial | O comprador pagou menos do que o faturado (comum quando um comprador de cripto envia um valor reduzido pela taxa de rede). O amount da linha reflete o que foi de fato recebido; verifique metadata.invoicedAmount para saber o que foi solicitado. |
refunded | O dinheiro foi devolvido ao comprador, total ou parcialmente. O amount da linha é o valor reembolsado; reembolsos podem acontecer dias ou semanas após o pagamento original. |
disputed | O comprador (ou o banco dele) abriu uma disputa ou estorno. Verifique a interface do provedor para a janela de resposta. O metadata.reason da linha carrega a classificação do provedor literalmente. |
pending_manual | Uma transação de pagamento por correio está aguardando a sua confirmação física. Veja a próxima seção. |
manual_canceled | Você clicou em Cancelar em uma linha pendente de pagamento por correio antes de o pagamento do comprador chegar. |
manual_expired | Uma linha pendente de pagamento por correio ficou 30 dias sem confirmação e expirou automaticamente. |
manual_revoked | Você confirmou o recebimento de um pagamento por correio mas depois desfez a confirmação (por exemplo, o pagamento acabou sendo inválido). A linha sai de succeeded de volta para este estado terminal. |
Reembolsos, disputas, pagamentos parciais
Coin Moebius ouve estes eventos de provedor e atualiza a linha de transação original no painel. Especificamente:
- Reembolsos: o evento
charge.refundeddo Stripe (reembolsos totais ou parciais, incluindoamount_refundedpara que reembolsos parciais mostrem a fatia que foi devolvida). O IPNrefundeddo NOWPayments. O status da linha muda pararefunded, oamountreflete o valor reembolsado, emetadata.originalChargeId/metadata.originalAmountcarregam o contexto do pagamento original. - Disputas (estornos): o evento
charge.dispute.createddo Stripe. O status da linha muda paradisputed. O motivo declarado pelo provedor passa parametadata.reasonliteralmente, você pode renderizá-lo na sua própria interface como quiser. - Pagamentos parciais: o IPN
partially_paiddo NOWPayments. O status da linha muda parapartial. Oamountreflete o que foi de fato recebido (actually_paid);metadata.invoicedAmounté o que foi solicitado.
Na v1, esses eventos são exibidos no painel e via o endpoint /status. Uma versão futura adicionará notificações por e-mail e um encaminhador de webhook de saída para que o seu próprio backend possa reagir automaticamente. Por enquanto, configure um pequeno job de consulta (veja a próxima seção) ou verifique o painel.