transaction

The transaction postback gets posted when a transaction (payment, refund etc.) has been successfully processed.
It contains all the details related to the payment.

🚧

Important

It's recommended that you save the Vendo Transaction ID and the Vendo Subscription ID for future reference and processes like One-clicks, Instant Upgrades, Cancellations, Refunds and so on.

Request parameters

Parameter

Data type

Description

callback

string

Specifies the action for this request, which in this case is "transaction".

username

string

End user's username.
Example: bob

password

string

End user's password.
Example: abc123

email

string

End user's email.
Example: [email protected]

subscription_id

numeric

Vendo's subscription identifier.
Example: 123456789

site_id

numeric

Vendo's site identifier.
Example: 123456789

merchant_id

numeric

Vendo merchant identifier.
Example: 3625

customer_id

numeric

Vendo's customer identifier.
Example: 123456789

firstname

string

End user's first name.
Example: Robert

lastname

string

End user's last name.
Example: Johnson

street

string

End user's street address.
Example: Sant Pere Mes Alt 20, 1

zip

string

End user's zip code.
Example: 90350

city

string

End user's city.
Example: Barcelona

country

string

End user's billing/invoice country. 2-letter ISO 3166-1 alpha-2 format.
Example: US

language

string

End user's language. 2-letter ISO 639-1 format.
Example: en

ip

string

End user's IP.
May be IPv4 or IPv6 formatted.
Example: 8.8.8.8

subscription_status

numeric

Indicates the subscription’s status related to the transaction. The values are:
0 = expired
1 = active
2 = cancelled/expiring

offer_id

numeric

Vendo internal offer id.
Example: 12345

price_point_type_id

numeric

Type of price point - see price point types

offer_identifier

string

Your offer identifier for the related offer on the transaction.
Example: 3dtrial

merchant_transaction_id

string

Your content provider specific transaction id, normally passed on OneTimeShot transactions.

transaction_id

numeric

Vendo internal transaction ID.
Example: 123456

transaction_type

numeric

Type of transaction - see transaction types

price_point_amount

numeric

Base point amount configured for the content provider in the Back Office.
Example: 39,95

price_point_currency

string

Currency of the price point amount. 3-letter ISO 4217 format.

displayed_amount

numeric

End user's displayed amount.

displayed_currency

string

End user's displayed currency.

invoice_amount

numeric

Invoice amount for the transaction.

invoice_currency

string

Currency for the invoice amount.

reporting_amount

numeric

Invoice amount converted to a reporting currency (USD).

reporting_amount_gross

numeric

Gross invoice amount converted to a reporting currency (USD).

reporting_currency

string

Reporting currency. It will always be USD.

recurring_amount

numeric

Next charge transaction invoice amount.

recurring_currency

string

Next charge transaction invoice currency.

displayed_recurring_amount

numeric

End user's displayed amount of next charge transaction.

displayed_recurring_currency

string

End user's displayed currency of next charge transaction.

payment_method_id

numeric

Identifier for the payment method used.

original_transaction_id

numeric

Contains the original Vendo transaction ID if is a chargeback, refund or cross sale post.
Example: 1133893540

transaction_datetime

numeric

Unix timestamp (Epoch) of the transaction date in seconds since Jan 01 1970 (UTC).
Example: 1597150076

transaction_status

numeric

Indicates the transaction status. The values are:
1 = successful
9 = chargeback

seller_affiliate_code

string

Unique seller affiliate code, used for cross-sales.

offer_is_cdo

boolean

Whether or not a Cancel Discount Offer was applied.

offer_is_mdo

boolean

Whether or not a Merchant Discount Offer was applied.

offer_is_bdo

boolean

Whether or not a Back Discount Offer was applied.

offer_is_rdo

boolean

Whether or not a Retention Discount Offer was applied.

offer_is_edo

boolean

Whether or not an Expiry Discount Offer was applied.

is_xsale

boolean

Whether or not the transaction was a cross sale.

merchant_reference

string

Your custom passed reference in the join link via the ref parameter.
Example: 123

reason_message

string

Optional message explaining the reason for f.ex. a refund.

transaction_subtype

numeric

Specifies Vendo's internal transaction type id. Potential values are listed in the transaction types page.

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>  
 <transaction>       
  <code>1</code> 
 </transaction>
</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> 
 <transaction>  
  <code>2</code>  
  <errorMessage>Custom error message</errorMessage> 
 </transaction>
</postbackResponse>

Did this page help you?