Skip to main content

Hosted Implementation

If your Merchant Account is set up for 3-D Secure, the Hosted Payment Page will automatically attempt to display the 3-D Secure authentication page for the Customer’s bank.

The 3-D Secure authentication form is designed and controlled by the Customer’s Issuing bank and will display the Merchant Account name and any website address added when the account was onboarded. You can change the displayed name and website address by sending the merchantName and/or merchantWebsite request fields. Any merchantWebsite must be a fully qualified URL containing at least the scheme and host components.

You may also pass additional information about the transaction and Cardholder, using the threeDSOptions field as detailed in the 3-D Secure Options (Hosted and Direct Integration) section. This extra information can help the Issuer decide on whether a challenge is required

Your Merchant Account must be configured with your Merchant Category Code (MCC). This value can be configured in the Merchant Management System (MMS) or provided using the merchantCategoryCode or threeDSOptions request fields.

If you would like an example of a 3-D Secure Hosted Integration, please refer to our sample code.