Koppel de betaling aan de juiste zakelijke gebeurtenis.
Begin met het moment waarop je geld wilt innen. Vooruitbetaling bij een order vraagt een andere werking dan een aanbetaling, betaling na controle of betalen aan de deur. Leg vast welk bedrag bij welke opdracht hoort en wanneer betaling een volgende stap mag vrijgeven.
Een order kan meerdere betaalpogingen en betalingen hebben. Een mislukte poging betekent niet dat de order is geannuleerd; een gedeeltelijke betaling betekent niet dat het hele bedrag is voldaan. Geef de opdracht, het te innen bedrag en de afzonderlijke transacties een eigen identiteit. Zo kun je herhalen, bijbetalen en terugbetalen zonder de samenhang kwijt te raken.
Maak ook de toestand tussen starten en afronden zichtbaar. Een klant die terugkeert op een bedankpagina heeft daarmee nog geen gecontroleerde betaalstatus aangeleverd. De achterliggende toepassing bepaalt op basis van geverifieerde providerinformatie of de afgesproken betaalvoorwaarde is vervuld.
Kies de aansluiting op de benodigde betaalstroom.
Mollie, Adyen en Stripe bieden verschillende producten en interfaces voor betalingen. Vergelijk de gewenste betaalmethoden, landen, valuta, terugbetalingen, rapportage en de aansluiting op je bestaande software. Online betalen, een betaalverzoek en contactloos betalen op een apparaat zijn verschillende integratieroutes. Een online aansluiting maakt een app niet automatisch geschikt als betaalterminal.
Bij onboarding horen accountinrichting, verificatie door de provider, toegangsrechten, test- en productieomgevingen en afspraken over ontvangst van betalingen. Blade kan de technische inrichting en ingebruikname begeleiden. De provider bepaalt of het account en de gekozen diensten worden geactiveerd; dat volgt niet uit een geslaagde testtransactie.
We ontwerpen waar gegevens worden verzameld en welke informatie je eigen systeem nodig heeft. Gebruik geschikte betaalcomponenten of SDK’s van de provider voor de betaalinteractie. De operationele toepassing werkt met transactie-identiteiten en statussen; kaartgegevens en toegangssleutels horen niet in eigen ordernotities of algemene logs.
Bewaar de betekenis van iedere betaalstatus.
Providers en betaalproducten kennen verschillende statussen. Een reservering of autorisatie kan nog een afzonderlijke incasso of capture vragen. “In behandeling” is geen definitieve afronding. Maak een expliciete vertaling naar de bedrijfsregel: mag de order verder, moet iemand wachten of is beoordeling nodig?
| Moment | Wat je eigen software moet weten |
|---|---|
| Betaalpoging gestart | Bij welke opdracht, bedrag en valuta hoort deze poging? |
| Uitkomst bevestigd | Welke providerstatus is gecontroleerd en welke vervolgstap staat die toe? |
| Terugbetaling of betwisting | Welk deel verandert en wie beoordeelt de gevolgen voor de order? |
| Uitbetaling | Welke transacties, kosten en correcties verklaren het ontvangen totaal? |
Verwerk webhooks volgens het gekozen providerprotocol: controleer de herkomst waar het protocol dat ondersteunt en haal waar nodig de actuele status via een geauthenticeerde verbinding op. Controleer ook de relatie met jouw account, opdracht, bedrag en valuta. De melding alleen mag geen willekeurige order vrijgeven.
Herhaalde of vertraagde meldingen moeten hetzelfde zakelijke resultaat behouden. Bij een verloren antwoord controleer je de bestaande poging voordat een nieuwe betaling wordt gestart. Een tweede klik mag niet ongemerkt een tweede inning worden. Bepaal welke idempotentie- en statuscontrole de concrete interface biedt.
Een uitbetaling is een optelsom, geen losse klantbetaling.
Een uitbetaling op de bank kan meerdere transacties, kosten, terugbetalingen en correcties omvatten. Het ontvangen bedrag is daarom niet vanzelf gelijk aan één factuurbedrag. Bewaar de referenties waarmee kantoor de aansluiting kan controleren en laat verschillen herkenbaar openstaan.
Stem met de administratie af waar facturen, betaalregistraties en correcties worden gemaakt. Verbind die aan Exact, AFAS of een ander administratief systeem zonder dezelfde gebeurtenis dubbel te verwerken. Een operationele status “geleverd” en een betaalstatus “voldaan” blijven afzonderlijke gegevens.
Een fictief voorbeeld: een klant betaalt een aanbetaling en voldoet het restant bij bezorging. De software koppelt beide betalingen aan dezelfde opdracht en bewaakt het nog openstaande bedrag. Bij een deellevering moet vooraf duidelijk zijn of dat bedrag verandert en wie die wijziging mag goedkeuren.
Test ook de onzekere uitkomst.
Test een geslaagde betaling, afwijzing, verlopen poging, dubbele webhook en een verbroken verbinding na betalen. Neem een gedeeltelijke terugbetaling en een administratief verschil mee. Kijk steeds naar de uitkomst in alle betrokken systemen en naar wat de medewerker kan doen om verder te komen.
Blade bouwt de betaalintegratie als onderdeel van een eigen orderproces, app of compleet maatwerksysteem. We kunnen ook een bestaande koppeling verbeteren en je huidige provider anders inzetten. De kosten hangen af van de betaalstromen, gebruikers, interfaces en herstelroutes; provider- en transactiekosten tellen mee in de vergelijking.
Bespreek je betaalproces met onze makers. Neem een opdracht mee vanaf betaalverzoek tot afhandeling. We bepalen samen waar inrichting voldoende is, welke software nodig is en hoe betaling, levering en administratie op elkaar aansluiten.