failedRebill

The failedRebill postback is used to inform you that a scheduled rebill transaction was attempted and failed. Though the rebill transaction will automatically be retried several times, this postback allows you to take immediate action in the interim.

πŸ“˜

INFORMATION

This postback is disabled by default since subscribing to it is optional.
Please contact Vendo Support to request activation of this postback if you wish to subscribe to it.

Request parameters

ParameterData typeDescription
callbackstringSpecifies the action for this request, which in this case is "failedRebill".
subscription_idnumericVendo's subscription identifier.
Example: 123456789
transaction_idnumericVendo internal transaction ID.
Example: 123456
merchant_referencestringYour custom passed reference in the join link.
Example: 123
error_codenumericVendo error code representing the type of error. They are the same error codes that you will see in our Backoffice.
error_messagestringA message describing the error.
transaction_datetimenumericUnix timestamp (Epoch) of the transaction date in seconds since Jan 01 1970 (UTC).
Example: 1597150076
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>
  <failedRebill>
    <code>1</code>
  </failedRebill>
</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> 
 <failedRebill>  
  <code>2</code>  
  <errorMessage>Explain why you cannot accept our postback</errorMessage> 
 </failedRebill>
</postbackResponse>

🚧

Note for NATS users

NATS doesn't support this postback. If you want to receive this postback you have to create your own script to handle it. Contact Vendo support for more information.