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.


Did this page help you?