addUser

Vendo triggers the addUser postback when an end user has successfully completed a signup transaction. It is sent so that your system knows the user should be granted access to your site.

📘

Timeouts

If your platform does not respond within 30 seconds, the postback request will time out and our platform will automatically retry it.


Note: By default, postbacks for test transactions are not retried.


Request parameters

ParameterData typeDescription
callbackstringSpecifies the action for this request, which in this case is "addUser".
usernamestringEnd user's username.
Example: bob
passwordstringEnd user's password.
Example: abc123
subscription_idnumericVendo's subscription identifier.
Example: 123456789
customer_idnumericVendo's customer identifier.
Example: 123456789
firstnamestringEnd user's first name.
Example: Robert
lastnamestringEnd user's last name.
Example: Johnson
streetstringEnd user's street address.
Example: Sant Pere Mes Alt 20, 1
zipstringEnd user's zip code.
Example: 90350
citystringEnd user's city.
Example: Barcelona
countrystringEnd user's country. 2-letter ISO 3166-1 alpha-2 format.
Example: US
emailstringEnd user's email.
Example: [email protected]
languagestringEnd user's language. 2-letter ISO 639-1 format.
Example: en
ipstringEnd user's IP.
May be IPv4 or IPv6 formatted.
Example: 8.8.8.8
site_idnumericVendo's site identifier.
Example: 123456789
merchant_referencestringThe custom reference that you might have passed in the original request via the ref parameter.
Example: 123
is_testbooleanWhether this request is related to a test transaction or subscription.
0 for no (real transaction)
1 for yes (test transaction)

Your server must reply with one of these response formats:

OK (Response code 1)

Reply with this if the request was successful and the end user was granted access.

Example:

<?xml version="1.0" encoding="UTF-8"?>
<postbackResponse>  
 <addUser>       
  <code>1</code> 
 </addUser>
</postbackResponse>

ERROR (Response code 2)

Reply with this if you encountered an unexpected problem with the request.

Include a custom error message with your message for tracing and debugging. Make sure this error message is meaningful, as it will be stored in a log file for later debugging.

Vendo will attempt a new addUser postback after your error response.

Example:

<?xml version="1.0" encoding="UTF-8"?>
<postbackResponse> 
 <addUser>  
  <code>2</code>  
  <errorMessage>Custom error message</errorMessage> 
 </addUser>
</postbackResponse>

Did this page help you?