PAYONE build an EMV 3DS Service that does not require merchants to implement any changes to their existing integrations while ensuring full compliance to minimum data requirements for authentication requests as stipulated by the card schemes.
Parameters are already existing our Server-API. Some optional parameters will become mandatory as of January 1, 2021.
All of the mandatory data elements are already available in the PAYONE Server API ( ) or they will be handled through the 3DS Service Application ( ). A few parameters that are optional will become required for creditcard transactions to meet EMVCo's requirements ( ). Only optional data elements marked with ( ) have been newly introduced and may require development if deemed necessary.
(Parameters extracted by the 3DS Service do not have to be delivered additionally via Server-API.)
Transactional and Checkout Page Information
Data Element |
PAYONE Server API Name |
PAYONE 3DS Service |
EMVCo - Required |
EMVCo - Optional |
PAYONE Server API Required |
PAYONE Server API Optional |
VISA Additional Mandatory fields |
3DS Method Completion Indicator |
|
|
|
|
|
|
|
3DS Requestor Authentication Indicator |
|
|
|
|
|
|
|
3DS Challenge Indicator |
|
|
|
|
|
|
|
3DS Requestor ID |
|
|
|
|
|
|
|
3DS Requestor Name |
|
|
|
|
|
|
|
3DS Requestor URL |
|
|
|
|
|
|
|
3DS Server Operator ID |
|
|
|
|
|
|
|
3DS Server Reference Number |
|
|
|
|
|
|
|
3DS Server Transaction ID |
|
|
|
|
|
|
|
3DS Server URL |
|
|
|
|
|
|
|
3RI Indicator |
|
|
|
|
|
|
|
Account Type |
|
|
|
|
|
|
|
Acquirer BIN |
will be set by PAYONE based on merchant's VU Nummer |
|
|
|
|
|
|
Acquirer Merchant ID |
will be set by PAYONE deducted from merchant's VU Nummer |
|
|
|
|
|
|
Address Match Indicator |
will be set by PAYONE as Y, if shipping address equals billing address ; as N otherwise |
|
|
|
|
|
|
Broadcast Information |
|
|
|
|
|
|
|
Browser Accept Headers |
browserinfo_accept_headers |
|
|
|
|
|
|
Browser IP Address |
ip |
|
|
|
|
|
|
Browser Java Enabled |
browserinfo_java_enabled |
|
|
|
|
|
|
Browser Language |
browserinfo_language |
|
|
|
|
|
|
Browser Screen Color Depth |
browserinfo_color_depth |
|
|
|
|
|
|
Browser Screen Height |
browserinfo_screen_height |
|
|
|
|
|
|
Browser Screen Width |
browserinfo_screen_width |
|
|
|
|
|
|
Browser Time Zone |
browserinfo_time_zone_offset |
|
|
|
|
|
|
Browser User-Agent |
browserinfo_user_agent |
|
|
|
|
|
|
Card/Token Expiry Date |
cardexpiredate |
|
|
|
|
|
|
Cardholder Account Identifier |
accountinfo_account_identifier |
|
|
|
|
|
|
Cardholder Account Number |
cardpan (or pseudocardpan) |
|
|
|
|
|
|
Cardholder Billing Address City |
city |
|
|
|
|
|
|
Cardholder Billing Address Country |
country |
|
|
|
|
|
|
Cardholder Billing Address Line 1 |
street oder streetname+streetnumber |
|
|
|
|
|
|
Cardholder Billing Address Line 2 |
addressaddition |
|
|
|
|
|
|
Cardholder Billing Address Line 3 |
addressaddition |
|
|
|
|
|
|
Cardholder Billing Address Postal Code |
zip |
|
|
|
|
|
|
Cardholder Billing Address State |
state |
|
|
|
|
|
|
Cardholder Email Address |
email |
|
|
|
|
|
* * |
Cardholder Home Phone Number |
telephonenumber |
|
|
* |
|
|
* * |
Cardholder Mobile Phone Number |
telephonenumber |
|
|
* |
|
|
* * |
Cardholder Work Phone Number |
telephonenumber |
|
|
* |
|
|
* * |
Cardholder Name |
cardholder
If the card holder is not specified the PAYONE platform will use firstname / lastname for card holder or company - if required.
|
|
|
|
( ) |
|
|
Cardholder Shipping Address City |
shipping_city |
|
|
* |
|
|
|
Cardholder Address Country |
shipping_country |
|
|
* |
|
|
|
Cardholder Shipping Address Line 1 |
shipping_street oder streetname+streetnumber |
|
|
* |
|
|
|
Cardholder Shipping Address Line 2 |
shipping_addressaddition |
|
|
* |
|
|
|
Cardholder Shipping Address Line 3 |
shipping_addressaddition |
|
|
* |
|
|
|
Cardholder Shipping Address Postal Code |
shipping_zip |
|
|
* |
|
|
|
Cardholder Shipping Address State |
shipping_state |
|
|
* |
|
|
|
Cardholder Work Phone Number |
telephonenumber |
|
|
* |
|
|
|
Device Channel |
|
|
|
|
|
|
|
EMV Payment Token Indicator |
|
|
|
|
|
|
|
|
not yet implemented |
|
|
|
|
|
|
Merchant Category Code |
will be set by PAYONE based on initial setup |
|
|
|
|
|
|
Merchant Country Code |
will be set by PAYONE based on initial setup |
|
|
|
|
|
|
Merchant Name |
will be set by PAYONE based on initial setup |
|
|
|
|
|
|
Message Category |
|
|
|
|
|
|
|
Message Extension |
|
|
|
|
|
|
|
Message Type |
|
|
|
|
|
|
|
Message Version Number |
|
|
|
|
|
|
|
Notification URL |
|
|
|
|
|
|
|
Purchase Amount |
amount |
|
|
|
|
|
|
Purchase Currency |
currency |
|
|
|
|
|
|
Purchase Currency Exponent |
will currently be set by PAYONE based on currency |
|
|
|
|
|
|
Purchase Date & Time |
will be set by PAYONE as timestamp of request in UTC |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* A word on shipping address and phone numbers:
The EMVCo Spec declares these parameters as “Required unless market or regional mandate restricts sending this information” or “Required (if available) unless market or regional mandate restricts sending this information”. Since no country in the European Economic Area (EEA) explicitly restricts sending these parameters, they're technically required. However, the Schemes have clarified “ACSs must not decline EMV 3DS messages when one or more of these conditional fields are absent.”
This means that shipping address and phone numbers are, in fact, required by the EMVCo Spec. The PAYONE Platform won't however decline the processing of credit card requests without these parameters. Please note that these parameters have a high influence on the internal risk assessment of the issuers.
- * As from 12th August 2024, VISA requires mandatory either email or telephone number to be provided.
- EMVCo specifies 3 separate fields for Home, Mobile and Work phone number, while PAYONE API provides only telephonenumber field, where you can provide any of the available phone numbers you gather from the Customer.
Data Element |
PAYONE Server API Name |
PAYONE 3DS Service |
EMVCo - Required |
EMVCo - Optional |
PAYONE Server API Required |
PAYONE Server API Optional |
3DS Requestor Authentication Method |
accountinfo_authentication_method |
|
|
|
|
|
3DS Requestor Authentication Timestamp
|
accountinfo_authentication_timestamp |
|
|
|
|
|
Data Element |
PAYONE Server API Name |
PAYONE 3DS Service |
EMVCo - Required |
EMVCo - Optional |
PAYONE Server API Required |
PAYONE Server API Optional |
3DS Requestor Prior Transaction Reference
|
priorauthenticationinfo_reference
|
|
|
|
|
|
3DS Requestor Prior Transaction Authentication Method
|
priorauthenticationinfo_method
|
|
|
|
|
|
3DS Requestor Prior Transaction Authentication Timestamp
|
priorauthenticationinfo_timestamp
|
|
|
|
|
|
3DS Requestor Prior Transaction Authentication Data
|
priorauthenticationinfo_data
|
|
|
|
|
|
Merchant Risk Indicator
Data Element |
PAYONE Server API Name |
PAYONE 3DS Service |
EMVCo - Required |
EMVCo - Optional |
PAYONE Server API Required |
PAYONE Server API Optional |
Shipping Indicator
|
merchantriskindicator_shipping_address_indicator
|
|
|
|
|
|
Delivery Timeframe
|
merchantriskindicator_delivery_time_frame
|
|
|
|
|
|
Delivery Email Address
|
merchantriskindicator_delivery_email
|
|
|
|
|
|
Reorder Items Indicator
|
merchantriskindicator_reorder_items_indicator
|
|
|
|
|
|
Pre-Order Purchase Indicator
|
merchantriskindicator_pre_order_purchase_indicator
|
|
|
|
|
|
Pre-Order Date
|
merchantriskindicator_pre_order_date
|
|
|
|
|
|
Gift Card Amount
|
merchantriskindicator_gift_card_amount
|
|
|
|
|
|
Gift Card Currency
|
merchantriskindicator_gift_card_curr
|
|
|
|
|
|
Gift Card Count
|
merchantriskindicator_gift_card_count
|
|
|
|
|
|
Data Element |
PAYONE Server API Name |
PAYONE 3DS Service |
EMVCo - Required |
EMVCo - Optional |
PAYONE Server API Required |
PAYONE Server API Optional |
Cardholder Account Age Indicator
|
accountinfo_account_age_indicator
|
|
|
|
|
|
Cardholder Account Date
|
accountinfo_account_change_date
|
|
|
|
|
|
Cardholder Account Change Indicator
|
accountinfo_account_change_indicator
|
|
|
|
|
|
Cardholder Account Change
|
accountinfo_account_change_date
|
|
|
|
|
|
Cardholder Account Password Change Indicator
|
accountinfo_password_change_date_indicator
|
|
|
|
|
|
Cardholder Account Password Change
|
accountinfo_password_change_date
|
|
|
|
|
|
Shipping Address Usage Indicator
|
accountinfo_ship_address_usage_indicator
|
|
|
|
|
|
Number of Transactions Day
|
accountinfo_nbr_transactions_day
|
|
|
|
|
|
Number of Transactions Year
|
accountinfo_nbr_transactions_year
|
|
|
|
|
|
Number of Provisioning Attempts Day
|
accountinfo_add_card_attempts_day
|
|
|
|
|
|
Cardholder Account Purchase Count
|
accountinfo_nbr_of_purchases
|
|
|
|
|
|
Suspicious Account Activity
|
accountinfo_suspicious_acc_activity
|
|
|
|
|
|
Shipping Name Indicator
|
not implemented yet
|
|
|
|
|
|
Payment Account Age Indicator
|
accountinfo_payment_account_age_indicator
|
|
|
|
|
|
Payment Account Age
|
accountinfo_payment_account_age
|
|
|
|
|
|
Cardholder Account Identifier |
accountinfo_account_identifier |
|
|
|
|
|
Authentication Method |
accountinfo_authentication_method |
|
|
|
|
|
Authentication Timestamp |
accountinfo_authentication_timestamp |
|
|
|
|
|
Cardholder Account Date |
accountinfo_account_creation_date |
|
|
|
|
|
Shipping Address Usage |
accountinfo_ship_address_usage_date |
|
|
|
|
|
Reference
For a complete documentation of 3DS related additional parameters, please refer to below information (expandable):
The parameter group contains information about the previous authentication..
threeDSPolicy
threedspolicy_exemption_reason
optional
|
Format: List
Permitted Values: lowValue
Indicates the type of SCA exemption requested.
The "lowValue" exemption is supported only for transaction amount less than 30 EUR.
|
threedspolicy_skip_three_ds
optional
|
Format: List
Permitted Values: outOfScope
In case when requested, the liability for fraud lies with the Merchant.
Allows the Merchants to request skipping 3DS for the Out of Scope transactions. Implemented for One-Leg-Out only.
|
Server API Error Messages
No. |
Signification |
2591 |
Parameter {threedspolicy_exemption_reason} incorrect |
Server API Examples
threedspolicy_exemption_reason=lowValue
The parameter group contains information about the SDK used.
sdkInformation
sdkinformation_app_ID
required
|
Format: CHAR(1..256)
Universally unique ID created upon all installations and updates of the 3DS Requestor APp on a Customer Device. This will be newly generated and stored by the 3DS SDK for each installation or update. The field is limited to 36 characters and it shall have a canonical format as defined in IETF RFC 4122. This may utilise any of the specified versions as long as the output meets specified requirements.
|
sdkinformation_counter_sto_a
required
|
Format: CHAR(1..255)
Counter used as a security measure in the 3DS SDK to ACS secure channel.
|
sdkinformation_enc_data
optional
|
Format: CHAR(1..65535)
JWE Object as defined Section 6.2.2.1 containing data encrypted by the SDK for the DS to decrypt. This element is the only field encrypted in this version of the EMV 3-D Secure specification. The field is sent from the SDK and it is limited to 64.000 characters. The data will be present when sending to DS, but not present from DS to ACS.
|
sdkinformation_ephem_pubkey
required
|
Format: CHAR(1..256)
Public key component of the ephemeral key pair generated by the 3DS SDK and used to establish session keys between the 3DS SDK and ACS. In AReq, this data element is contained within the ACS Signed Content JWS Object. The field is limited to maximum 256 characters.
|
sdkinformation_max_timeout
required
|
Format: NUMERIC
Indicates the maximum amount of time (in minutes) for all exchanges. The field shall have value greater or equals than 05.
|
sdkinformation_reference_number
required
|
Format: CHAR(1..255)
Identifies the vendor and version of the 3DS SDK that is integrated in a 3DS Requestor App, assigned by EMVCo when the 3DS SDK is approved. The field is limited to 32 characters.
|
sdkinformation_trans_ID
required
|
Format: CHAR(1..255)
Universally unique transaction identifier assigned by the 3DS SDK to identify a single transaction. The field is limited to 36 characters and it shall be in a canonical format as defined in IETF RFC 4122. This may utilise any of the specified versions as long as the output meets specific requirements.
|
Server API Error Messages
No. |
Signification |
2600 |
Parameter {sdkinformation_app_ID} incorrect or missing |
2601 |
Parameter {sdkinformation_counter_sto_a} incorrect or missing |
2602 |
Parameter {sdkinformation_enc_data} incorrect |
2603 |
Parameter {sdkinformation_ephem_pubkey} incorrect or missing |
2604 |
Parameter {sdkinformation_max_timeout} incorrect or missing |
2605 |
Parameter {sdkinformation_reference_number} incorrect or missing |
2606 |
Parameter {sdkinformation_trans_ID} incorrect or missing |
Server API Examples
sdkinformation_app_ID=1074b85d-bfd7-4fbf-82f5-e3a2312d1556
sdkinformation_counter_sto_a=001
sdkinformation_enc_data=VY29gBNq5HQwZ2ZMy0oucK0scqGuu1Nbvw3NngTD473Gx8ehrtfK5-SPchH1TSble2nq21sTFhyL26ctU9yeGvmb3SelwwCPSqLJkQhLC_TWQcaD-zA2j5_d5OZXInnDsZDSqvOVoWiq4Po11HenDACkpVrCDaFRCsEEuRcWsV64GI3J9uoMK8mJhf5fYeQPIe9Y0Ogwx3CD2jAaLMNe6cbFKGyowf8DRlnOzRvVgeGYHoySX3YgV-w0Zw9Mgb6fyq332MP-OawETdNByfRT7b5_m4chskUSj0PFO3TRnpUJ6HFY7ml
xIRxAiIBJLDW9Cj8IdoL95sl5PxhyeAORxSw
sdkinformation_ephem_pubkey=eyJpc3MiOiJqb2UiLA0KICJleHAiOjEzMDA4MTkzODAsDQogImh0dHA6Ly9leGFtcGxlLmNvbS9pc19yb290Ijp0cnVlfQ
sdkinformation_max_timeout=5
sdkinformation_reference_number=1234567ABC
sdkinformation_trans_ID=5aeba7f8-58de-46e8-ab14-a6827a4c3f5f
The parameter group contains information about the previous authentication.
priorAuthenticationInfo
priorauthenticationinfo_data
optional
|
Format: CHAR(1..2048)
Data that supports and documents a specific authentication process carried out by the merchant such as FIDO
|
priorauthenticationinfo_method
optional
|
Format: List
Permitted Values: frictionless, ACSchallenge, AVSverified, other
Cardholder mechanism used for prior authentication.O
|
priorauthenticationinfo_timestamp
optional
|
Format: timestamp (no time zone check)
Date and time (see RFC 3339) of the previous cardholder authentication in UTC.
JJJJ-MM-DD*D*HH:MM:SS+00:00
|
priorauthenticationinfo_reference
optional
|
Format: CHAR(1..255)
This data element contains an ACS transaction ID for a previous authenticated transaction (for example, the first recurring transaction authenticated by the cardholder).
|
Server API Error Messages
No. |
Signification |
2580 |
Parameter {priorauthenticationinfo_data} incorrect |
2581 |
Parameter {priorauthenticationinfo_method} incorrect |
2582 |
Parameter {priorauthenticationinfo_timestamp} incorrect |
2583 |
Parameter {priorauthenticationinfo_reference} incorrect |
Server API Examples
priorauthenticationinfo_data=ABC
priorauthenticationinfo_method=ACSchallenge
priorauthenticationinfo_timestamp=2020-06-12T19:12:45+00:00
priorauthenticationinfo_reference=ebc1822f-268e-4bdb-97b0-af1b270a12a9
The group contains parameters for risk evaluation on the merchant side.
merchantRiskIndicator
merchantriskindicator_delivery_email
optional
|
Format: CHAR(1..255)
For electronic delivery, the e-mail address to which the goods were delivered
|
merchantriskindicator_delivery_time_frame
optional
|
Format: List
Permitted Values: electronicDelivery, sameDayDelivery, nextDayDelivery, twoOrMoreDaysDelivery
Indicates the time period for the delivery of goods.
|
merchantriskindicator_gift_card_amount
optional
|
Format: NUMERIC
For the purchase of prepaid or gift cards, the total purchase amount of prepaid or gift cards in the smallest currency unit
|
merchantriskindicator_gift_card_count
optional
|
Format: NUMERIC
For the purchase of prepaid or gift cards, the total number of individual prepaid or gift cards/codes purchased
|
merchantriskindicator_gift_card_curr
optional
|
Format: CHAR(3)
For the purchase of prepaid or gift cards, the three-digit currency code of the gift card according to ISO 4217
|
merchantriskindicator_pre_order_date
optional
|
Format: DATE(8), YYYYMMDD
For a pre-ordered purchase, the expected date on which the goods will be available (YYYYMMDD)
|
merchantriskindicator_pre_order_purchase_indicator
optional
|
Format: LIST
Permitted Values: true / false
Indicates whether the customer places an order for a product with future availability or future release date
|
merchantriskindicator_reorder_items_indicator
optional
|
Format: LIST
Permitted Values: true / false
Indicates whether the customer reorders a previously purchased product
|
merchantriskindicator_shipping_address_indicator
optional
|
Format: List
Permitted Values: shipToBillingAddress,shipToVerifiedAddress,shipToNewAddress,shipToStore,digitalGoods,noShipment,other
Specifies the delivery method selected for the transaction. If the sale includes one or more items, use the Code Shipping Indicator for the physical goods, or if all are digital goods, use the Code Shipping Indicator to describe the most expensive item.
|
Server API Error Messages
No. |
Signification |
2560 |
Parameter {priorauthenticationinfo_data} incorrect |
2561 |
Parameter {priorauthenticationinfo_method} incorrect |
2562 |
Parameter {priorauthenticationinfo_timestamp} incorrect |
2563 |
Parameter {priorauthenticationinfo_reference} incorrect |
2564 |
Parameter {priorauthenticationinfo_reference} incorrect |
2565 |
Parameter {priorauthenticationinfo_reference} incorrect |
2566 |
Parameter {priorauthenticationinfo_reference} incorrect |
2567 |
Parameter {priorauthenticationinfo_reference} incorrect |
2568 |
Parameter {priorauthenticationinfo_reference} incorrect |
Server API Examples
merchantriskindicator_delivery_email=test@mail.com
merchantriskindicator_delivery_time_frame=electronicDelivery
merchantriskindicator_gift_card_amount=10.00
merchantriskindicator_gift_card_count=1
merchantriskindicator_gift_card_curr=EUR
merchantriskindicator_pre_order_date=20200817
merchantriskindicator_pre_order_purchase_indicator=true
merchantriskindicator_reorder_items_indicator=false
merchantriskindicator_shipping_address_indicator=shipToBillingAddress
The parameter group contains data on the end customer.
customerInfo
salutation
optional
|
Format: CHAR(1..10)
The customer's salutation
|
firstname
optional
|
Format: CHAR(1..50)
First name of customer; optional if company is used, i.e.: you may use
- "company"
- or "lastname"
- or "firstname" plus "lastname"
|
lastname
optional
|
Format: CHAR(1..50)
Last name of customer; optional if company is used, i.e.: you may use
- "company"
- or "lastname"
- or "firstname" plus "lastname"
|
company
optional
|
Format: CHAR(1..50)
Company name of customer; The company name is optional if lastname is used, i.e.: you may use
- "company"
- or "lastname"
- or "firstname" plus "lastname"
|
birthday
optional
|
Format: DATE(8), YYYYMMDD
Date of birth of customer YYYYMMDD, e.g. 19771015
|
dba_name
optional
|
Format: CHAR(1..255)
Doing business as – name. For applicable suppliers.
|
vatid
optional
|
Format: CHAR(1..50)
VAT identification number. Used for b2b transactions to indicate VAT number of customer.
|
Server API Error Messages
No. |
Signification |
2630 |
Parameter {dba_name} incorrect |
If a parameter in this list is marked as required, it means that this parameter is required in case you want to process a recurring payment. Otherwise, these parameters are not required for single payments. This use case will be set with the existing parameter "recurrence" and will be documented separately.
The parameter group contains data of a recurring payment (Credentials on File).
sdkInformation
credentialsonfile_recurring_frequency
required
|
Format: NUMERIC
Specifies the number of days between authorizations
|
credentialsonfile_recurring_start_date
optional
|
Format: DATE(8), YYYYMMDD
Determines the date of the first authorization according to the recurring mandate
|
credentialsonfile_recurring_expiry_date
required
|
Format: DATE(8), YYYYMMDD
Date after which no further authorizations should be processed.
|
initial_payment
required
|
Format: LIST
Permitted Values: true / false
Indicates whether a card transaction with stored data is the first transaction in a series or a subsequent transaction
|
Server API Error Messages
No. |
Signification |
2550 |
Parameter {credentialsonfile_recurring_frequency} incorrect or missing |
2551 |
Parameter {credentialsonfile_recurring_start_date} incorrect |
2552 |
Parameter {credentialsonfile_recurring_expiry_date} incorrect or missing |
2553 |
Parameter {initial_payment} incorrect or missing |
Server API Examples
credentialsonfile_recurring_frequency=30
credentialsonfile_recurring_start_date=20200101
credentialsonfile_recurring_expiry_date=20210101
initial_payment=false
We strongly recommend using our card tokenization mechanic as outlined in Hosted-iFrame Mode - Short description. Not only will this significantly decrease your PCI DSS compliance efforts, using the tokenized pseudocardpan will also decrease the amount of card parameters you will have to handle.
The parameter group contains credit card data. Most of this data already exists..
card
cardcvc2
optional
|
Format: CHAR(1..4)
Card verification number. Not required if pseudocardpan ist used.
|
card_start_date
optional
|
Format: DATE(4), YYMM
Card start date in format YYMM
|
cardexpiredate
optional
|
Format: DATE(6), YYYYMM
Card expiry date in format YYYYMM. Not required if pseudocardpan ist used.
|
cardholder
optional
|
Format: CHAR(1..255)
Name of the cardholder as indicated on the card. Otherwise we will join firstname and lastname as cardholder.
|
cardissuenumber
optional
|
Format: CHAR(1..255)
|
cardpan
optional
|
Format: CHAR(1..255)
Card number
Cardpan or pseudocardpan will be needed.
|
pseudocardpan
optional
|
Format: CHAR(1..255)
Card token
Cardpan or pseudocardpan will be needed.
|
cardtype
optional
|
Format: CHAR(1..255)
Card Network. Not required if pseudocardpan ist used.
|
Server API Error Messages
No. |
Signification |
2620 |
Parameter {card_start_date} incorrect |
The parameter group contains data about the browser of the end customer.
browserInfo
browserinfo_accept_headers
optional
|
Format: CHAR(1..2048)
Exact content of the HTTP accept header as sent by the customer's browser
|
browserinfo_java_enabled
optional
|
Format: List
Permitted Values: true / false
Boolean value that indicates the ability of the customer's browser to execute Java. Required if browserinfo_java_script_enabled = true; otherwise optional.
|
browserinfo_java_script_enabled
optional
|
Format: List
Permitted Values: true / false
Boolean value that indicates the ability of the customer browser to execute JavaScript
|
browserinfo_language
optional
|
Format: CHAR(1..255)
Value of the browser language according to IETF BCP47
|
browserinfo_color_depth
optional
|
Format: NUMERIC
Permitted Values: 2 / 4 / 8 / 15 / 16 / 24 / 32 / 48
This value specifies the bit depth of the color palette for displaying images in bits per pixel. Required if browserinfo_java_script_enabled = true; otherwise optional.
|
browserinfo_screen_height
optional
|
Format: NUMERIC
Total screen height of the cardholder in pixels. Required if browserinfo_java_script_enabled = true; otherwise optional.
|
browserinfo_screen_width
optional
|
Format: NUMERIC
Total screen width of the cardholder in pixels. Required if browserinfo_java_script_enabled = true; otherwise optional.
|
browserinfo_time_zone_offset
optional
|
Format: CHAR(1..255)
Time zone shift in minutes between UTC and the cardholder's local browser time. Required if browserinfo_java_script_enabled = true; otherwise optional. Note that the offset is positive if the local time zone is behind UTC and negative if it is ahead.
|
browserinfo_user_agent
optional
|
Format: CHAR(1..2048)
Exact content of the HTTP user-agent header
|
Server API Error Messages
No. |
Signification |
2530 |
Parameter {browserinfo_accept_headers} incorrect or missing |
2531 |
Parameter {browserinfo_java_enabled} incorrect |
2532 |
Parameter {browserinfo_java_script_enabled} incorrect or missing |
2533 |
Parameter {browserinfo_language} incorrect or missing |
2534 |
Parameter {browserinfo_color_depth} incorrect |
2535 |
Parameter {browserinfo_screen_height} incorrect |
2536 |
Parameter {browserinfo_screen_width} incorrect |
2537 |
Parameter {browserinfo_time_zone_offset} incorrect |
2538 |
Parameter {browserinfo_user_agent} incorrect or missing |
Server API Examples
browserinfo_accept_headers=text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
browserinfo_java_enabled=false
browserinfo_java_script_enabled=true
browserinfo_language=de-DE-1901
browserinfo_color_depth=24
browserinfo_screen_height=930
browserinfo_screen_width=1800
browserinfo_time_zone_offset=60
browserinfo_user_agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/74.0.3729.169 Safari/537.36
The parameter group contains data on the customer's account at the merchant / shop.dealer/shop.
accountinfo
accountinfo_account_identifier
optional
|
Format: CHAR(1..255)
The cardholder's account ID in the merchant environment / website (e.g. customer number)
|
accountinfo_authentication_method
optional
|
Format: List
Permitted Values: guest, merchantCredentials, federatedID, issuerCredentials, thirdPartyAuthentication, SRCassuranceData
This data element specifies the mechanism used by the cardholder to authenticate himself/herself to the merchant.
|
accountinfo_authentication_timestamp
optional
|
Format: timestamp (no time zone check)
Date and time (see RFC 3339) of cardholder authentication in UTC.
YYYY-MM-DD*D*HH:MM:SS+00:00
|
accountinfo_account_age_indicator
optional
|
Format: LIST
Permitted Values: guestCheckout, thisTransaction, lessThan30Days, from30To60Days, moreThan60Days
Duration, how long the customer has the method of payment / payment account with the merchant.
|
accountinfo_account_change_date
optional
|
Format: DATE(8), YYYYMMDD
Date of the last change of the customer's method of payment (account) with the merchant including billing or delivery address, new payment account or newly added user(s) (YYYYMMDD).
|
merchantriskindicator_pre_order_date
optional
|
Format: DATE(8), YYYYMMDD
For a pre-ordered purchase, the expected date on which the goods will be available (YYYYMMDD)
|
accountinfo_account_change_indicator
optional
|
Format: LIST
Permitted Values: thisTransaction, lessThan30Days, from30To60Days, moreThan60Days
Time period since the last change of the customer's account information at the merchant including billing or shipping address, new payment account or newly added user(s).
|
accountinfo_account_creation_date
optional
|
Format: DATE(8), YYYYMMDD
Date on which the customer opened the account in the format YYYYMMDD
|
accountinfo_password_change_date
optional
|
Format: DATE(8), YYYYMMDD
Date of the last password change or resetting of the customer account in format YYYYMMDD
|
accountinfo_password_change_date_indicator
optional
|
Format: List
Permitted Values: thisTransaction, lessThan30Days, from30To60Days, moreThan60Days, noChange
Specifies the length of time since the password was changed or since the customer account was reset.
|
accountinfo_nbr_of_purchases
optional
|
Format: NUMERIC
Number of purchases in the last 6 months
|
accountinfo_add_card_attempts_day
optional
|
Format: NUMERIC
Number of attempts to add a card in the last 24 hours
|
accountinfo_nbr_transactions_day
optional
|
Format: NUMERIC
Number of transactions (successful and aborted) in the last 24 hours
|
accountinfo_nbr_transactions_year
optional
|
Format: NUMERIC
Number of transactions (successful and aborted) in the last year
|
accountinfo_payment_account_age
optional
|
Format: DATE(8), YYYYMMDD
Date on which the payment account was registered in the customer account, in the format YYYYMMDD
|
accountinfo_payment_account_age_indicator
optional
|
Format: LIST
Permitted Values: thisTransaction, lessThan30Days, from30To60Days, moreThan60Days, guestCheckout
Indicates the period of time for which the payment account is registered in the customer account.
|
accountinfo_ship_address_usage_date
optional
|
Format: DATE(8), YYYYMMDD
Date when the delivery address provided for this transaction was first used, in format YYYYMMDD
|
accountinfo_ship_address_usage_indicator
optional
|
Format: LIST
Permitted Values: thisTransaction, lessThan30Days, from30To60Days, moreThan60Days
Indicates when the shipping address specified for this transaction was first used.
|
accountinfo_suspicious_acc_activity
optional
|
Format: LIST
Permitted Values: true / false
Indicates whether the merchant has detected suspicious activity (including past fraud) in the customer account
|
Server API Error Messages
No. |
Signification |
2500 |
Parameter {accountinfo_account_identifier} incorrect |
2501 |
Parameter {accountinfo_authentication_method} incorrect or missing |
2502 |
Parameter {accountinfo_authentication_timestamp} incorrect or missing |
2503 |
Parameter {accountinfo_account_age_indicator} incorrect |
2504 |
Parameter {accountinfo_account_change_date} incorrect |
2505 |
Parameter {accountinfo_account_change_indicator} incorrect |
2506 |
Parameter {accountinfo_account_creation_date} incorrect |
2507 |
PParameter {accountinfo_password_change_date} incorrect |
2508 |
Parameter {accountinfo_password_change_date_indicator} incorrect |
2509 |
Parameter {accountinfo_nbr_of_purchases} incorrect |
2510 |
Parameter {accountinfo_add_card_attempts_day} incorrect |
2511 |
Parameter {accountinfo_nbr_transactions_day} incorrect |
2512 |
Parameter {accountinfo_nbr_transactions_year} incorrect |
2513 |
Parameter {accountinfo_payment_account_age} incorrect |
2514 |
Parameter {accountinfo_payment_account_age_indicator} incorrect |
2515 |
Parameter {accountinfo_ship_address_usage_date} incorrect |
2516 |
Parameter {accountinfo_ship_address_usage_indicator} incorrect |
2517 |
Parameter {accountinfo_suspicious_acc_activity} incorrect |
Server API Examples
accountinfo_account_identifier=test@mail.com
accountinfo_authentication_method=merchantCredentials
accountinfo_authentication_timestamp=2020-06-25T12:45:13+00:00
accountinfo_account_age_indicator=from30To60Days
accountinfo_account_change_date=20200625
accountinfo_account_change_indicator=thisTransaction
accountinfo_account_creation_date=20200501
accountinfo_password_change_date=20200501
accountinfo_password_change_date_indicator=thisTransaction
accountinfo_nbr_of_purchases=3
accountinfo_add_card_attempts_day=0
accountinfo_nbr_transactions_day=1
accountinfo_nbr_transactions_year=3
accountinfo_payment_account_age=20200625
accountinfo_payment_account_age_indicator=from30To60Days
accountinfo_ship_address_usage_date=20200501
accountinfo_ship_address_usage_indicator=from30To60Days
accountinfo_suspicious_acc_activity=false