Un singur număr al operațiunii
Acesta leagă jucătorul, suma, valuta, metoda de plată, furnizorul de plăți și întregul istoric al procesării.
Documentație / Scenariu de plată
Cum funcționează API-ul de plăți
Consultați traseul complet al plății: de la crearea depozitului și confirmarea plății până la creditarea fondurilor, retrageri, rambursări și reconciliere financiară.
Depozit
creare și creditare
Plată
verificare și trimitere
Stări
confirmarea operațiunilor
Reconciliere
control financiar
Traseul plății
De la solicitare la rezultatul final
01
Creați operațiunea
Înregistrați jucătorul, suma, valuta, metoda de plată și numărul unic al operațiunii.
02
Confirmați plata
Redirecționați jucătorul către pagina de plată, solicitați confirmarea băncii sau procesați plata direct.
03
Primiți starea finală
Verificați răspunsul furnizorului de plăți și confirmați rezultatul final al operațiunii.
04
Actualizați soldul și evidența contabilă
Creditați sau debitați fondurile o singură dată, luați în calcul comisionul și înregistrați operațiunea pentru reconciliere.
Prezentare generală
Fiecare plată trece prin etape controlate
Platforma atribuie operațiunii propriul număr, îl leagă de răspunsul furnizorului de plăți și modifică starea financiară numai după un rezultat confirmat. O solicitare repetată nu trebuie să creeze o a doua debitare sau creditare.
Stări clare
Operațiunea trece numai prin etapele permise și nu modifică un rezultat finalizat fără o ajustare separată.
Evidență financiară separată
Starea plății, modificarea soldului, comisionul și înregistrarea contabilă sunt legate între ele, dar sunt verificate separat.
Scenariul depozitului
Scenariu tipic de depozit
Un depozit începe cu crearea unei operațiuni interne și se încheie cu o singură creditare după confirmarea furnizorului de plăți.
01
Verificați solicitarea și creați operațiunea
Platforma verifică jucătorul, KYC, limitele, valuta, suma și metoda de plată, apoi atribuie operațiunii un număr intern.
02
Trimiteți plata furnizorului
Furnizorul primește suma, valuta, datele jucătorului, URL-ul de returnare, URL-ul de notificare și datele de plată necesare.
03
Confirmați plata
Jucătorul confirmă plata pe o pagină externă, prin 3-D Secure sau într-o aplicație bancară.
04
Primiți confirmarea și creditați fondurile
După verificarea semnăturii și a stării finale, platforma majorează o singură dată soldul jucătorului și finalizează operațiunea.
Retragere și rambursare
Retrageri, anulare și rambursări
Operațiunile de ieșire necesită verificarea jucătorului, soldului disponibil, riscurilor, datelor de plată și răspunsului final al furnizorului de plăți.
Verificarea jucătorului
KYC, vârstă, starea contului, limite, autoexcludere și metode permise de retragere.
Verificarea riscurilor
AML, indicatori de fraudă, condiții de rulaj, sursa fondurilor și aprobarea operatorului.
Rezervarea sumei
Suma este blocată în sold până la primirea rezultatului final al plății.
Trimiterea către furnizorul de plăți
Se creează o solicitare separată de plată, cu un număr unic și date verificate ale beneficiarului.
Așteptarea rezultatului
Platforma acceptă stări intermediare și nu debitează din nou suma.
Rambursare
Rambursarea este creată ca operațiune separată, legată de plata inițială și având propria sumă.
Anulare
Anularea este posibilă numai înainte de etapa ireversibilă și nu înlocuiește rambursarea unei operațiuni deja finalizate.
Reconciliere finală
Raportul furnizorului, datele plății, comisioanele și modificările soldului trebuie să indice același rezultat.
Stările operațiunii
Model recomandat de stări
Stările interne normalizează răspunsurile diferiților furnizori de plăți într-un model unic și clar pentru platformă.
Creată
Operațiunea a fost creată în platformă, dar nu a fost încă trimisă sau acceptată de furnizor.
Este necesară o acțiune
Jucătorul trebuie să confirme plata, să introducă datele sau să efectueze o acțiune la bancă.
În procesare
Furnizorul a acceptat operațiunea, dar rezultatul final nu a fost încă confirmat.
Finalizată
Operațiunea s-a finalizat cu succes, după care soldul este modificat o singură dată.
Respinsă
Operațiunea s-a încheiat cu refuz, motivul fiind păstrat, fără o nouă debitare sau creditare.
Neconfirmată
Rezultatul operațiunii este necunoscut din cauza întreruperii conexiunii, întârzierii răspunsului sau datelor contradictorii.
Un rezultat necunoscut nu poate fi considerat refuz
Plata poate fi acceptată de furnizor chiar și fără un răspuns la timp. Solicitați mai întâi starea actuală sau așteptați confirmarea și abia apoi decideți dacă este necesară o nouă operațiune.
Fiabilitate și reconciliere
Protecție împotriva repetărilor și reconciliere financiară
Fiabilitatea API-ului de plăți este determinată de comportamentul sigur în cazul solicitărilor repetate, confirmărilor întârziate și defecțiunilor parțiale.
Protecție împotriva operațiunilor repetate
Fiecare depozit, retragere și rambursare primește un număr unic.
O solicitare repetată returnează rezultatul existent și nu creează o nouă operațiune financiară.
O notificare repetată este verificată după numărul evenimentului și starea curentă a plății.
Modificarea soldului este legată de numărul plății și este aplicată o singură dată.
Evidență financiară și reconciliere
Păstrați separat suma, comisionul, suma netă de creditat, valuta și referința furnizorului.
Nu rescrieți retroactiv o înregistrare finalizată; creați o ajustare separată.
Reconciliați operațiunile API, rapoartele furnizorului, modificările soldului și plățile.
Înregistrați fiecare diferență, cauza ei, responsabilul și rezultatul remedierii.
Testare
Ce trebuie verificat înainte de lansare
Verificați plata reușită, refuzul, pierderea conexiunii, confirmarea repetată, rezultatul necunoscut, rambursarea și reconcilierea financiară.
Depozit și retragere reușite
Toate stările intermediare, confirmarea, modificarea soldului și raportarea finală.
Refuzul operațiunii
Fonduri insuficiente, date invalide, limită depășită, refuz bancar, verificare de risc și metodă de plată indisponibilă.
Pierderea conexiunii
Conexiunea se întrerupe după trimiterea solicitării, iar confirmarea sosește ulterior sau este solicitată separat.
Solicitări repetate
Aceeași operațiune sau confirmare sosește din nou după finalizarea procesării.
Rambursare și anulare
Rambursare integrală și parțială, anulare înainte de procesare și interdicția anulării unei operațiuni finalizate.
Reconciliere
Suma, comisionul, starea finală, soldul și raportul furnizorului corespund după toate scenariile.
Listă de verificare înainte de lansare
Plățile de producție sunt activate după verificarea stărilor, confirmărilor, protecției împotriva repetărilor, soldului și raportării financiare.
Mediile de testare și producție utilizează accesuri, endpoint-uri de notificare și conturi diferite.
Revenirea utilizatorului pe site nu este utilizată ca dovadă a unei plăți reușite.
Semnătura și numărul evenimentului sunt verificate înainte de modificarea soldului.
Depozitul, retragerea și rambursarea sunt protejate împotriva executării repetate.
O stare necunoscută este clarificată cu furnizorul și verificată în timpul reconcilierii.
Sunt configurate notificările de eroare, rapoartele PSP și procedura de investigare a diferențelor.
Trebuie proiectat un scenariu de plată?
Trimiteți lista PSP, metodele de plată, valutele, piețele, regulile de lucru cu soldul și stările. APIACE vă va ajuta să structurați depozitele, retragerile, rambursările, confirmarea și reconcilierea financiară.