This endpoint allows you to process a transaction.

📘

NOTE

Timeout should be set to at least 30 seconds.
It can take up to 30 seconds to process a transaction.

API Response

NameTypeDescription
statusint1 if the transaction was successful.
0 if the transaction failed.
2 if the transaction needs further verification (see Appendix A and the result element)
external_referencesroot elementThis parameter contains the following 4 child elements.
All these values are pass-thru values, meaning that they will be posted back to you exactly as you entered them in the request.
external_references.transaction_referencestring
external_references.program_idstring
external_references.campaign_idstring
external_references.affiliate_idstring
transactionroot elementThis parameter contains the following 4 child elements.
The child elements contain details of the transaction that was processed.
This element will only be present if your request passed all the parameters validation rules.
transaction.idstringVendo's Transaction ID. Save it for your reference.
transaction.amountfloatThe amount of the transaction.
transaction.currencystringThe currency of the transaction.
transaction.datetimestringThe transaction's date time
Formatted using the ISO 8601 with time offset from UTC
card_detailsroot elementThis element will be present if payment_method was card and if the response status is 1
This element contains the following 1 child element.
auth_codestringThe credit/debit card auth code.
sepa_detailsroot elementThis element will be present if payment_method was sepa and if the response status is 1
This element contains the following 2 child elements.
sepa_details.mandate_idstringThe SEPA's Mandate ID
sepa_details.mandate_signed_datestringThe date the Mandate was signed by the user, this is basically, the date time when the user accepted to get charged.
Formatted using the ISO 8601 with time offset from UTC
payment_details_tokenstringTokenized payment details for the current request. Returned only on non-tokenized payments. Save this token and use it for recurring payments without asking the customer to enter their payment details again!
errorroot elementThis element will be present only if the status is 0.
This element contains 3 child elements.
error.codestringVendo's Gateway error code. See full list here.
error.messagestringA brief detail of what went wrong.
error.processor_statusstringThe status code returned by the acquirer or bank. This
resultroot elementThis element will be present if the status is 2, i.e. the transaction was neither accepted nor declined.
This element contains 3 child elements.
result.codestringVendo's Gateway error code. See full list here.
result.messagestringA brief detail of why the transaction was not accepted.
result.verification_urlstringIf this element is provided you must redirect the end user to this URL to complete the verification process (see Appendix A)
request_idstringThis is the request unique identifier that gets created by Vendo's Gateway on each request.
You need to send this value to Vendo's Client Services team when you open a support ticket.

Appendix A

Running test transactions

In order to run test transactions, you must pass the is_test parameter and set it to 1.

Card details for test transactions

  • Credit card number: 4111111111111111
  • Credit card number for 3DS: 4000012892688323
  • Expiration month: Any month. Use a leading zero when needed e.g. 09
  • Expiration year: Any future year. e.g. 2025
  • CVV: 123
  • OTP code for 3DS: 1234
  • EMAIL - IMPORTANT Please always use a fresh, unique email address for every new test! If you have a Gmail account, you can add a plus (+) and a random string before the @ sign. Ex. myemail+123@gmail.com

3D Secure / SCA

The flow of a 3D Secure (or other verification process) is outlined here.

Language