On This Page
Required Fields for Checking Enrollment in Payer
Authentication
These fields are the minimum fields required for verifying that a customer is
enrolled in a payer authentation program. Under certain circumstances, a field that
normally is optional might be required. The circumstance that makes an optional
field required is noted.
Required Fields
- billTo_city
- billTo_country
- This field is required for transactions in the US and Canada.
- billTo_email
- billTo_firstName
- billTo_httpBrowserColorDepth
- billTo_httpBrowserJavaEnabled
- billTo_httpBrowserJavaScriptEnabled
- billTo_httpBrowserLanguage
- billTo_httpBrowserScreenHeight
- billTo_httpBrowserScreenWidth
- billTo_httpBrowserTimeDifference
- billTo_ipAddress
- billTo_lastName
- billTo_phoneNumber
- This field is required ifpayerAuthEnrollService_mobilePhoneorbillTo_workNumberis not used.
- billTo_postalCode
- This field is required for transactions in the US and Canada.
- billTo_state
- This field is required for transactions in the US and Canada.
- billTo_street1
- card_accountNumber
- card_cardType
- card_expirationMonth
- This field is required whencard_accountNumberis included.
- card_expirationYear
- This field is required whencard_accountNumberis included.
- invoiceHeader_merchantDescriptorCountry
- For Meeza transactions, this value must be set toEGwhen Egypt is not set as the country in the merchant configuration during merchant boarding.
- merchantReferenceCode
- payerAuthEnrollService_deviceChannel
- This field is required for SDK integration. When you use the SDK integration, this field is dynamically set toSDK. When you use the JavaScript code, this field is dynamically set toBrowser. For merchant-initiated or 3RI transactions, you must set the field to3RI. When you use this field in addition to JavaScript code, you must set the field toBrowser.
- payerAuthEnrollService_httpAccept
- When the customer’s browser provides a value, include that value in your request.
- payerAuthEnrollService_httpUserAccept
- payerAuthEnrollService_httpUserAgent
- payerAuthEnrollService_ merchantCountrycode
- For Meeza transactions, this value must be set toEGwhen Egypt is not set as the country in the merchant configuration during merchant boarding.
- payerAuthEnrollService_messageCategory
- payerAuthEnrollService_mobilePhone
- This field is required ifpayerAuthEnrollService_workPhoneorbillTo_phoneNumberis not used.
- payerAuthEnrollService_referenceID
- payerAuthEnrollService_returnURL
- payerAuthEnrollService_run
- This field is required (when available) unless market or regional mandate restricts sending this information.
- payerAuthEnrollService_workPhone
- This field is required ifpayerAuthEnrollService_mobilePhoneorbillTo_phoneNumberis not used.
- purchaseTotals_currency
- purchaseTotals_grandTotalAmount
- This field is optional when you use theitem_#_unitPricefield.