3D Secure Step 1: Gateway configuration, Advanced Billing test site, test credentials, and cards

Enabling 3DS at your gateway

Most gateways require you to take some action on their side to enable 3D Secure. Below we will outline what is needed for each gateway.

Please be aware that this article is related to testing and implementing 3D Secure. We currently support 3DS on the following gateways: Stripe, Braintree, CyberSource, Windcave (Payment Express), Adyen. You can find more information about 3D secure by checking out this help article: Testing & Implementing 3D Secure.

Gateway	What To Do
Stripe	3DS is already enabled in Stripe by default.
Braintree	Please contact Braintree to ensure 3DS is enabled on your account. More info can be found here.
CyberSource	Contact CyberSource to enable 3D Secure on your account and retrieve Cardinal Commerce credentials.
Windcave (Payment Express)	Contact Windcave support and request a set of REST API credentials (REST API Username and REST API Key) that are linked to your existing PxPost credentials under the same “Group Account”. Note: ensuring that this linkage is under the same Group Account is important for correct functionality with Advanced Billing. In addition, have them enable “AJAX_POST” and "FORM_POST" for your account. The Windcave credential types will differ depending on whether the Advanced Billing site is used for testing or production. Test sites should use UAT credentials, whereas live sites will use SEC. Windcave itself will also have separate usernames and passwords for its “test” and “live” environments.
Adyen	3DS is already enabled in Adyen by default.
BlueSnap	Visit BlueSnap Account > Settings > Fraud Settings and enable 3D Secure: 3D Secure rules for BlueSnap account.

Configuring an Advanced Billing test site with test gateway credentials

If you haven’t created an Advanced Billing test site yet, it is recommended to create one in order to test the 3DS flow. When configuring your gateway on the test site, you may have to provide additional information to enable 3DS support.

Gateway	What To Do
Stripe	No additional steps are needed for Stripe.
Braintree	Visit Config > Settings > Payment Gateway and edit your Braintree credentials. At the bottom of the popup, there will be a checkbox that will enable SCA requests Enable SCA requests for Braintree inside Advanced Billing.
CyberSource	Cybersource requires two additional steps, both are completed on the same page in Advanced Billing. From Config > Settings > Payment Gateway, choose to edit your existing credentials and perform the following: Add your Cardinal Cruise API Identifier, Cardinal Cruise API Key, and Cardinal Cruise Unit ID Click the checkbox for “Strong Customer Authentication (SCA) Enabled” Enable SCA requests for Cybersource inside Advanced Billing.
Windcave (Payment Express)	Windcave requires two additional steps, both are completed on the same page in Advanced Billing. From Config > Settings > Payment Gateway, choose to edit your existing credentials and perform the following: Fill in your Windcave REST credentials, which consist of the API username and key Click the checkbox for “Strong Customer Authentication (SCA) Enabled” Enable SCA requests for Windcave inside Advanced Billing.
Adyen	Visit Config > Settings > Payment Gateway and edit your Adyen credentials. At the bottom of the popup, there will be a checkbox that will enable SCA requests. Enable SCA requests for Adyen inside Advanced Billing and select an SCA Live Environments close to your location: Europe Australia US
BlueSnap	Visit Config > Settings > Payment Gateway and edit your BlueSnap credentials. At the bottom of the popup, there will be a checkbox that will enable SCA requests. Enable SCA requests for BlueSnap inside Advanced Billing.

Gateway Test Cards

Most gateways provide unique test card numbers you can use to simulate successful and unsuccessful 3DS flows.

Gateway	Test Cards
Stripe	`4000000000003063` For more information, refer to Stripe’s documentation.
Braintree	Please refer to Braintree’s documentation.
CyberSource	Successful cards: `4000000000001091` (Visa) `5200000000001096` (MasterCard) `340000000001098` (American Express) Unsuccessful cards: `4000000000001109` (Visa) `5200000000001104` (MasterCard) `340000000001106` (American Express) For more information, refer to Cybersource’s documentation.
Windcave (Payment Express)	Windcave’s documentation may be found here. Use any future card expiration date and any 3-digit CSC/CVC value for successful and/or unsuccessful payments. Successful cards: `5588880000077770` (Mastercard) Unsuccessful cards: `5431111111111228` (Mastercard) `4999999999999996` (Visa)
Adyen	`4917610000000000`, expiry date: `03/2030`, CVV: `737` (Visa) `371449635398431`, expiry date: `03/2030`, CVV: `7373` (American Express) More test credit cards with 3D Secure
BlueSnap	Successful without challenge: `4000000000000101` (Visa) `5200000000000908` (Mastercard) Successful with challenge: `4000000000000002` (Visa) `5200000000000007` (Mastercard) Failed with challenge: `4000000000000028` (Visa) `5200000000000023` (Mastercard) Unavailable: `4000000000000069` (Visa) `5200000000000064` (Mastercard) Expiration Date: The expiration month is always January. The expiration year is the `current year plus 3 years`. For example: In 2019, the Expiration Date value is 01/2022. Security Code (CVV): any `3‑digit` code Challenge: The user name `test1` is prefilled. The password is `1234` For more information, refer to BlueSnap’s documentation.