Μερική και πλήρης επαναπλήρωση

TL, DR

Ανεφοδιασμός είναι η αντίστροφη πράξη επί του δεσμευμένου ποσού. Το πλήρες κλείσιμο ολόκληρης της συναλλαγής, μερική απόδοση ενός μέρους (μπορεί να είναι μια μερική σειρά μέχρι το πλήρες). Κρίσιμη: επιστροφή χρημάτων στην πηγή, αυστηρή ταυτότητα, καταγραφή λόγων και ενορχήστρωση με webhooks/retras. Ποσοστό επιστροφής του μέτρου, TtR p95, Σφάλμα επιστροφής και εξάλειψη των αντιγράφων/ασυνεπειών μέσω αυτόματων συμφωνιών.

1) Όροι και θεμελιώδεις διαφορές

Πλήρης επιστροφή - Επιστρέφει ολόκληρο το ποσό της δέσμευσης ("επιστροφή _ ποσό = capture_amount').
Μερική επιστροφή - επιστρέφει ένα μέρος ('0 <refund_amount <capture_amount'), επιτρέπει το υπόλοιπο μέρος στο σύνολο' capture _ ποσό '.
Επιστροφή στην πηγή - επιστροφή στην αρχική μέθοδο/ράγες πληρωμής (προτιμώμενη/υποχρεωτική από τις κανονιστικές αρχές).
Κενό - η ακύρωση για σύλληψη (αν υποστηρίζεται από σιδηροτροχιές), δεν θεωρείται επαναπληρωτής.
Αντιστροφή/χρέωση - τραπεζική/σιδηροδρομική μηχανική εκτός της πρωτοβουλίας σας (διαφορές, χρέωση) - δεν πρέπει να συγχέεται με επαναπλήρωση.

2) Πότε να εκδοθεί πλήρης έναντι μερικής

• Ακύρωση ολόκληρης της εντολής/υπηρεσίας, διπλή διαγραφή, σφάλμα συστήματος.
• Υποχρεωτική εάν η υπηρεσία δεν παρέχεται (σύμφωνα με τους κανόνες του καταναλωτή/ρυθμιστή).

• Μερική ακύρωση της υπηρεσίας, αναλογικές προσαρμογές (εκπτώσεις, αποζημίωση για καθυστερήσεις).
• Τεχνικά όρια σιδηροτροχιών (μέγιστο ποσό ανά πράξη) - μερική σειρά.
• Μετα-factum προμήθεια παρακράτηση (όπου επιτρέπεται η κανονιστική ρύθμιση) - λιγότερο συχνά στο iGaming.

3) Πολιτικές και όρια

Επιστροφή στην πηγή = ισχύει εξ ορισμού. εξαιρέσεις - μέσω MLRO/υποθέσεων συμμόρφωσης (καταχωρισμένες).
Αποκοπή: επιτρέπεται η επαναπλήρωση N ημερών από τη σύλληψη (κατά μέθοδο/δικαιοδοσία).
Max Partial Count: όχι περισσότερο από K μερική ανά πληρωμή (τυπικά K ≤ 5).
Ελάχιστη μερική ποσότητα: όχι κατώτερη από την ελάχιστη τεχνική σιδηροτροχιά/ΠΥΠ.

• Υποστηρικτικός παράγοντας: μερική ≤ X, πλήρης ≤ Y.
• Διαχειριστής/Χρηματοπιστωτικός Οργανισμός: εκτός ορίων, εξαιρέσεις μεταξύ μεθόδων.
• Ψύξη σε επαναλαμβανόμενες προσπάθειες (αντι-αναπήδηση).

4) Αρχιτεκτονική και ροή γεγονότων

• Ο ενορχηστρωτής πληρωμών είναι η πηγή της αλήθειας του καθεστώτος.
• Υπηρεσία επιστροφής - API, idempotency, ενορχήστρωση retrays, υλοτομία.
• Προσαρμογείς PSP - Ενσωμάτωση μεθόδων.
• Συμφιλίωση - αυτόματες συμφωνίες, DLQ, διορθώσεις.
• Λογιστική - δημοσιεύσεις, αποστάτες, εκκαθάριση με ξέφωτα.
• Κίνδυνος/συμμόρφωση - Κυρώσεις/έλεγχοι SoF σε αμφιλεγόμενα σενάρια.

1. "Επιστροφή. Δημιουργία "(API) επικύρωσης → (όρια, ισορροπία, πολιτική, KYC/SoF εάν είναι απαραίτητο).

2. ('hash ( + + λόγος + nonce)').

3. Η κλήση PSP → «ΕΚΚΡΕΜΕΙ».

4. Webhook/δημοσκόπηση → 'SUCCESS '/' FAILED', όταν timeout - retrays με το ίδιο κλειδί.

5. Δημοσίευση της εκδήλωσης στις ειδοποιήσεις Kafka → Ledger, BI.

6. Αυτόματη συμφωνία: χαρτογράφηση 'πάροχος _ επιστροφή _ id' στο μητρώο.

5) Ιδιαιτερότητα και αντίκρουση

Το ίδιο refand δεν μπορεί να αναγνωριστεί δύο φορές: όλη η λογική μέσω αποθήκευσης idempotency (KV/Redis + TTL).
Κλειδιά στο payment_id × ποσό × λόγο (και, εάν είναι απαραίτητο, 'μερικός _ δείκτης').
Τα retrays χρησιμοποιούν το ίδιο κλειδί.
Η παράλληλη μερική προστατεύεται από κλείδες γραμμής/αισιόδοξη έκδοση για τα συνολικά ποσά.

python def refund(payment_id, amount, reason, idem_key):
if idem_store. exists(idem_key): return idem_store. get(idem_key)
with tx():
p = db. get_payment(payment_id, for_update=True)
assert p. captured_amount - p. refunded_amount >= amount > 0 r = p. create_refund(amount, reason, status='PENDING', idem_key=idem_key)
resp = psp. refund(p. provider_txid, amount, idem_key)
return finalize(r, resp. status, resp. ext_id)

6) Υπόδειγμα δεδομένων (ελάχιστο)

json
{
"payment_id": "pay_123",
"captured_amount": 150. 00,
"currency": "EUR",
"refunded_amount": 40. 00,
"refunds": [
{
"refund_id": "rf_001",
"type": "partial    full",
"amount": 20. 00,
"reason_code": "PARTIAL_SERVICE",
"idempotency_key": "idem_a1",
"status": "PENDING    SUCCESS    FAILED",
"provider_refund_id": "psp_rf_9xz",
"created_at": "2025-11-03T12:00:00Z",
"credited_at": "2025-11-03T15:05:00Z",
"notes": "ticket #456"
}
],
"flags": {
"refund_to_source": true,
"jurisdiction": "EEA",
"kyc_tier_required": "tier2"
}
}

7) Χαρακτηριστικά των γραμμών πληρωμής

Κάρτες (Visa/Mastercard)

Υποστήριξη πλήρους/μερικής· συχνά μερικώς· Η TtR εξαρτάται από την τράπεζα του πελάτη (T + 1... T + 5 μβ).
Webhooks για την επιτυχία έρχονται γρήγορα, αλλά η εγγραφή για την απαλλαγή μπορεί να είναι αργά → εξηγούμε στα πρότυπα υποστήριξης.

Τραπεζική/RTP

Συχνά άμεση απόδοση (αντιστροφή/πιστωτική ώθηση)· ορισμένοι πάροχοι υποστηρίζουν μόνο πλήρη ή 1 μερική.
Αυστηρή δέσμευση για τον αρχικό λογαριασμό. απαιτείται επιστροφή στην πηγή.

Ηλεκτρονικά πορτοφόλια

Κανονικό πλήρες/μερικό· TtR λεπτά, μερικών και ελάχιστων ποσοτικών ορίων.

Κουπόνια/Προπληρωμένα

Συνήθως, η → πολιτική δεν είναι διαθέσιμη για επιστροφή χρημάτων στην πηγή: επιστροφή στο εσωτερικό πορτοφόλι ή επανέκδοση κουπονιού (εάν ο πάροχος γνωρίζει πώς). Απαιτεί ρήτρες συμμόρφωσης.

Crypto

Σιδηροτροχιές - πτητικές. κατά προτίμηση δεν χρησιμοποιείται ως μέθοδος επαναπλήρωσης. Εάν επιτρέπεται: επιστροφή στην ίδια διεύθυνση/ανταλλαγή με τεκμηριωμένη ισοτιμία και προμήθειες. Έλεγχος AML.

8) Λογιστική, συμφωνία και χρηματοδότηση

Ledger: «DR Revenue/CR Cash» positions at capture? σχετικά με την επιστροφή χρημάτων - σύνταξη. Η μερική αντικατοπτρίζεται αναλογικά.
Αναγνώριση: στο iGaming, το refand μειώνει τον GGR της αντίστοιχης περιόδου (λογιστική πολιτική).
Συμφιλίωση: καθημερινός έμπορος συμφωνιών _ επιστροφή _ id ↔ provider_refund_id', καθεστώς, ποσά, ποσοστά FX.
FX: καθορισμός της λογικής των μαθημάτων (κατά τη στιγμή της σύλληψης ή κατά τη στιγμή της επιστροφής), κατά περίπτωση· συγκράτηση του καννάβου διασποράς.

9) ΒΔΕ, στόχοι και προειδοποιήσεις (Υγεία επιστροφών)

Ποσοστό επιστροφής = "Επιστροφές _ Tx/ Captured_Tx'.
Λόγος ποσού επιστροφής = 'Επιστρέφεται _ Ποσό/ Captured_Amount'.
TtR p95 = p95 ('credited _ at - created_at') ανά μέθοδο.
Ποσοστό σφάλματος επιστροφής = 'Αποτυχία/Απόπειρα' (<0. 3%).
Επιστροφή στην πηγή% ≥ 95% (κατά περίπτωση).
Περιστατικά διπλής επιστροφής = 0.

• Το «TtR p95» είναι υψηλότερο από το SLO με τη μέθοδο P2.
• Spikes by 'Rate Rate' in one provider/BIN → P1 (check grabs/doubles).
• Κάθε 'διπλή επιστροφή> 0' → P0 (άμεση κατάψυξη αυτόματων επαναπληρωμάτων).

10) Φέτες SQL

10. Προφίλ επαναπλήρωσης 1

sql
SELECT
DATE_TRUNC('day', r. created_at) AS d,
method_code, provider,
COUNT() FILTER (WHERE r. status='SUCCESS')  AS refunds_ok,
COUNT() FILTER (WHERE r. status='FAILED')  AS refunds_fail,
SUM(r. amount) AS refunded_amount,
PERCENTILE_CONT(0. 95) WITHIN GROUP (ORDER BY EXTRACT(EPOCH FROM (r. credited_at - r. created_at))) AS ttr_p95_sec
FROM refunds r
JOIN payments p ON p. payment_id = r. payment_id
GROUP BY 1,2,3;

10. 2 Έλεγχος ισοζυγίου για μερική

sql
SELECT p. payment_id,
p. captured_amount,
SUM(r. amount) AS refunded_sum,
(p. captured_amount - SUM(r. amount)) AS refundable_left
FROM payments p
LEFT JOIN refunds r ON r. payment_id = p. payment_id AND r. status IN ('SUCCESS','PENDING')
GROUP BY 1,2
HAVING (p. captured_amount - SUM(r. amount)) < 0;

11) UX και υποστήριξη

Υποδείγματα μηνυμάτων με μεθόδους: εξηγούμε την πιθανή καθυστέρηση της απόρριψης σε κάρτες, A2A - σχεδόν αμέσως.
Καθεστώς στο γραφείο: «Εκδοθέν Κατά τη διαδικασία επιστροφής». Εμφάνιση της αναμενόμενης ημερομηνίας καταχώρησης.
Λόγοι (reason_code) - αναγνώσιμοι από άνθρωπο: «διπλή διαγραφή», «ακύρωση υπηρεσίας», «μερική αποζημίωση».
Μερική αυτοεξυπηρέτηση - ασφαλής μόνο με όρια και σαφείς κανόνες.

12) Κίνδυνος και συμμόρφωση

Καταπολέμηση της νομιμοποίησης εσόδων από παράνομες δραστηριότητες: ο επαναπατρισμός δεν πρέπει να μετατραπεί σε έξοδο σε εναλλακτικό δίαυλο· να προβεί σε εξαιρέσεις από την έγκριση MLRO.
Κυρώσεις/REP: για επιστροφές που αρχίζουν σε «κόκκινους» λογαριασμούς/λεπτομέρειες - υποχρεωτική επαλήθευση.
DSAR/Διατήρηση - Αποθήκευση ιχνών επαναπλήρωσης στο πλαίσιο πολιτικής κατακράτησης.
Τοπικοί κανόνες: όροι και διαδικασία επιστροφής (π.χ. κανονισμοί για τους καταναλωτές) - που αντικατοπτρίζονται στην πολιτική.

13) Συχνά λάθη και τρόπος αποφυγής τους

Διπλή επαναπλήρωση λόγω έλλειψης ευελιξίας και επαναλαμβανόμενων webhooks → αποθήκευση πλήκτρου/κατάστασης idem, ελέγξτε την ισορροπία.
Μερική> ισορροπία → κλείδωμα γραμμής/αισιόδοξη έκδοση και αυστηροί έλεγχοι.
Η πολλαπλή μέθοδος επιστροφής χωρίς άδεια συμμόρφωσης → παραβιάζει την επιστροφή στην πηγή.
Ανάμειξη κενών και επιστροφών σε αναφορές → στρέβλωση των KPI.
Δεν υπάρχουν αυτόματοι έλεγχοι → μαύρες τρύπες μεταξύ του PSP και του βιβλίου σας.

14) Βιβλία παιχνιδιών

Μια αύξηση στον πάροχο επιστρέφει → ελέγχει τις αποτυχίες αδειοδότησης/καταγράφει αντίγραφα, ενεργοποιεί την αποτυχία, έρχεται σε επαφή με το PSP.
Η μαζική μερική αποζημίωση (εκστρατεία) → αυξήσει το μερικό όριο, θα επιτρέψει τις ομαδικές δραστηριότητες και θα ενισχύσει τις συμφωνίες.
Σφάλμα Webhooks → μετάβαση σε δημοσκοπήσεις, αύξηση της ταυτότητας TTL, αναβολή αυτόματης επαναπλήρωσης.
Εξαίρεση επιστροφής στην πηγή (σπάνια) → κλιμάκωση MLRO, τεκμηριωμένη πληρωμή και «comp _ εγκεκριμένη = αληθής».

15) Περιπτώσεις δοκιμής (UAT/Prod)

1. Πλήρης επιστροφή μετά από δέσμευση → ορθή επαναφορά του υπολοίπου.
2. μερική (3 ×) παρτίδα → άθροισμα ≤ δέσμευσης· στη συνέχεια γεμάτη για το υπόλοιπο.
3. Ταυτότητα - Επαναλάβετε το ίδιο ερώτημα → 1 αποτέλεσμα.
4. Webhook-αναπήδηση: 3 πανομοιότυπες ειδοποιήσεις → μία διαγραφή/πίστωση.
5. Συνδυασμοί: τεχνητή αναντιστοιχία → συναγερμός και αυτόματη διόρθωση.
6. Περιορισμός δικαιωμάτων: ο αντιπρόσωπος δεν μπορεί να υπερβεί το μερικό όριο.
7. Διακοπή: καθυστερημένη προσπάθεια επαναπλήρωσης → διόρθωση αποτυχίας και καταγραφής.

16) Κατάλογος ελέγχου εφαρμογής

• πολιτικές πλήρους/μερικής + επιστροφής στην πηγή ανά δικαιοδοσία/μέθοδο.
• Ευεξία, υποχώρηση, webhooks και δημοσκοπήσεις, DLQ.
• Υπόδειγμα δεδομένων με υπολειπόμενη απόδοση και reason_code.
• Λογιστική και καθημερινές αυτόματες συμφωνίες.
• KPI/ταμπλό: Ποσοστό επιστροφής, TtR, Σφάλμα, Διπλή επιστροφή = 0.
• Δικαιώματα και πίνακας εφαρμογής, υποδείγματα υποστήριξης.
• Περιπτώσεις δοκιμών UAT και προειδοποιήσεις σε επίπεδο παραγωγής.

Περίληψη

Η εκ νέου διαχείριση αποτελεί αυστηρή πειθαρχία των διαδικασιών: επιστροφή χρημάτων στην πηγή, ιδεατότητα, διαφανές μοντέλο δεδομένων, αυτόματη συμφωνία και κατανοητές επιμέρους/πλήρεις πολιτικές. Με τέτοια βασικά μεγέθη, κρατάτε TtR χαμηλά, λάθη κοντά στο μηδέν, διπλασιάζει αδύνατο, και συμμόρφωση και χρηματοδότηση συγχρονίζονται με επιχειρηματικούς στόχους.