IOSOR

IOSOR Γνώση

Συσχέτιση Webhooks κατάστασης DLR με προπληρωμένες δεσμεύσεις

Μάθετε πώς να συμφωνείτε τις εισερχόμενες αναφορές παράδοσης με τα δεσμευμένα προπληρωμένα κεφάλαια για την αποδέσμευση ποσών στην υποδομή IOSOR CPaaS.

Κάθε εξερχόμενο SMS στο IOSOR προκαλεί μια προσωρινή δέσμευση χρημάτων σε USD. Το πρόβλημα εμφανίζεται όταν η καθυστέρηση λήψης του DLR webhook κρατά δεσμευμένο το υπόλοιπο χωρίς λόγο. Η λύση είναι η σωστή συσχέτιση των αναφορών παράδοσης μέσω του API για άμεση εκκαθάριση JIT.

Κατανόηση του μηχανισμού προπληρωμένης δέσμευσης

Στο οικοσύστημα IOSOR, κάθε εξερχόμενο αίτημα SMS ενεργοποιεί έναν άμεσο έλεγχο ledger τύπου JIT (Just-In-Time). Κατά την έναρξη του αιτήματος, το σύστημα τοποθετεί μια προσωρινή δέσμευση στο υπόλοιπο του λογαριασμού για να διασφαλίσει ότι υπάρχουν επαρκή κεφάλαια για την παράδοση του μηνύματος. Αυτή η δέσμευση δεν είναι τελική χρέωση, αλλά μια κράτηση κεφαλαίου. Ο τελικός διακανονισμός πραγματοποιείται μόνο κατά τη λήψη της κατάστασης DLR (Delivery Receipt) από το δίκτυο, διασφαλίζοντας ότι το οικονομικό σας ledger αντικατοπτρίζει με ακρίβεια την πραγματική κατανάλωση πιστώσεων μηνυμάτων.

Ο κύκλος ζωής ενός callback DLR

Μόλις αποσταλεί ένα μήνυμα, το δίκτυο επιστρέφει μια κατάσταση DLR. Το webhook endpoint σας λαμβάνει αυτό το payload, το οποίο περιέχει το μοναδικό ID μηνύματος και τον τελικό κωδικό κατάστασης. Η μηχανή IOSOR συσχετίζει αυτό το ID με την αρχική εγγραφή συναλλαγής. Εάν η κατάσταση υποδεικνύει επιτυχημένη παράδοση, το σύστημα μετατρέπει το δεσμευμένο ποσό σε μόνιμη χρέωση. Εάν η κατάσταση υποδεικνύει αποτυχία, η δέσμευση αποδεσμεύεται στο διαθέσιμο υπόλοιπό σας, διασφαλίζοντας ότι πληρώνετε μόνο για επιτυχημένες προσπάθειες.

Διαχείριση συμφωνίας ledger

Η συμφωνία είναι αυτοματοποιημένη, αλλά οι προγραμματιστές πρέπει να παρακολουθούν την καθυστέρηση μεταξύ της αποστολής και της άφιξης του DLR. Εάν ένα DLR καθυστερήσει, η δέσμευση παραμένει ενεργή, γεγονός που μπορεί να μειώσει προσωρινά τη διαθέσιμη πίστωσή σας. Για λογαριασμούς που διατηρούν ένα ελάχιστο προπληρωμένο όριο USD 20, αυτό είναι κρίσιμο για την αποφυγή διακοπών υπηρεσίας. Εάν ο μηνιαίος όγκος σας υπερβαίνει τα USD 1.000/μήνα, το σύστημά μας ενεργοποιεί μια αναθεώρηση για την προσαρμογή των πιστωτικών σας ορίων και τη διασφάλιση ομαλής διακίνησης για κίνηση υψηλής συχνότητας.

Διαχείριση οριακών περιπτώσεων και χρονικών ορίων

Δεν λαμβάνουν όλα τα μηνύματα ένα DLR εντός του αναμενόμενου χρονικού παραθύρου. Εάν ένα δίκτυο αποτύχει να παρέχει ενημέρωση κατάστασης, το σύστημα IOSOR χρησιμοποιεί μια εργασία καθαρισμού που αποδεσμεύει τις παλιές δεσμεύσεις μετά από ένα καθορισμένο TTL (Time-To-Live). Αυτό αποτρέπει τις 'φανταστικές' δεσμεύσεις από το να επηρεάζουν τη ρευστότητά σας. Πάντα να βεβαιώνεστε ότι ο webhook handler σας επιβεβαιώνει τη λήψη του DLR εντός 500ms για να διατηρείται ο συγχρονισμός μεταξύ του ledger μας και των εσωτερικών λογιστικών σας αρχείων.

Βασικοί πόροι ενσωμάτωσης

Για να διασφαλίσετε ότι η υλοποίησή σας είναι στιβαρή και ακολουθεί τις βέλτιστες πρακτικές για οικονομική ακεραιότητα, ανατρέξτε σε αυτούς τους οδηγούς:

Ξεκινήστε με το IOSOR

Για να ολοκληρώσετε την ενσωμάτωσή σας, μεταβείτε στην Κονσόλα IOSOR και πλοηγηθείτε στις Ρυθμίσεις Webhook για να διαμορφώσετε το τελικό σημείο συμφωνίας καθολικού. Βεβαιωθείτε ότι ο listener σας είναι έτοιμος να επεξεργαστεί το ωφέλιμο φορτίο "dlr.status" και να το αντιστοιχίσει απευθείας στο αντίστοιχο ID δέσμευσης της συναλλαγής. Η δοκιμή αυτής της συσχέτισης στο περιβάλλον sandbox θα εγγυηθεί ότι τα δεσμευμένα κεφάλαια αποδεσμεύονται ή χρεώνονται άμεσα χωρίς αποκλίσεις στο καθολικό.

Σύνοψη IOSOR

Αυτός ο οδηγός έδειξε πώς να γεφυρώσετε με ασφάλεια το χάσμα μεταξύ της παράδοσης μηνυμάτων σε πραγματικό χρόνο και της ακρίβειας του χρηματοοικονομικού καθολικού.

Ήταν χρήσιμος αυτός ο οδηγός;

Σχετικοί οδηγοί