Payments
Met Heartwork Payments kunt u betalingen aanmaken voor uw webshop, e-facturatieplatform of andere applicatie waarvoor u betalingen nodig heeft.
Hoe werkt de Payments API?
- Een klant op een website besluit af te rekenen.
- De website creëert een betaling op het platform door de Heartwork Payments API aan te roepen met het bedrag, een betalingsbeschrijving, een webhook-URL en een URL waarnaar de klant moet worden doorverwijzen nadat de betaling is uitgevoerd.
- De klant bereikt de kassa, kiest een betaalmethode en voert de betaling uit.
- Wanneer de betaling is voltooid, activeert Heartwork uw webhook om uw website te informeren over de statuswijziging van de betaling
- Bij het verwerken van de webhook-aanvraag haalt de website de betalingsstatus op met behulp van de Payments API. Deze opgehaalde status dient om de betaling te markeren en eventueel een e-mailbevestiging naar de klant te sturen.
- Op dit punt stuurt Heartwork de bezoeker terug naar de website met behulp van de redirectUrl die is opgegeven toen de betaling werd aangemaakt. De website weet al dat de betaling is gelukt en bedankt de klant.
Metadata gebruiken
We gaan ervan uit dat de website het id wat uniek is voor de betaling opslaat in een besteltabel. Op deze manier kan een website de bestelling voor deze betaling opzoeken wanneer de webhook wordt geactiveerd door Heartwork. De website houdt de betaling bij en brengt effectief de verbinding tussen bestelling en betaling tot stand.
Als alternatief kan Heartwork de unieke identificatiecode van uw bestelling “onthouden” door de Heartwork API opdracht te geven deze op te slaan in de metadata van de betaling.
