Parameters in Responses/Callbacks
You can enable additional parameters in the Responses and Callbacks you receive.
You can enable the below in the synchronous responses and in the notifications to your notification URL as well. Please find below a list of the extra parameters you could include.
General parameters
| Parameter | Value |
|---|---|
| bin | BIN value |
| bin_country | Bin Country |
| payment_method | Payment method which is used in the transaction |
| ccn_four | The last 4 digits of the CCN |
| card_type | Card type e.g. : Mastercard |
| currency | Currency e.g.: EUR |
| amount | Amount value |
| expiry_year | Expiry year other card. e.g. expiry_year=2029 |
| expiry_month | Expiry month of the card. e.g. expiry_month=07 |
| cardholder | Cardholder bank name |
First-Time Customer details
You can determine whether a customer is new or has had previous transactions based on a parameter provided in your responses or callbacks. (first_time_customer)
This feature can be enabled under the following conditions:
- By checking the email address:
- If there has been no successful transaction associated with the specified email address previously, the parameter first_time_customer=1 will be sent.
- Otherwise, it will be first_time_customer=0.
- By checking the credit card:
- If there has been no successful transaction associated with the specified credit card previously, the parameter first_time_customer=1 will be sent.
- Otherwise, it will be first_time_customer=0.
- By checking both the email address and credit card:
- If there has been no successful transaction associated with both the email address and credit card previously, the parameter first_time_customer=1 will be sent.
- Otherwise, it will be first_time_customer=0.
3DS parameters
| Parameter | Value |
|---|---|
| 3dstatus | Status of 3DS. e.g. Verified/Attempted/Non3d/Incomplete/Not verified |
| 3dauthentication_status | We sent "Y" for success, "N" for failed, "A" for attempted, "R" for Rejected from bank and "U" not authenticated due to unknown reason |
| 3dauthentication_flow | The flow of the 3DS: e.g. frictionless_flow/challenge_flow |
| 3dProtocolVersion | Protocol version. e.g.: 2.2.0 |
| 3dtransactionStatusReasonMessage | A message only when 3DS is failed |
| 3dtransactionStatusReason | An error code only when 3DS is failed |
| 3dcardholderInformation | Additional information to Cardholder about the rejection |
Visa and Mastercard details for Recurring or CoF Initial transactions
| Parameter | Value |
|---|---|
| banknet_date | Mastercard Settlement date |
| banknet_ref_number | Mastercard Financial Product Code and Banknet Reference |
| visa_transaction_id | Visa Transaction Identifier |
Response example with enabled parameters:
currency=EUR&card_type=Mastercard&3dstatus=VERIFIED&3dauthentication_status=Y&&cardholder=Payabl+Test& type=capture&amount=0.02&expiry_year=2029&bin_country=CYP&expiry_month=07&payment_method=1& transactionid=299223801&bin=535456&orderid=Payabl-Test&first_time_customer=0×timestamp=1738224826&errorcode=0& ccn_four=2917&errormessage=&3dProtocolVersion=2.2.0&3dauthentication_flow=frictionless_flow& security=6ec4f44449d1dc0fa67e9016e85c474c93dcc8645428d226596d5a35270cba54
Please contact your Client Relations Manager or our Technical support team to enable any of the above.
Updated 4 days ago