transaction

🚧
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 Streamate Payment transactions.
transaction_id	numeric	Vendo internal transaction ID. Example: 123456
transaction_type	numeric	Type of transaction - [see transaction types] (doc: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)
payment_token	string	You may use this param to create S2S Payments and S2S Signups If you need this feature please contact Vendo Merchant Support

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>