Objects Transaction
STRUCTURE
{danger.fa-exclamation} IMPORTANT 1:
Transaction and session amounts may change during processing. More information can be found here: Understanding Amounts
{danger.fa-exclamation} IMPORTANT 2:
To receive theredirect_urlproperty within the transaction object, please contact our support team and request to enable the “Notifications for delayed processing via Direct API” setting.
{danger.fa-exclamation} IMPORTANT 3:
Theredirect_urlwill be included when 3D Secure is required and the transaction is in the initialized state.
✓ - required value
? - optional, value or null
✕ - always appears as null
| Variable | Type | auth (card) | sale (card) | payout (card) | refund (card) | auth (ew) | sale (ew) | payout (ew) | refund (ew) | Description |
|---|---|---|---|---|---|---|---|---|---|---|
| transaction_type | varchar(16) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Transaction type. Allowed values are: authorization (authorization and capture) sale (deposit) payout (withdrawal) refund (return deposit funds) |
| transaction_status | varchar(16) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Transaction status will change along with processing. Details can be found at transaction flow |
| tid | int(11) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | transaction identifier |
| transaction_id | varchar(50) | ✓ | ✓ | ? | ✓ | ✓ | ✓ | ? | ✓ | PSP transaction identifier |
| currency | varchar(3) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Transaction currency |
| amount | int(20) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Transaction amount in cents. Note: For certain currencies (see full list here) there is a fraction other than 100 cents per unit, this is important if you multiply by 100 to send the amount in cents. |
| conversion_rate | varchar(30) | ? | ? | ? | ? | ? | ? | ? | ? | Conversion rate between currency and processed_currency applied during conversion from amont to processed_amount. Applies to successful transactions. The value is calculated as 1 processed_currency / 1 currency = conversion_rate. |
| processed_currency | varchar(3) | ? | ? | ? | ? | ? | ? | ? | ? | Actual currency processed. Applies to successful transactions. In Direct API processed_currency must match currency (transaction currency). |
| processed_amount | int(20) | ? | ? | ? | ? | ? | ? | ? | ? | Amount (in actual processing currency) in cents. Applies to successful transactions. Note: For certain currencies (see full list here) there is a fraction other than 100 cents per unit, this is important if you multiply by 100 to send the amount in cents. |
| spread_currency | varchar(3) | ? | ? | ? | ? | ? | ? | ? | ? | Currency from fx rate spread settings. |
| spread_amount | int(20) | ? | ? | ? | ? | ? | ? | ? | ? | The calculated amount that was subtracted from the total. Note: For certain currencies (see full list here) there is a fraction other than 100 cents per unit, this is important if you multiply by 100 to send the amount in cents. |
| fee | int(20) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Transaction fee based on the gateway settings. |
| fee_included | int(1) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Whether fee is included in the amount specified by customer within cashier or specified by the website in the cashier (VT) login call. |
| fee_type | varchar(32) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Can be either "flat" (flat fee amount) or "percent" (percent of the transaction amount). |
| payment_method | varchar(50) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Payment method |
| payment_processor | varchar(50) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Payment processor |
| gateway | varchar(32) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | HASH value of gateway that should processed transaction. |
| card | <Object> | ✓ | ✓ | ✓ | ✓ | ✕ | ✕ | ✕ | ✕ | Tokenized card object |
| wallet | <Object> | ✕ | ✕ | ✕ | ✕ | ✓ | ✓ | ✓ | ✓ | Tokenized wallet object |
| is_async | int | ✓ | ✓ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | Credit card - indicates if the transaction processing involves the 3DSecure verification - 0 for synchronous flow (non-3D Secure) - 1 for asynchronous flow (3D Secure) |
| is_cascade | int(1) | ✓ | ✓ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | Shows whether a transaction is processed with first attempt (0) or upon cascade (1). |
| cascade_level | int(2) | ✓ | ✓ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | Transaction retry number (in case of soft decline or network/application error during communication with PSP). |
| reference_id | int(11) | ✕ | ✕ | ✕ | ✓ | ✕ | ✕ | ✕ | ✓ | In case of refund, this value specifies the ID of transaction to be refunded. |
| withdrawal_request_id | int(11) | ✕ | ✕ | ? | ? | ✕ | ✕ | ? | ? | Original transaction identifier from . Use the tid of withdrawal request as withddrawal_request_id within the payout or refund if you want the payout amount to be deducted from withdrawal request as processed. |
| created_by | varchar(50) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Transaction initiator. Customer's activity is reflected with INTERNET, otherwise equals the name of the compliance or support agent. |
| edited_by | varchar(50) | ? | ? | ? | ? | ? | ? | ? | ? | Transaction modified by. Customer's activity is reflected with INTERNET, otherwise equals the name of the compliance or support agent. |
| status_code | varchar(32) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Processing status code (including processing and error codes). |
| status_details | varchar(256) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Verbal description of the processing status. |
| mit | varchar(128) | ? | ? | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | MIT object contains the list of settings for processing merchant-initiated transactions (MIT). The object is sent within notification only if MIT flow is used. Details can be found at the MIT object page. |
| redirect_url | varchar(256) | ? | ? | ? | ? | ? | ? | ? | ? | In order to have the "redirect_url" property appearing under transaction object, you will need to reach out to our support - requesting to enable the "Notifications for the delayed processing via Direct API" setting. Note: Info that application may always include redirect_url attribute (empty or having the value) if requested from our support. |
EXAMPLE
{
"transaction_type": "sale",
"transaction_status": "approved",
"tid": 756850,
"transaction_id": "13348",
"currency": "EUR",
"amount": 100,
"conversion_rate": 1.000000,
"processed_currency": "EUR",
"processed_amount": 100,
"fee": 0,
"fee_included": 0,
"fee_type": "flat",
"payment_method": "Credit Card",
"payment_processor": "TestCardProcessor",
"gateway": "s-pTSZyK23E1Ee5KZpcNbX_aFl0HuhQ0",
"card": {
"card_token": "J-4-a0vPhjZ9R75JP98VDUFgbh9y8sYr",
"card_type": "VISA",
"card_number": "411111******1111",
"card_exp": "12\/2024",
"card_issuer_name": "Bank of Somewhere",
"card_issuer_country": "GB"
},
"wallet": null,
"is_async": 1,
"is_cascade": 0,
"cascade_level": 0,
"reference_id": null,
"withdrawal_request_id": null,
"created_by": "INTERNET",
"edited_by": "INTERNET",
"status_code": "SC-002",
"status_details": "Transaction approved"
}