Overview

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             
Instalment Payment Data 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        
Transaction Type          

*  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. 

3DS Requestor Authentication Information

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      

3DS Requestor PriorAuthentication Information

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

   

Cardholder Account Information

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):

threeDSPolicy

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

 

sdkInformation

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

 

priorAuthenticationInfo

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

 

merchantRiskIndicator

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

 

customerInfo

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

 

credentialsOnFile
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

 

card
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)

Card issue number

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

 

browserInfo

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

 

accountInfo

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