Name

Accepted values

Description

Email 1

128 symbols

Cardholder E-mail 

HomePhone 1

15 symbols

The home phone number provided by the cardholder (with a country code)

WorkPhone 1

15 symbols

The work phone number provided by the cardholder (with a country code)

MobilePhone 1

15 symbols

The mobile phone number provided by the cardholder (with a country code)

shipAddrCountry2

symbols

Country code of the delivery address applied to the specific order, format ISO 3166-1

shipAddrState2

symbols

Regional or state code of the delivery address applied to a specific order, in accordance with ISO 3166-2

shipAddrCity2

50 symbols

Delivery address city applied to a specific order

shipAddrPostCode2

16 symbols

Post code of the delivery address applied to a specific order

shipAddrLine12

50 symbols

Street, house, building, letter of delivery address applied to a specific order

shipAddrLine22

50 symbols

Apartment delivery address applied to a specific order

CustomerID

32 symbols

Customer identifier in the merchant system (encoding or creating a related ID is recommended for data security).

Parameter is CustomerNumber value, if the merchant uses the OneClick service

CustomerAccAgeInd

symbols


Length of time that the cardholder has had the account with the merchant system:
01 – No account (guest check-out);
02 - Created during this transaction
03 – Less than 30 days;
04 – 30-60 days;
05 – More than 60 days.

CustomerAccDate

symbols
YYYYMMDD

Date that the cardholder opened the account with the merchant system

CustomerAccChangeInd

symbols


Length of time since the cardholder’s account information with the merchant system was last changed:
01 – Changed during this transaction;
02 - Less than 30 days;
03 – 30-60 days;
04 – More than 60 days.

CustomerAccChange

symbols
YYYYMMDD

Date that the cardholder’s account with the merchant system was last changed

CustomerPwChangeInd

symbols


Indicates the length of time since the cardholder’s account with the merchant system had a password change or account reset:
01 – No change;
02-  Changed during this transaction ;
03 – Less than 30 days;
04 – 30-60 days;
05 – More than 60 days.

CustomerPwChange

symbols
YYYYMMDD

Date that cardholder’s account with the merchant system had a password change or account reset.

shipAddressUsageInd

symbols


Indicates when the shipping address used for this transaction was first used with the merchant system.
01 - This transaction;
02 – Less than 30 days;
03 – 30-60 days;
04 – More than 60 days.

shipAddressUsage

symbols
YYYYMMDD

Date when the shipping address used for this transaction was first used with the merchant system.

shipNameIndicator

symbols


Indicates if the cardholder name on the account is identical to the shipping name used for this transaction:
01 – Account name identical to shipping name;
02 – Account name different than shipping name.

merchantRiskIndicator

JSON Data Type: Object

Merchant’s assessment of the level of fraud risk for the specific authentication for both the cardholder and the authentication being conducted. See the Table "Merchant Risk Indicator".

suspiciousAccActivity

symbols


Indicates whether the merchantr has experienced suspicious activity (including previous fraud) on the cardholder account:
01 – No suspicious activity has been observed;
02 -  Suspicious activity has been observed.

nbPurchaseAccount

symbols

Number of purchases with this cardholder account during the previous six months.

txnActivityDay

symbols

Number of transactions (successful and abandoned) for this cardholder account with the merchant across all payment accounts in the previous 24 hours.. 

txnActivityYear

symbols

Number of transactions (successful and abandoned) for this cardholder account with the merchant across all payment accounts in the previous 24 hours.

provisionAttemptsDay3

symbols

Number of Add Card attempts in the last 24 hours.

paymentAccInd3

symbols


Indicates the length of time that the payment account was enrolled in the cardholder’s account with the merchant:
01 – No account (guest check-out);
02- During this transaction;
03 – Less than 30 days;
04 – 30-60 days;
05 – More than 60 days.

paymentAccAge3

symbols
YYYYMMDD

Date that the payment account was enrolled in the cardholder’s account with the merchant.


1The parameters (highlighted in red in the table) are present in the list of parameters of the authorization request. The merchant should check the possibility of their transfer and compliance with additional format requirements, if these parameters are already transferred.


2 The parameters (highlighted in yellow in the table) refer to the delivery address for this order. If the enterprise already sends the delivery address for a specific order as the main parameters (Country, State, City, Zip, Address in the authorization request), then the transfer of these additional parameters is not required.


3 Parameters (highlighted in green in the table) for enterprises that accept cards on their side.

Merchant Risk Indicator

Field name

Format

Description

shipIndicator

symbols

Indicates shipping method chosen for the transaction. Merchants must choose the Shipping Indicator code that most accurately describes the cardholder’s specific transaction, not their general business.  If one or more items are included in the sale, use the Shipping Indicator code for the physical goods, or if all digital goods, use the Shipping Indicator code that describes the most expensive item.
01 – Ship to cardholder’s billing address (not used);
02 –  Ship to another verified address on file with merchant;
03 –  Ship to address that is different than the cardholder’s billing address;
04 – “Ship to Store” / Pick-up at local store (Store address shall be populated in shipping address fields);
05 –  Digital goods (includes online services, electronic gift cards and redemption codes);
06 – Travel and Event tickets, not shipped;
07 - Other (for example, Gaming, digital services not shipped, emedia subscriptions, etc.)

deliveryTimeframe

symbols

Indicates the merchandise delivery timeframe:
01 – Electronic Delivery;
02 – Same day shipping;
03 - Overnight shipping;
04 – Two-day or more shipping.

deliveryEmailAddress

254 symbols

For Electronic delivery, the email address to which the merchandise was delivered.

reorderItemsInd

symbols

Indicates whether the cardholder is reordering previously purchased merchandise:
01 – First time ordered;
02 –  Reordered.

preOrderPurchaseInd

symbols

Indicates whether cardholder is placing an order for merchandise with a future availability or release date:
01 – Merchandise available;
02 –  Future availability.

preOrderDate

symbols

For a pre-ordered purchase, the expected date that the merchandise will be available.
Date format  YYYYMMDD

giftCardAmount

15 digits

For prepaid or gift card purchase, the purchase amount total of prepaid or gift card(s) in major units (for example, USD 123.45 is 123).

giftCardCurr

symbols

For prepaid or gift card purchase, ISO 4217 three-digit currency code of the gift card

giftCardCount

symbols

For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.

Back on top