Καταστάσεις και επιστροφές χρημάτων

Καταστάσεις συναλλαγής

Κάθε γραμμή συναλλαγής στον πίνακα ελέγχου έχει μία από αυτές τις καταστάσεις. Η κατάσταση αντικατοπτρίζει το πιο πρόσφατο συμβάν για αυτή τη συναλλαγή· οι επιστροφές χρημάτων και οι διαφορές ενημερώνουν την υπάρχουσα γραμμή αντί να εισάγουν μια αδελφική.

Κατάσταση	Σημασία
`succeeded`	Η πληρωμή ολοκληρώθηκε. Τα χρήματα είναι στον λογαριασμό σας (καθαρά από τις χρεώσεις του παρόχου).
`pending`	Η πληρωμή είναι σε εξέλιξη. Συνηθισμένο με ασύγχρονους τρόπους πληρωμής (ACH, ορισμένοι τρόποι με κρυπτονομίσματα) όπου η επιβεβαίωση παίρνει λεπτά έως ώρες.
`failed`	Η πληρωμή δεν ολοκληρώθηκε: κάρτα που απορρίφθηκε, ληγμένη εξουσιοδότηση, σκληρή απόρριψη. Δεν κινήθηκαν χρήματα.
`partial`	Ο αγοραστής πλήρωσε λιγότερα από όσα τιμολογήθηκαν (συνηθισμένο όταν ένας αγοραστής κρυπτονομισμάτων στέλνει ένα ποσό μειωμένο κατά τη χρέωση δικτύου). Το `amount` της γραμμής αντικατοπτρίζει αυτό που πραγματικά ελήφθη· ελέγξτε το `metadata.invoicedAmount` για αυτό που ζητήθηκε.
`refunded`	Τα χρήματα έχουν επιστραφεί στον αγοραστή, πλήρως ή μερικώς. Το `amount` της γραμμής είναι το ποσό που επιστράφηκε· οι επιστροφές χρημάτων μπορούν να συμβούν ημέρες ή εβδομάδες μετά την αρχική πληρωμή.
`disputed`	Ο αγοραστής (ή η τράπεζά του) άνοιξε μια διαφορά ή αντιστροφή χρέωσης. Ελέγξτε τη διεπαφή του παρόχου για το παράθυρο απάντησης. Το `metadata.reason` της γραμμής φέρει την ταξινόμηση του παρόχου αυτολεξεί.
`pending_manual`	Μια συναλλαγή πληρωμής ταχυδρομικώς αναμένει τη φυσική σας επιβεβαίωση. Δείτε την επόμενη ενότητα.
`manual_canceled`	Κάνατε κλικ στο Ακύρωση σε μια εκκρεμή γραμμή πληρωμής ταχυδρομικώς πριν φτάσει η πληρωμή του αγοραστή.
`manual_expired`	Μια εκκρεμής γραμμή πληρωμής ταχυδρομικώς έμεινε 30 ημέρες χωρίς επιβεβαίωση και έληξε αυτόματα.
`manual_revoked`	Επιβεβαιώσατε τη λήψη μιας πληρωμής ταχυδρομικώς αλλά αργότερα αναιρέσατε την επιβεβαίωση (π.χ., η πληρωμή αποδείχθηκε άκυρη). Η γραμμή μετακινείται από `succeeded` πίσω σε αυτή την τελική κατάσταση.

Επιστροφές χρημάτων, διαφορές, μερικές πληρωμές

Το Coin Moebius ακούει αυτά τα συμβάντα παρόχου και ενημερώνει την αρχική γραμμή συναλλαγής στον πίνακα ελέγχου. Συγκεκριμένα:

Επιστροφές χρημάτων: Το συμβάν charge.refunded του Stripe (πλήρεις ή μερικές επιστροφές, συμπεριλαμβανομένου του amount_refunded ώστε οι μερικές επιστροφές να δείχνουν το μέρος που επιστράφηκε). Το IPN refunded του NOWPayments. Η κατάσταση της γραμμής αλλάζει σε refunded, το amount αντικατοπτρίζει το ποσό που επιστράφηκε, και τα metadata.originalChargeId / metadata.originalAmount φέρουν το πλαίσιο της αρχικής πληρωμής.
Διαφορές (αντιστροφές χρέωσης): Το συμβάν charge.dispute.created του Stripe. Η κατάσταση της γραμμής αλλάζει σε disputed. Ο δηλωμένος λόγος του παρόχου περνά αυτολεξεί στο metadata.reason, μπορείτε να τον αποδώσετε στο δικό σας UI όπως επιλέγετε.
Μερικές πληρωμές: Το IPN partially_paid του NOWPayments. Η κατάσταση της γραμμής αλλάζει σε partial. Το amount αντικατοπτρίζει αυτό που πραγματικά ελήφθη (actually_paid)· το metadata.invoicedAmount είναι αυτό που ζητήθηκε.

Στην v1, αυτά τα συμβάντα εμφανίζονται στον πίνακα ελέγχου και μέσω του /status endpoint. Μια μελλοντική έκδοση θα προσθέσει ειδοποιήσεις email και έναν προωθητή εξερχόμενων webhook ώστε το δικό σας backend να μπορεί να αντιδρά αυτόματα. Προς το παρόν, ρυθμίστε μια μικρή εργασία άντλησης (δείτε την επόμενη ενότητα) ή ελέγξτε τον πίνακα ελέγχου.

Καταστάσεις και επιστροφές χρημάτων

Καταστάσεις συναλλαγής

Επιστροφές χρημάτων, διαφορές, μερικές πληρωμές

Έτοιμοι να το συνδέσετε;