3DS with Hosted Checkout
This topic describes how payer authentication using 3D Secure (3DS) is implemented when using the Hosted Checkout integration method. The Hosted Checkout integration method uses the Payer Authentication API functionality for 3DS in the background. This indicates that if your merchant profile is configured for it, the Hosted Payment Page automatically handles 3DS authentication in your Hosted Checkout integration. You do not need to take any other action to add 3DS authentication into your payment flows.
Once you complete your basic Hosted Checkout integration, test the 3DS functionality along with more general testing.
For more information, see Testing your 3DS Integration.
Authentication transaction
The Payer Authentication API records the details of the 3DS payer authentication as a separate AUTHENTICATION transaction on the order. This indicates that:
- When you retrieve an order using the
RETRIEVE ORDERoperation, the response contains an additionalAUTHENTICATIONtransaction (transaction[n].transaction.type = AUTHENTICATION). - When you receive a Reporting API response, it contains an additional
AUTHENTICATIONtransaction. - When you use Webhook notifications , you receive an additional notification for the
AUTHENTICATIONtransaction.
For more information about the AUTHENTICATION transaction fields, see the response fields of the Authenticate Payer operation.
Search and view 3DS payer authentication transactions
You can search for and view 3DS payer AUTHENTICATION transactions in the Merchant Administration using Search > Orders and Transactions.
Follow these steps to search and view the 3DS payer AUTHENTICATION transactions:
- Log in to Merchant Administration and then, go to Search > Orders and Transactions.
- Use the Transactions search to set the Transaction Type filter to Authentication and search for AUTHENTICATION transactions.
- Use the Orders search to find your order.
- Select View corresponding to the order to view the details of the order. If you perform the payer authentication for the order, the list of transactions display an AUTHENTICATION transaction.
- Select View to view the details of the payer authentication.