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.
Timeouts
The transaction postback will time out if your platform doesn't return a response back in 30 seconds.
Our platform will post the transaction postback again.
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 |
| 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 |
| 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>
Updated 4 months ago