01 / Proces
Behoud de zakelijke referentie bij elk event
De integratie is het eenvoudigst te beheren wanneer betaal-, speler- of bestel- en afwikkelingsrecords vanaf het begin dezelfde referenties delen.
- 01
De sessie aanmaken
Verstuur het vereiste bedrag, de valuta, zakelijke referentie en retourcontext in de actueel gedocumenteerde verzoekstructuur.
- 02
De betaalervaring tonen
Leid de klant naar de geconfigureerde checkout of betaalroute die voor die sessie wordt teruggestuurd.
- 03
Gedocumenteerde events verwerken
Valideer en verwerk de eventtypen en velden die in de actuele API-documentatie zijn beschreven.
- 04
Crediteren en reconciliëren
Gebruik de betaalreferentie om het event, de bedoelde speler of bestelling, het gecrediteerde bedrag en afwikkelingsrecord te koppelen.
02 / Operaties
Integratiekeuzes die de operatie beïnvloeden
Een bruikbare integratie opent niet alleen de checkout. Ze bewaart de referenties, statussen en foutpaden die de operator na livegang nodig heeft.
Referentieontwerp
Kies vaste speler-, bestel- of factuurreferenties die zowel in het operatorsysteem als in het Payfux-record vindbaar zijn.
Eventverwerking
Verwerk alleen gedocumenteerde eventvelden en statussen en bewaar de ontvangen referentie voor audit en reconciliatie.
Retourgedrag
Behandel de terugkeer van de klant als interfacenavigatie en niet als definitief bewijs dat een betaling of afwikkeling is voltooid.
Reconciliatiepad
Koppel betaal- en afwikkelingsrecords in de eigen systemen van de operator, zodat verschillen op referentie kunnen worden onderzocht.
03 / Vereisten
De actuele documentatie is bepalend
Marketingvoorbeelden beschrijven de integratiereeks, maar definiëren geen productie-endpoints, payloads, signatures, retry's, statuswaarden of serviceniveaus.
- Gebruik alleen de authenticatie en verzoekvelden uit de actuele API-documentatie die voor de klantomgeving is verstrekt.
- Behandel de terugkeer in de browser niet als doorslaggevend betaalbewijs; gebruik het gedocumenteerde server-side status- en eventmodel.
- Test de verwerking van fouten, duplicaten, vertragingen en gewijzigde statussen tegen het voor de integratie gedocumenteerde gedrag.
04 / Vragen
Vragen van aanbieders
Waar staan de actuele Payfux-API-schema's?
De actuele schema's, authenticatievereisten en verzoekvelden staan in de Payfux-API-documentatie. Codevoorbeelden op productpagina's zijn verklarend en vervangen deze documentatie niet.
Moet de browserretour een betaling als voltooid markeren?
Nee. De terugkeer van de klant is alleen navigatie. De operator moet voor creditering en reconciliatie de gedocumenteerde server-side betaalstatus en eventbewijzen gebruiken.
Belooft Payfux een bepaald retryschema voor events?
Op deze pagina wordt geen retryschema geclaimd. Implementeer het event- en herstelgedrag uit de actuele klantdocumentatie.
Welke zakelijke referentie moet een operator meesturen?
Gebruik de vaste speler-, klant-, factuur- of bestelreferentie die de gedocumenteerde integratie vereist en bewaar deze in het operatorsysteem.
Zijn test- en liverecords uitwisselbaar?
Nee. Houd inloggegevens, endpoints, records en reconciliatie van omgevingen gescheiden en volg de omgevingscontroles uit de documentatie.
Documentatie voor ontwikkelaars
Begin bij de actuele verzoek- en eventschema's
Gebruik de Payfux-documentatie voor exact integratiegedrag en stem daarna de betaalreferenties af op uw operatorsystemen.
Lees de documentatie