verification

This postback is intended for Server-to-Server (S2S) API users.
It's used to inform you about the final status of a verification transaction.

This postback will be posted to your Postback URL when verification processes are successful.

If a verification failed then you need to start the payment process again.
If a verification was successfully processed then you need to post the second API call to confirm the transaction that you initiated.

📘

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 "verification"
transaction_idnumericVendo's Transaction ID. This is the value that you received in the API response in the transaction.id field.
merchant_referencestringThis is the valued that you passed in the external_references.transaction_reference field in your first S2S API request.
statusnumericThis parameter tells whether the verification was successful.

1 = Verification was successful
0 = Verification failed
is_testnumericWhether 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>
  <verification>
    <code>1</code>
  </verification>
</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> 
 <verification>  
  <code>2</code>  
  <errorMessage>Explain why you cannot accept our postback</errorMessage> 
 </verification>
</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.