It's essential that your postback endpoint script is continuously available and handling exceptions properly as it is the way your system is kept up-to-date with user, subscription and payment transactions details.
Important note for Vendo Payment Gateway API users.
If you are using Vendo's Payment Gateway API then you do not need to process postbacks. Do not configure any postback URL.
Your Vendo Client Services representative can assist you with preparing and testing your postback endpoint.
NATS v4 and NATS v5
You must use the VSERVICES biller with NATS. It implements all available Vendo postbacks.
- Postbacks are HTTP POST requests to your postback endpoint.
- The request parameters are sent as
application/x-www-form-urlencodedkey-value pairs in the body of the request.
- Responses must be sent back in XML format.
The following parameters are common for all postback types:
|callback||string||The name of the postback type, f.ex. "checkUser" or "transaction"|
|is_test||boolean||Whether or not this request is related to a test transaction or subscription.|
0 for no (real transaction)
1 for yes (test transaction)
Your server must respond to the postback request with an HTTP/1.1 compliant response with the status 200 OK.
The body of the response must be valid UTF-8 encoded XML with a root element and a child element inside, named after the type of the postback, f.ex.:
<?xml version="1.0" encoding="UTF-8"?> <postbackResponse> <checkUser> <code>1</code> </checkUser> </postbackResponse>
<?xml version="1.0" encoding="UTF-8"?> <postbackResponse> <checkUser> <code>2</code> <errorMessage>Custom error message</errorMessage> </checkUser> </postbackResponse>
The response codes have the following general meaning:
|1||OK||The postback was correctly received and processed.|
|2||ERROR||An error occurred while trying to receive and process the postback request.|
Please provide a meaningful error message in the element
|Others||?||Depends on the postback type, see corresponding documentation.|
Updated almost 2 years ago
Continue here to see how to implement your first postback processor: