Payment

status

int

1 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_references

root element

This 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_reference

string

external_references.program_id

string

external_references.campaign_id

string

external_references.affiliate_id

string

transaction

root element

This 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.id

int

Vendo's Transaction ID. Save it for your reference.

transaction.amount

float

The amount of the transaction.

transaction.currency

string

The currency of the transaction.

transaction.datetime

string

The transaction's date time
Formatted using the ISO 8601 with time offset from UTC

subscription_schedule

root element

This element will be present if subscription_schedule was specified in the API request.

subscription_schedule.subscription_id

int

Vendo's Subscription ID. Save it for your reference.

card_details

root element

This element will be present if paymentmethod was set to_card and if the response status is 1
This element contains the following 1 child element.

auth_code

string

The credit/debit card auth code.

trace_id

string

The trace_id is a unique identifier assigned by the card scheme network (e.g., Visa, MasterCard) to a transaction processed through our payment gateway. This identifier facilitates future referencing of the transaction within the card scheme network.

sepa_details

root element

This 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_id

string

The SEPA's Mandate ID

sepa_details.mandate_signed_date

string

The 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_token

string

Tokenized 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!

error

root element

This element will be present only if the status is 0.
This element contains 3 child elements.

error.code

string

Vendo's Gateway error code. See full list here.

error.message

string

A brief detail of what went wrong.

error.processor_status

string

The status code returned by the acquirer or bank. This

result

root element

This 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.code

string

Vendo's Gateway error code. See full list here.

result.message

string

A brief detail of why the transaction was not accepted.

result.verification_url

string

If this element is provided you must redirect the end user to this URL to complete the verification process (see Appendix A)

request_id

string

This 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.