Transactiestatussen
Elke transactierij in het dashboard heeft een van deze statussen. De status weerspiegelt het meest recente event voor die transactie; terugbetalingen en geschillen werken de bestaande rij bij in plaats van een broer of zus in te voegen.
| Status | Betekenis |
|---|---|
succeeded | Betaling voltooid. Het geld staat op uw account (na providerkosten). |
pending | Betaling is onderweg. Veelvoorkomend bij asynchrone betaalmethoden (ACH, sommige cryptorails) waar bevestiging minuten tot uren duurt. |
failed | Betaling voltooide niet: kaart geweigerd, verlopen autorisatie, harde afwijzing. Er verplaatste geen geld. |
partial | Koper betaalde minder dan gefactureerd (veelvoorkomend wanneer een crypto-koper een met netwerkkosten verminderd bedrag stuurt). Het amount van de rij weerspiegelt wat daadwerkelijk werd ontvangen; controleer metadata.invoicedAmount voor wat werd gevraagd. |
refunded | Geld is teruggegeven aan de koper, volledig of gedeeltelijk. Het amount van de rij is het terugbetaalde bedrag; terugbetalingen kunnen dagen of weken na de oorspronkelijke betaling gebeuren. |
disputed | De koper (of zijn bank) opende een geschil of chargeback. Controleer de interface van de provider voor het responsvenster. Het metadata.reason van de rij draagt de classificatie van de provider letterlijk. |
pending_manual | Een per-post-transactie wacht op uw fysieke bevestiging. Zie de volgende sectie. |
manual_canceled | U klikte op Annuleren op een openstaande per-post-rij voordat de betaling van de koper aankwam. |
manual_expired | Een openstaande per-post-rij bleef 30 dagen zonder bevestiging staan en verliep automatisch. |
manual_revoked | U bevestigde ontvangst van een per-post-betaling maar maakte de bevestiging later ongedaan (bijv. de betaling bleek ongeldig). De rij gaat van succeeded terug naar deze eindstatus. |
Terugbetalingen, geschillen, deelbetalingen
Coin Moebius luistert naar deze provider-events en werkt de oorspronkelijke transactierij in het dashboard bij. Specifiek:
- Terugbetalingen: het
charge.refunded-event van Stripe (volledige of gedeeltelijke terugbetalingen, inclusiefamount_refundedzodat gedeeltelijke terugbetalingen het teruggegeven deel tonen). Derefunded-IPN van NOWPayments. De status van de rij gaat over naarrefunded, hetamountweerspiegelt het terugbetaalde bedrag, enmetadata.originalChargeId/metadata.originalAmountdragen de context van de oorspronkelijke betaling. - Geschillen (chargebacks): het
charge.dispute.created-event van Stripe. De status van de rij gaat over naardisputed. De door de provider opgegeven reden gaat letterlijk door naarmetadata.reason, u kunt hem in uw eigen UI weergeven zoals u kiest. - Deelbetalingen: de
partially_paid-IPN van NOWPayments. De status van de rij gaat over naarpartial. Hetamountweerspiegelt wat daadwerkelijk werd ontvangen (actually_paid);metadata.invoicedAmountis wat werd gevraagd.
In v1 worden deze events getoond in het dashboard en via het /status-endpoint. Een toekomstige release voegt e-mailmeldingen en een uitgaande webhook-doorstuurder toe zodat uw eigen backend automatisch kan reageren. Stel voorlopig een kleine polling-job in (zie de volgende sectie) of controleer het dashboard.