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
| Parameter | Data type | Description |
|---|---|---|
| callback | string | Specifies the action for this request, which in this case is "failedRebill". |
| subscription_id | numeric | Vendo's subscription identifier. Example: 123456789 |
| transaction_id | numeric | Vendo internal transaction ID. Example: 123456 |
| merchant_reference | string | Your custom passed reference in the join link. Example: 123 |
| error_code | numeric | Vendo error code representing the type of error. They are the same error codes that you will see in our Backoffice. |
| error_message | string | A message describing the error. |
| transaction_datetime | numeric | Unix timestamp (Epoch) of the transaction date in seconds since Jan 01 1970 (UTC). Example: 1597150076 |
| 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 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.
Updated about 3 years ago