Voor Nederlands scroll naar beneden! 

How to implement postbacks correctly?

When  your application is open to receive postbacks with status information from the Signhost server, it would be wise to validate the origin of every incoming postback. We advice the following implementation of our postbacks:

  1. Validate the Checksum from the postback (see our documentation).
  2. If the checksum proves to be correct:Accept / Save the postback and reply with a 200 OK response.If the checksum proves to be incorrect:Ignore the postback and delete.
  3. After sending the 200 OK response, the contents of the postback could get processed. 

N.B. Mind you to immediately after validating the postback respond with a 200 OK. If neglected, the Signhost server will repeatedly try to send out the same postback and wait for a response, with increasing interval (see 'Figuur 1' above).
When postbacks cannot be delivered, or no 200 OK has been received, all postbacks to this postback URL will queue up, which will cause delays in your system.

Questions?We're ready to help you out via support@signhost.com 

---------------------------------------------------------------------------------------------------------------------------------

Hoe implementeer ik de postbacks op een correcte manier?

Wanneer uw applicatie open staat voor postbacks met statusupdates over transacties is het verstandig om te valideren dat de binnenkomende postbacks van Signhost afkomstig zijn. Hiervoor raden wij de volgende stappen aan:

  1. Valideer de Checksum uit de postback (zie de documentatie)
  2. Bij een valide controle:
    Accepteer de postback / sla deze op, en geef een status 200 terug.
    Bij een invalide controle:
    Negeer deze postback & verwijder deze.
  3. Na het teruggeven van een 200 OK kan de inhoud van de postback worden verwerkt. 

N.B. Let goed op om direct na het valideren van de postback een 200 terug te geven, anders blijft de Signhost server het opnieuw en opnieuw proberen om de postback af te leveren, met oplopend interval (zie figuur 1 hieronder).
Wanneer postbacks niet kunnen worden afgeleverd, of wanneer er geen 200 OK wordt ontvangen, zal er voor deze postback URL een queue ontstaan waardoor andere postbacks moeten wachten, wat tot vertraging in uw applicatie kan leiden.

Figuur 1 - Het interval waarmee postbacks opnieuw worden gestuurd wanneer deze niet met een status 200 OK worden beantwoord. 

Meer vragen?
support@ondertekenen.nl helpt u graag verder!

Did this answer your question?