changeOffer

The changeOffer postback is used to inform that a subscription has changed from one offer to another, f.ex. from a monthly to a yearly billing schedule or from a quarterly to a monthly.

Request parameters

ParameterData typeDescription
callbackstringSpecifies the action for this request, which in this case is "changeOffer".
subscription_idnumericVendo's subscription identifier.
Example: 123456789
offer_idnumericVendo internal offer id for the new offer.
Example: 12345
offer_identifierstringYour offer identifier for the new offer.
Example: yearly99
change_typestringSpecifies the change type: upgrade or downgrade
is_testbooleanWhether 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 reply with one of these response formats:

OK (Response code 1)

Reply with this if the request was received successfully.

Example:

<?xml version="1.0" encoding="UTF-8"?>
<postbackResponse>  
 <changeOffer>       
  <code>1</code> 
 </changeOffer>
</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/debugging. Make sure this error message is meaningful because it is stored to a logfile for later debugging.

Example:

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

🚧

Note for NATS users

NATS v3 doesn't support this postback. If you run NATS v3, you have to create a script to handle it. Contact Vendo support for more information.