Benefits
- Enhanced Security: Adds a robust layer of authentication to prevent fraudulent transactions.
- Reduced Friction: Most legitimate transactions are processed without any extra steps for the customer.
- Increased Trust: Provides customers with greater confidence that their payments are secure.
Implementation
To enable Customer Authentication Module when using Secure Fields for Click to Pay, add theauthenticate.consumer property to your Secure Fields configuration and set it to true.
When enabled, CAM automatically collects and analyzes data to authenticate customers during checkout, providing enhanced security without any additional integration effort.
Common issues
3DS overlay pops up but automatically closes
3DS overlay pops up but automatically closes
This occurs when the 3DS acquirer configuration does not match the required values. Check the 3DS acquirer configuration and verify that the acquirer details for each card scheme are configured exactly as per the Mastercard Unified Checkout Solutions SDK reference, listed below.Mastercard
Visa
| Parameter | Value |
|---|---|
| Acquirer BIN | 545301 |
| Acquirer Merchant ID | SRC3DS |
| Parameter | Value |
|---|---|
| Acquirer BIN | 432104 |
| Acquirer Merchant ID | 33334444 |
No 3DS prompt when you expect a challenge flow
No 3DS prompt when you expect a challenge flow
On supported devices, authentication can complete with a passkey and no 3DS prompt appears. If you expect a challenge-based 3DS flow and no prompt appears, work through the following checks.1. Check which features are enabledIn the browser developer tools, open the Network tab and find the request to
click-to-pay.html.
Copy the Request URL and URL-decode it twice. The decoded payload should include an authenticate block reflecting the features you have enabled:authenticate.checkout controls TAS and authenticate.consumer controls CAM. If either value is missing or set to false, the feature is not enabled.2. Check the dynamicDataType fieldIn the same decoded payload, ensure that the dynamicDataType field is either omitted or set to CARD_APPLICATION_CRYPTOGRAM_SHORT_FORM.
This configuration requests a dynamic network token, which TAS requires.3. Verify acquirer_data is present in the acquirer responseIn the Network tab, locate the acquirer request.
The response must have values for acquirer_data. If there is no acquirer data, it is likely due to the checkout session initiation.
Ensure the checkout session setup was created with the correct data fields.