addUser

📘

Timeouts

The postback will time out if your platform does not respond within 30 seconds. If this occurs, our platform will automatically retry the request.


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>