Last updated

Use this process to test a 3DS challenge flow.

3DS is an additional security layer for online credit and debit card transactions. 3D stands for the three domains which interact using the protocol: the merchant or acquirer domain, the issuer domain, and the interoperability domain. For more information, see 3D Secure (3DS).

Configure 3DS on the payment gateway

  1. Configure 3DS on the payment gateway account:

    1. In the left navigation bar, press Settings .

    2. In the Configuration section, press Gateway accounts.

    3. Press TestProcessor.

    4. Press Edit gateway account.

    5. In the Setup instruction section, in the Instruction dropdown, select Authorize.

    6. In the Advanced configuration section, turn on the Advanced configuration toggle.

    7. Scroll down the page to the 3D secure section, then select the Activate 3D secure checkbox.

    8. In the 3D server dropdown, select ThreeDSecureIO3dsServer.

    9. Depending on which payment cards you would like to test using 3Ds, select from the following:

      At a minimum, you must enter details for Visa and Mastercard.

      • Visa
        1. In the Acquirer merchant ID Visa field, enter test-visa.
        2. In the Merchant acquirer BIN Visa field, enter 411111.
      • Mastercard
        1. In the Acquirer merchant ID Mastercard field, enter test-mastercard.
        2. In the Merchant acquirer BIN Mastercard field, enter 555555.
      • American Express (AMEX)
        1. In the Acquirer merchant ID AMEX field, enter test-amex.
        2. In the Merchant acquirer BIN Amex field, enter 378282.
      • Discover
        1. In the Acquirer merchant ID Discover field, enter test-discover.
        2. In the Merchant acquirer BIN Discover field, enter 601111.
      • JCB
        1. In the Acquirer merchant ID JCB field, enter test-jcb.
        2. In the Merchant acquirer BIN JCB field, enter 305693.
    10. In the Merchant name field, enter your merchant name.

    11. In the Merchant country dropdown, select a country.

    12. In the Merchant URL field, enter any valid URL.

    13. In the Transaction type dropdown, select Goods/Service purchase.

    14. At the bottom of the screen, press Save gateway account.

Create a test customer and transaction

  1. Create a new customer and test the transaction:

    1. In the left navigation bar, press Data tables, then press Customers.
    2. In the top right of the screen, press Add customer.
    3. Enter the test customer's details, then press Save customer.
    4. In the right of the screen, press , then press Collect payment.
    5. Enter the amount and add a description for the payment.
    6. Select the Pay with Rebilly hosted payment form option, and press Submit.
    7. Press Copy URL and open the URL in a browser.
    8. In the payment card number field, enter 4111111111111111. Use a future expiration date (avoid 10/2051), and any valid CVV (avoid 000, 0000 for Amex).
    9. Press Continue, then press Confirm.

Test 3DS outcomes

In the response, an approvalUrl value is returned. At the URL, simulate the different outcomes of the challenge flow in a 3DSecure.io sandbox environment.

To test different 3DS flows, use the last four digits from 3dsecure.io to generate a card number that passes the Luhn check. For more information, see 3DS browser tests.

Alternatively, select from the following predefined card numbers to test 3DS outcomes:

Card brandNumberOutcome
Visa4111111111111111Manual challenge
Mastercard5555555555554444Frictionless flow, authenticated
Visa4000000000000002Frictionless flow, not authenticated
Mastercard5105105105105100Frictionless flow, not authenticated