Uniek bewerkingsnummer
Het koppelt speler, bedrag, valuta, betaalmethode, betaalprovider en de volledige verwerkingsgeschiedenis.
Documentatie / Payment Flow
Hoe de payment-API werkt
Bekijk het volledige betalingstraject: van het aanmaken van een storting en bevestigen van betaling tot het bijschrijven van middelen, opnames, terugbetalingen en financiële reconciliatie.
Storting
aanmaken en bijschrijven
Uitbetaling
controle en verzending
Statussen
bevestiging van bewerking
Reconciliatie
financiële controle
Payment flow
Van verzoek tot definitief resultaat
01
Bewerking aanmaken
Leg speler, bedrag, valuta, betaalmethode en uniek bewerkingsnummer vast.
02
Betaling bevestigen
Stuur de speler door naar de betaalpagina, vraag bankbevestiging op of verwerk de betaling rechtstreeks.
03
Definitieve status ontvangen
Controleer de response van de betaalprovider en bevestig het definitieve resultaat van de bewerking.
04
Saldo en boekhouding bijwerken
Schrijf middelen één keer bij of af, verwerk de kosten en leg de bewerking vast voor reconciliatie.
Overzicht
Elke betaling doorloopt gecontroleerde fasen
Het platform kent een eigen bewerkingsnummer toe, koppelt dit aan de response van de betaalprovider en wijzigt de financiële status pas na een bevestigd resultaat. Een herhaald verzoek mag geen tweede afschrijving of bijschrijving veroorzaken.
Duidelijke statussen
De bewerking doorloopt alleen toegestane fasen en wijzigt een afgerond resultaat niet zonder een afzonderlijke correctie.
Afzonderlijke financiële boekhouding
Betalingsstatus, saldowijziging, kosten en boekhoudkundige registratie zijn gekoppeld maar worden afzonderlijk gecontroleerd.
Stortingsflow
Typische stortingsflow
Een storting begint met een interne bewerking en eindigt met een eenmalige bijschrijving na bevestiging door de betaalprovider.
01
Verzoek valideren en bewerking aanmaken
Het platform controleert speler, KYC, limieten, valuta, bedrag en betaalmethode en kent vervolgens een intern bewerkingsnummer toe.
02
Betaling naar provider sturen
De provider ontvangt bedrag, valuta, spelerdata, return-URL, notification-URL en vereiste betaalgegevens.
03
Betaling bevestigen
De speler bevestigt de betaling op een externe pagina, via 3-D Secure of in een bankapp.
04
Bevestiging ontvangen en middelen bijschrijven
Na validatie van de signature en eindstatus verhoogt het platform het saldo van de speler één keer en voltooit het de bewerking.
Opname en terugbetaling
Opnames, annulering en terugbetalingen
Uitgaande bewerkingen vereisen controle van speler, beschikbaar saldo, risico, betaalgegevens en de definitieve response van de betaalprovider.
Spelerverificatie
KYC, leeftijd, accountstatus, limieten, zelfuitsluiting en toegestane opnamemethoden.
Risicocontroles
AML, fraudesignalen, wageringvoorwaarden, bron van middelen en goedkeuring door de operator.
Bedrag reserveren
Het bedrag wordt op het saldo gereserveerd totdat het definitieve uitbetalingsresultaat is ontvangen.
Naar de betaalprovider sturen
Er wordt een afzonderlijk uitbetalingsverzoek aangemaakt met een uniek nummer en geverifieerde gegevens van de ontvanger.
Wachten op het resultaat
Het platform accepteert tussenstatussen en schrijft het bedrag niet opnieuw af.
Terugbetaling
Een terugbetaling wordt aangemaakt als afzonderlijke bewerking die is gekoppeld aan de oorspronkelijke betaling en een eigen bedrag heeft.
Annulering
Annulering is alleen mogelijk vóór de onomkeerbare fase en vervangt geen terugbetaling voor een reeds voltooide bewerking.
Definitieve reconciliatie
Het providerrapport, uitbetalingsgegevens, kosten en saldowijzigingen moeten hetzelfde resultaat tonen.
Bewerkingsstatussen
Aanbevolen statusmodel
Interne statussen normaliseren verschillende responses van betaalproviders naar één duidelijk model voor het platform.
Aangemaakt
De bewerking is binnen het platform aangemaakt maar nog niet naar de provider gestuurd of door de provider geaccepteerd.
Actie vereist
De speler moet de betaling bevestigen, gegevens invoeren of een actie bij de bank uitvoeren.
In verwerking
De provider heeft de bewerking geaccepteerd, maar het definitieve resultaat is nog niet bevestigd.
Voltooid
De bewerking is succesvol afgerond, waarna het saldo één keer wordt gewijzigd.
Afgewezen
De bewerking is afgewezen waarbij de reden wordt bewaard en zonder nieuwe afschrijving of bijschrijving.
Onbevestigd
Het resultaat van de bewerking is onbekend door een verbindingsfout, vertraagde response of tegenstrijdige gegevens.
Een onbekend resultaat mag niet als afwijzing worden behandeld
De betaling kan door de provider zijn geaccepteerd, zelfs zonder tijdige response. Vraag eerst de huidige status op of wacht op bevestiging en bepaal pas daarna of een nieuwe bewerking nodig is.
Betrouwbaarheid en reconciliatie
Bescherming tegen duplicaten en financiële reconciliatie
De betrouwbaarheid van de payment-API hangt af van veilige verwerking van herhaalde verzoeken, vertraagde bevestigingen en gedeeltelijke storingen.
Bescherming tegen herhaalde bewerkingen
Elke storting, opname en terugbetaling krijgt een uniek nummer.
Een herhaald verzoek retourneert het bestaande resultaat en maakt geen nieuwe financiële bewerking aan.
Een herhaalde melding wordt gecontroleerd aan de hand van eventnummer en huidige betalingsstatus.
De saldowijziging is gekoppeld aan het betalingsnummer en wordt slechts één keer toegepast.
Financiële boekhouding en reconciliatie
Sla bedrag, kosten, nettobedrag, valuta en providerreferentie afzonderlijk op.
Herschrijf een afgeronde registratie niet achteraf; maak een afzonderlijke correctie aan.
Reconcileer API-bewerkingen, providerrapporten, saldowijzigingen en uitbetalingen.
Leg elke afwijking, oorzaak, verantwoordelijke en het resultaat van de oplossing vast.
Testen
Wat te testen vóór lancering
Test succesvolle betaling, afwijzing, verbindingsverlies, herhaalde bevestiging, onbekend resultaat, terugbetaling en financiële reconciliatie.
Succesvolle storting en opname
Alle tussenstatussen, bevestiging, saldowijziging en eindrapportage.
Afwijzing van bewerking
Onvoldoende middelen, ongeldige gegevens, overschreden limiet, bankafwijzing, risicocontrole en niet-beschikbare betaalmethode.
Verbindingsverlies
De verbinding valt weg nadat het verzoek is verzonden en de bevestiging arriveert later of wordt afzonderlijk opgevraagd.
Herhaalde verzoeken
Dezelfde bewerking of bevestiging komt opnieuw binnen nadat de verwerking is voltooid.
Terugbetaling en annulering
Volledige en gedeeltelijke terugbetaling, annulering vóór verwerking en verbod op annulering van een voltooide bewerking.
Reconciliatie
Bedrag, kosten, eindstatus, saldo en providerrapport komen na alle scenario's overeen.
Checklist vóór lancering
Productiebetalingen worden ingeschakeld nadat statussen, bevestigingen, bescherming tegen duplicaten, saldo's en financiële rapportage zijn gecontroleerd.
Test- en productieomgevingen gebruiken verschillende inloggegevens, notification endpoints en accounts.
De terugkeer van de gebruiker naar de website wordt niet gebruikt als bewijs van een geslaagde betaling.
De signature en event-ID worden gecontroleerd voordat het saldo wordt gewijzigd.
Stortingen, opnames en terugbetalingen zijn beschermd tegen herhaalde uitvoering.
Een onbekende status wordt bij de provider verduidelijkt en tijdens reconciliatie gecontroleerd.
Foutwaarschuwingen, PSP-rapporten en een proces voor onderzoek van afwijkingen zijn geconfigureerd.
Payment flow ontwerpen?
Stuur ons de lijst met PSP's, betaalmethoden, valuta's, markten, saldoregels en statussen. APIACE helpt stortingen, opnames, terugbetalingen, bevestiging en financiële reconciliatie te structureren.