Statusy transakcji
Każdy wiersz transakcji w panelu ma jeden z tych statusów. Status odzwierciedla najnowsze zdarzenie dla tej transakcji; zwroty i spory aktualizują istniejący wiersz, zamiast wstawiać kolejny obok.
| Status | Znaczenie |
|---|---|
succeeded | Płatność zakończona. Pieniądze są na Twoim koncie (po odjęciu opłat dostawcy). |
pending | Płatność jest w drodze. Częste przy asynchronicznych metodach płatności (ACH, niektóre metody krypto), gdzie potwierdzenie zajmuje od minut do godzin. |
failed | Płatność się nie zakończyła: karta odrzucona, wygasła autoryzacja, twarde odrzucenie. Żadne pieniądze się nie przemieściły. |
partial | Kupujący zapłacił mniej, niż zafakturowano (częste, gdy kupujący krypto wysyła kwotę pomniejszoną o opłatę sieciową). amount wiersza odzwierciedla to, co faktycznie otrzymano; sprawdź metadata.invoicedAmount dla tego, o co poproszono. |
refunded | Pieniądze zostały zwrócone kupującemu, w całości lub częściowo. amount wiersza to zwrócona kwota; zwroty mogą nastąpić dni lub tygodnie po pierwotnej płatności. |
disputed | Kupujący (lub jego bank) otworzył spór lub obciążenie zwrotne. Sprawdź interfejs dostawcy, by poznać okno na odpowiedź. metadata.reason wiersza niesie klasyfikację dostawcy dosłownie. |
pending_manual | Transakcja płatności pocztą oczekuje na Twoje fizyczne potwierdzenie. Zobacz następną sekcję. |
manual_canceled | Kliknąłeś Cancel na oczekującym wierszu płatności pocztą, zanim dotarła płatność kupującego. |
manual_expired | Oczekujący wiersz płatności pocztą stał 30 dni bez potwierdzenia i wygasł automatycznie. |
manual_revoked | Potwierdziłeś odbiór płatności pocztą, ale później cofnąłeś potwierdzenie (np. płatność okazała się nieważna). Wiersz wraca z succeeded do tego stanu końcowego. |
Zwroty, spory, płatności częściowe
Coin Moebius nasłuchuje tych zdarzeń dostawcy i aktualizuje pierwotny wiersz transakcji w panelu. Konkretnie:
- Zwroty: zdarzenie
charge.refundedStripe (zwroty pełne lub częściowe, w tymamount_refunded, by zwroty częściowe pokazywały zwróconą część). IPNrefundedNOWPayments. Status wiersza przechodzi narefunded,amountodzwierciedla zwróconą kwotę, ametadata.originalChargeId/metadata.originalAmountniosą kontekst pierwotnej płatności. - Spory (obciążenia zwrotne): zdarzenie
charge.dispute.createdStripe. Status wiersza przechodzi nadisputed. Podany przez dostawcę powód przechodzi dometadata.reasondosłownie, możesz wyrenderować go we własnym interfejsie, jak zechcesz. - Płatności częściowe: IPN
partially_paidNOWPayments. Status wiersza przechodzi napartial.amountodzwierciedla to, co faktycznie otrzymano (actually_paid);metadata.invoicedAmountto, o co poproszono.
W v1 te zdarzenia są wyświetlane w panelu oraz przez endpoint /status. Przyszłe wydanie doda powiadomienia e-mail i wychodzący przekaźnik webhooków, by Twoje własne zaplecze mogło reagować automatycznie. Na razie skonfiguruj małe zadanie odpytujące (zobacz następną sekcję) albo sprawdzaj panel.