The tables below contain the full list and description of all parameters available for the merchant to send to Cashier Deposit page via an HTTP request.
The Mandatory field describes whether the parameter is mandatory and if so, for what transaction type. The options for the Mandatory field are:
- All: The parameter is mandatory in every request made.
- No: The parameter is not mandatory.
- Risk: By default, the parameter is configured as mandatory for the risk analysis and should be included in every request made. Changes to the mandatory risk fields must be approved by the Nuvei Risk team. It is recommended to collect and submit as many parameters in addition to the mandatory risk fields, as each additional parameter improves the risk analysis.
|merchant_id||Integer||64bits||All||The merchant’s ID provided by Nuvei.|
|merchant_site_id||Integer||64bits||All||The merchant website’s ID provided by Nuvei.|
|checksum||String||Char(102400)||All||A hashing of the request to secure and authenticate the request.|
|time_stamp||String||Char(19)||All||Current GMT time in the following format: YYY-MM-DD.HH:MM:SS.|
|currency||String||Char(3)||All||The currency used in the transaction.|
|invoice_id||String||Char(100)||No||A unique invoice identifier provided by the merchant or randomly generated.|
|payment_method||String||Char(256)||No||The type of payment method selected by the customer.
Credit Card: cc_card
Debit Card: dc_card
Alternative PM: For the values of specific APMs, see alternativePaymentMethod Class.
|payment_method_mode=filter||This parameter filters out any payment method that is not the payment method sent in the
|merchantLocale||String||Char(5)||No||The language and country of the user in ISO code in the following format:
[language ISO]_[country ISO]
Unless specified, the default is English.
The possible values of this parameter is provided below:
English (US): en_US
English (UK): en_UK
Chinese: (PRC) zh_CN
Dutch (Standard): nl_NL
English (Canada): en_CA
English (Australia): en_AU
|userId||String||Char(50)||No||The customer’s ID as per the merchant’s UserId.|
|theme_id||Integer||64bits||No||Use this field overrides|
|customData||String||Char(255)||No||General data about the customer provided by the merchant.|
|merchant_unique_id||String||Char(64)||No||The unique ID (identifier) of the transaction in the merchant’s database.|
If encoding=UTF-8, then this fields is mandatory.
|The type of character encoding. Default value is ISO-8859-1.|
|webMasterId||String||Char(255)||No||This is an affiliate parameter that the merchant can send to Cashier.|
|allow_installments||Integer||64 bits||No||This parameter indicates whether payment may be made in installments or not, if this feature is supported by the merchant. The possible value of this parameter is either ‘1’ (yes) or ‘0’ (no).|
|max_num_installments||Integer||64 bits||No||This parameter indicates the maximum amount of installments with which the payment can be made.|
|processingChannel||String||Char (4)||No||Sends “MOTO” value whenever the processing channel is from MOTO type (mail or telephone order)|
|item_name_N*||String||Char(400)||Yes||The name of item number N.**|
|item_number_N||String||Char(400)||Yes||The first part of the items list, the serial number.
Counted from item_number_1 to item_number_N.
|item_amount_N||Double||64 bits||Yes||The cost of the item numbered in the item_number_N parameter.|
|item_shipping_N||Double||64 bits||No||Shipping costs of the item numbered in the item_number_N parameter.|
|item_handling_N||Double||64 bits||No||Handling costs of the item numbered in the item_number_N parameter.|
|item_discount_N||Double||64 bits||No||Discount rate of the item numbered in the item_number_N parameter.|
|item_quantity_N||Integer||64 bits||Yes||Number of pieces of the item numbered in the item_number_N parameter.
Default value is 1.
|numberofitems||Double||64 bits||Conditional||Number of items to process.
Mandatory if the number of items is greater than 1.
Default value is 1.
|discount||Double||64 bits||No||The total discount out of the total amount.|
|shipping||Double||64 bits||No||Total shipping costs.|
|handling||Double||64 bits||No||Total handling costs.|
|total_amount||Double||64 bits||Yes||Total transaction charge.|
|total_tax||Double||64 bits||No||Total taxes.|
|productId||String||Char(50)||No||Merchant’s product ID.
If this parameter is left empty, Cashier inserts a concatenation of all item names.
|promoCode||String||Char(512)||No||This value is a promotional code you define that you can use to apply discounts to your products or services.
To activate this field, contact Nuvei Technical Support.
|nettelerAccount||String||Neteller||The customer's Neteller account number.|
|nettelerSecureId||String||Neteller||The customer's Neteller SecureId.|
|qiwi_phonenumber||String||Qiwi||The customer's phone number registered with Qiwi.|
* N represents the item count number. The first item is item_name_1 up to item_name_n.
** Currently item names can only include ISO-8859-1 character set encoding.
|user_token||String||Char (8)||No||This parameter determines if the payment page requires existing customers to register for each transaction.
|user_token_id||String||Char (255)||Yes||ID for the user, based on which we manage the user’s payment methods.|
|userPaymentOptionId||String||No||This ID specifies the user payment option to use for the transaction when user_token = readonlyupo|
*Indicates that this parameter must be sent as part of the HTTPS request for Nuvei’s risk checks.
|first_name*||String||30||Yes||Customer’s first name.|
|last_name*||String||40||Yes||Customer’s last name.|
|email*||String||100||Yes||Customer’s email address.|
|country*||String||20||Yes||Customer’s two-letter ISO country code (see Country Codes).|
|state*||String||20||Yes||Customer’s two-letter ISO state code (for customers based in the US, Canada and India only).|
|zip*||String||10||Yes||Customer’s zip code.|
|personal_id||String||Char(11)||No||The personal ID is the customer’s ID number issued by his/her respective country. This is only required for South American customers.|
|dateOfBirth||String||Char(10)||No||The date of birth of the registering user. (YYYY-MM-DD)|
The Nuvei payment page handles the SCA 3D-Secure v2 process for the merchant. The merchant only needs to add parameters to the call for the web cashier URL to assist in completing the SCA process. For further information about the 3D-Secure v2, please refer to our 3D-Secure Guide.
Even though most of the below parameters are optional, it is highly recommended passing as many details as possible in the call to increase the chances of a frictionless authentication rather than invoking a challenge of the end user.
The following table displays the parameters that need to be added to fully support the 3D-Secure v2 process.
|deliveryEmail||String (254)||No||For electronic delivery, the email address to which the merchandise is delivered.
|deliveryTimeFrame||String (2)||No||This parameter indicates the merchandise delivery timeframe.
01 = Electronic delivery
02 = Same day shipping
03 = Overnight shipping
04 = Two-day or more shipping
|giftCardAmount||String (15)||No||For prepaid or gift card purchase, this represents the purchase amount total of prepaid or gift card(s) in major units (for example, USD 123.45 is 123).|
|giftCardCount||String (2)||No||For prepaid or gift card purchase, this represents the total count of individual prepaid or gift cards/codes purchased.|
|giftCardCurrency||String (3)||No||For prepaid or gift card purchase, this represents the ISO 4217 three-letter currency code of the gift card.|
|preOrderDate||String (8)||No||For a pre-ordered purchase, this represents the expected date that the merchandise is available.
|preOrderInd||String (2)||No||This indicates whether the cardholder is placing an order for merchandise with a future availability or release date.
01 = Merchandise available
02 = Future availability
|reorderItemsInd||String (2)||No||This indicates whether the cardholder is reordering previously purchased merchandise.
01 = First time ordered
02 = Reordered
|shipIndicator||String (2)||No||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
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” / Pickup 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, e-media subscriptions, etc.)
|threeDSChallengeWindowSize||String (2)||No||Challenge Window Size
01 = 250 x 400
02 = 390 x 400
03 = 500 x 600
04 = 600 x 400
05 = Full screen
Note: If no value is sent, the default value is 03.
|accountAge||String (2)||No||Length of time that the cardholder has had the account with the 3DS Requestor.
01 = No account (guest checkout)
02 = Created during this transaction
03 = Less than 30 days
04 = 30–60 days
05 = More than 60 days
|accountLastChangeDate||String (8)||No||Date that the cardholder’s account with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.
|accountLastChangeInd||String (2)||No||Length of time since the cardholder’s account information with the 3DS Requestor was last changed, including Billing or Shipping address, new payment account, or new user(s) added.
01 = Changed during this transaction
02 = Less than 30 days
03 = 30–60 days
04 = More than 60 days
|accountRegistrationDate||String (8)||No||Date that the cardholder opened the account with the 3DS Requestor.
|accountPasswordChangeDate||String (8)||No||Date that cardholder’s account with the 3DS Requestor had a password change or account reset.
|accountResetInd||String||No||Indicates the length of time since the cardholder’s account with the 3DS Requestor 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
|accountPurchasesCount6M||String (4)||No||Number of purchases with this cardholder account during the previous six months.|
|accountAddCardAttempts24H||String (3)||No||Number of Add Card attempts in the last 24 hours.|
|accountTransactionsCount24H||String (3)||No||Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous 24 hours.|
|accountTransactionsCount1Y||String (3)||No||Number of transactions (successful and abandoned) for this cardholder account with the 3DS Requestor across all payment accounts in the previous year.|
|accountAddressFirstUseDate||String (8)||No||Date when the shipping address used for this transaction was first used with the 3DS Requestor.
|accountAddressFirstUseInd||String (2)||No||Indicates when the shipping address used for this transaction was first used with the 3DS Requestor.
01 = This transaction
02 = Less than 30 days
03 = 30–60 days
04 = More than 60 days
|accountNameInd||String (2)||No||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
|accountSuspiciousActivityInd||String (2)||No||Indicates whether the 3DS Requestor has experienced suspicious activity (including previous fraud) on the cardholder account.
01 = No suspicious activity has been observed
02 = Suspicious activity has been observed
The following details are required whenever product shipping is involved.
|shippingFirstName||String||30||No||Recipient’s first name.|
|shippingLastName||String||40||No||Recipient’s last name.|
|shippingCountry||String||20||No||Recipient’s country in an ISO code (see Country Codes).|
|shippingZip||String||10||No||Recipient’s zip code.|
|skip_review_tab||String||Char(5)||No||A switch (true/false) indicating whether or not to skip the Cashier’s review page.|
|success_url||String||Char (2048)||No||The customer is redirected to this URL on successful transaction.|
|error_url||String||Char (2048)||No||The customer is redirected to this URL on error.|
|pending_url||String||Char (2048)||No||The customer is redirected to this URL when response is pending.|
|back_url||String||Char (2048)||No||The customer is redirected to this URL when user presses the ‘Back’ button.|
|notify_url||String||Char (2048)||No||The DMN URL.
1 = Opens a redirect-based APM in a new window.
0 = Opens the redirect APM in the same window (Iframe)
|quick_deposit||Boolean||1||No||For more information, please contact Nuvei’s Integration Team.|
* If some of the page’s mandatory parameters are missing, the customer’s browser is redirected to the “Cancel Page” URL.
|descriptorMerchantName||String||Char(25)||No||Allows the merchant to define a dynamic descriptor for the merchant’s name.|
|descriptorMerchantPhone||String||Char(13)||No||Allows the merchant to define a dynamic descriptor for the merchant’s phone number.|
|customSiteName||String||Char(50)||No||The merchant’s site name that should replace the default MerchantSite name. This parameter is useful for merchants operating many websites that are distinguished only by name.|
|String||Char(64)||No||Custom fields for the merchant to update miscellaneous data. This is sent to the Cashier in the HTTP request and returned in its response.|