De Signhost postback-service is bedoeld om realtime updates te geven van transacties. Graag geen actieve polling met GET-verzoeken doen om up-to-date te blijven. Als de postback-service niet geïmplementeerd kan worden of als hier vragen over zijn, neem dan contact op met support.
De geadviseerde manier om een postback URL te registreren is door deze Postback URL's in het webportaal toe te voegen.
Geadviseerde postback implementatie
Om postback wachtrijen te vermijden adviseren wij het volgende wanneer een postback is gearriveerd.
(Als je dit gebruikt) Check de postback security header
Voer een checksum validatie uit *:
- Valideer dat de body een geldige JSON is, zo niet ga naar stap 2;
- Valideer dat de JSON een checksum eigenschap heeft, zo niet ga naar stap 2;
- Valideer de waarde van de checksum, als er een verkeerde combinatie is ga naar stap 2.Geef altijd een status 2xx-OK terug. Sla de rest van de stappen over als de validatie is mislukt;
Bewaar de geverifieerde postback;
Ga verder met de bedrijfslogica.
* Dit is een veiligheidsmaatregel die voorkomt dat informatie over jullie validatieproces terugkeert naar de - mogelijk kwaadwillende - afzender van de postback. Elke andere reactie dan 2xx OK zal leiden tot de vorming van een postback-wachtrij (zie hieronder).
Wat gebeurt er als de postback-URL niet beschikbaar is of geen verzoeken accepteert?
Als de postback URL geen 2xx HTTP-antwoordcode retourneert, wordt opnieuw geprobeerd de postback af te leveren met een toenemend tijdsinterval. Alle volgende postbacks worden in een postback-wachtrij geplaatst en wachten daar tot de eerste postback in de wachtrij een 2xx HTTP-responscode krijgt.
Als een postback niet succesvol wordt afgeleverd en opnieuw wordt geprobeerd, worden er geen andere postbacks geprobeerd totdat de eerste in de wachtrij slaagt. Zodra de eerste postback-aanvraag is voltooid, worden de uitgestelde verzoeken achtereenvolgend verwerkt. Indien de eerste postback in de wachtrij niet succesvol kan worden afgeleverd wordt de volledige wachtrij na 2 dagen gewist.
Aangezien verzoeken om teruggave uiteindelijk kunnen mislukken, is het beste om gegevens aan jullie kant te accepteren en op te slaan (met een HTTP 2xx-reactie op Signhost) voor latere verwerking om gegevensverlies te voorkomen.
Raadpleeg onze documentatie voor meer informatie over de checksum.
Ons support team helpt je graag verder via de chat of mail naar support@signhost.com