If you are integrated with our APIs, you can opt to sign up for our authentication postback service. This will ensure you get authentication results sent to you the moment we process them. In web development, a postback is an HTTP
POST from a client to a server in response to an original server message to the client. In this case, we play the role of client sending your server results as they become available.
In order to consume this service, you will need to host an endpoint that supports JSON and expects the payload that we will deliver. We can support various authentication approaches, but please do let us know about your endpoint well in advance through an encrypted email so we will know what that approach is and what our credentials are for Sandbox and Production environments.
We will also provide you with the IP addresses you may need to whitelist to receive our communications. As part of setting us this service, you should also schedule an SIT slot with us to confirm the proper functioning of the service in Sandbox and Production environments. Customisation of the authentication postback service is charged separately.
In order to use this service your end point must:
be reachable at port 443 (HTTPS)
respond within 5 seconds
respond with a 2XX status code
handle for duplicate post backs for the same event
A sample of our postback payload is presented below: