Click To Pay

Overview

Click to Pay is an intelligent, password-free online checkout option that provides a quick and easy checkout experience designed to make ‘guest checkout’ faster and easier across all devices. Click to Pay provides a single checkout button and a standardised checkout flow for all participating card schemes, including Mastercard, Visa, American Express, Discover, and others. Click to Pay is built off EMVCo's SRC specification and replaces Masterpass, Visa Checkout, and Amex Express Checkout.

A payer can create a Click to Pay profile using their email address. During checkout, the payer must then provide this email address and perform an additional verification step with a one-time passcode (OTP). They can also choose the "Remember me" option to subsequently skip the verification when using the same browser in a subsequent checkout. The payer can store multiple credit, debit, or prepaid cards, the associated billing addresses, and multiple shipping addresses in their Click to Pay profile. Card details are securely stored, and additional security is provided by offering network tokenization where possible (market acceptance of network tokenization must be enabled). Click to Pay allows your payer to select the payment details to be used for the payment; however, the payment itself is processed using the acquirer configured for your merchant profile in the gateway.

The Click to Pay ‘Embedded Experience’ is supported through a JavaScript SDK if you are using your own payment page. Click to Pay is currently only available in a select number of countries. Check with your payment service provider to see if it is available in your country. The Click to Pay ‘Embedded Experience’ is supported on MasterCard Payment Gateway from API version 62 for Mastercard, Visa, and American Express cards. You will need to build your integration using the MTF environment first and then go live on the production environment.

Key Benefits

Click to Pay offers the following benefits:

  • Intelligent consumer recognition, ‘embedded’ into the checkout flow, to initiate faster guest checkout across all devices (with no passwords to remember).
  • A reduction in clicks and manual card entry to ultimately increase conversion and create frictionless experiences.
  • Potential for higher authorization approval rates, via network tokenization, assisting in the reduction of preventable declines.
  • Built upon EMVCo Secure Remote Commerce standards to create a consistent user experience and lower fraud rates in eCommerce guest checkout payment moments.
  • Secure exchange of payment data including card details, billing, and shipping address details.

Prerequisites

If you want to offer Click to Pay as a checkout option to your payers:

  • Contact your payment service provider to ensure that Click to Pay is available to you.
  • From the Admin menu in Merchant Administration, click SRC Configuration and follow the instructions to onboard to SRC and activate SRC for your merchant profile. You must have the required privilege to update your SRC configuration.

Interaction sequence flows diagrams

The following diagrams detail the Web Service API and JavaScript operations for each Click to Pay flow.

New Card / Payer
Returning payer recognized by cookie
Returning payer recognized by email

Click to Pay Payment Details

This section describes the payment details returned for Click to Pay interactions.

Type of Payment Details Returned for Click to Pay Interactions

Click to Pay supports returning different types of payment details for processing. The payment details returned by the Click to Pay system depend on the type requested by the gateway, your configuration in the Click to Pay system, and the card scheme. Click to Pay typically returns a network token, token expiry, and full cryptogram (where supported by the card scheme).

If a card does not support network tokenization (for example, where the the issuer is not participating), Click to Pay returns the card details (card number and card expiry) instead of network token details (network token, token expiry and cryptogram).

If you are a U.S. merchant and have indicated that you want to make use of your rights under the Durbin amendment, Click to Pay provides the card details (card number and card expiry) for debit cards.

Click to Pay Payment Details in API Transaction Response

The payment details selected by the payer during the Click to Pay interaction are stored in the session and returned in the transaction response for API requests performed using the session. When Click to Pay provides the network token details, both the network token details and the (masked) card details are provided.

Depending on the type of payment details returned by the Click to Pay system, you receive the following details in the API response.

Name Response
Network token with full cryptogram (American Express does not support this type of network token) (The cryptogram is not returned in transaction responses)
  • The response contains sourceOfFunds.type=SCHEME_TOKEN
  • The (masked) card details are returned in the following fields:
    • sourceOfFunds.provided.card.number
    • sourceOfFunds.provided.card.expiry.year
    • sourceOfFunds.provided.card.expiry.month
  • The network token details are returned in the following fields:
    • sourceOfFunds.provided.card.deviceSpecificNumber
    • sourceOfFunds.provided.card.deviceSpecificExpiry.month
    • sourceOfFunds.provided.card.deviceSpecificExpiry.year
Card number and expiry
  • The response contains sourceOfFunds.type=CARD
  • The (masked) card details are returned in the following fields.
    • sourceOfFunds.provided.card.number
    • sourceOfFunds.provided.card.expiry.year
    • sourceOfFunds.provided.card.expiry.month

Payer Details

The payer's name and phone number are provided in the transaction response in the customer parameter group.

The payer's email address is provided in the transaction response in the customer.email field, if you have set consumerEmailAddressRequested to true.

Billing Address Details

The billing address details associated with the card are provided in the transaction response in the billing.address parameter group.

Shipping Address Details

If you have set collectShippingAddress to true, the shipping address details are provided in the transaction response in the shipping.address parameter group.

Merchant-Initiated Transactions

You must not offer Click to Pay as a checkout option to your payers if you want to subsequently use those payment details to initiate payments in a series, such as recurring or installment payments. This will be supported in a future release.

Adding Click To Pay to Your Integration

The gateway supports the following integration options for Click To Pay

Integration Option When to Use Integration Experience
Hosted Checkout This is the easiest integration option. To initiate Click To Pay directly from the payer's browser, you must first establish the authentication channel where your merchant server must communicate with the gateway server for creating a session on the gateway. The gateway generated session Id is then included in all browser-initiated authentication requests as the password parameter (see session-based authentication). You will work directly with Mastercard Gateway for all aspects of integration. There is no external certification required.
Hosted Session This is a client-side JavaScript integration that allows you to have control over the layout and styling of your payment page, while reducing PCI compliance costs. Use this option if you want to allow the payer to submit their payment details directly to the gateway from the browser (see session-based authentication). You will enable and integrate through Mastercard Gateway. There may be certification needs from external SRCis.
Direct API This is a Direct integration option that allows you to integrate directly with an SRCi for the Click To Pay experience. Use this option if you are integrating with an external SRCi for Click To Pay, and utilizing Mastercard Gateway for Payment Processing. You will integrate directly with an SRCi for the Click to Pay experience, and use the tokens received in Mastercard Gateway transactions.

Test Your Integration

The MPGS Click to Pay experience can be tested using merchant’s test profile.

Supported Testing Methods

Region Live or Test Merchant Card Type Used Functionality/Purpose
MTF Live Click to Pay Provided – Sandbox Test Card Testing through the Click to Pay Sandbox portion of the Payment flow only
MTF Test MPGS Provided Test Card Testing the merchant’s integration with MPGS only (Click to Pay Portion of flow is simulated)
Production Live Live Cards owned by the merchant Full end to end testing with MPGS and Click to Pay
Production Test MPGS Provided Test Card Testing the merchant’s integration with MPGS only (Click to Pay Portion of flow is simulated)

Please note: These cards may not work with EMV 3DS or test payment processing. You may need to test these features separately using the standard TEST merchant prefix approach.

Static Testing Details

When you have completed your integration with the gateway for Click to Pay, you can test it by using your test merchant profile (your merchant ID prefixed with TEST). When using the test merchant profile the gateway provides a simulator for the Click to Pay interaction. The Click to Pay simulator uses a set of pre-defined payment details that cannot be modified. Based on the pre-defined payment details, you can trigger and test different scenarios, as described below.

The second column in the tables below indicates the last 4 digits of FPAN selected by the payer during the Click to Pay interaction. To trigger a scenario, select the corresponding FPAN on the simulator during the payer's Click to Pay interaction.

Scenario: SRC Returns a Network Token and Full Cryptogram
Scheme Last 4 digits of FPAN SRC Correlation ID Resulting API UPDATE_SESSION_FROM_WALLET Response Resulting API AUTHORIZE or PAY Response
Mastercard xxx0007 783a935d-c6a9-4289-b19d-c3336f998b57
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=DEBIT
  • sourceOfFunds.provided.card.number=511111xxxxxx1118-Token
  • sourceOfFunds.provided.card.expiry.month=10-Token Expiry
  • sourceOfFunds.provided.card.expiry.year=25-Token Expiry
  • sourceOfFunds.provided.card.devicePayment.3DSecure. onlinePaymentCryptogram=1234-Cryptogram
  • sourceOfFunds.provided.card.maskedFpan=222300xxxxxx0007-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=5-FPAN Expiry
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=21-FPAN Expiry

Shipping Address

  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2 = Floor 14, CBD
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=DEBIT
  • sourceOfFunds.provided.card.number=222300xxxxxx0007-FPAN
  • sourceOfFunds.provided.card.expiry.month=5-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=21-FPAN Expiry
  • sourceOfFunds.provided.card.deviceSpecificNumber=511111xxxxxx1118-Token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=10-Token Expiry
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=25-Token Expiry

Shipping Address

  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd, O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 300 Adelaide Street, Floor 21
Visa xxx0003 12345671-visaTAVV-expiry0822-colShiptrue
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=453224xxxxxx4198-Token
  • sourceOfFunds.provided.card.expiry.month=8-Token Expiry
  • sourceOfFunds.provided.card.expiry.year=22-Token Expiry
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith
  • sourceOfFunds.provided.card.devicePayment.3DSecure.eciIndicator. onlinePaymentCryptogram=AgAAAAAABkwdwbyAkpPMQAAAAAA=-Cryptogram
  • sourceOfFunds.provided.card.devicePayment.3DSecure.eciIndicator=07
  • sourceOfFunds.card.maskedFpan=444411xxxxxx3333-FPAN
  • sourceOfFunds.card.maskedFpanExpiry.month=8-FPAN Expiry
  • sourceOfFunds.card.maskedFpanExpiry.year=22-FPAN Expiry

Shipping Address

  • shipping.address.contact.firstName=Tony
  • shipping.address.contact.lastName=Tyre
  • shipping.address.street=Level 42, 700 Somewhere Street
  • shipping.address.city=Brisbane
  • shipping.address.stateProvince=QLD
  • shipping.address.postcodeZip=4000
  • shipping.address.country=AUS

Customer Details

  • customer.email=emulator@tnsi.com
  • customer.firstName= Mr. John Smith
  • customer.lastName=John
  • customer.mobilePhone=+61 0444111222
  • customer.phone=+61 0444111222

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2 = Floor 14, CBD
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=444411xxxxxx3333-FPAN
  • sourceOfFunds.provided.card.expiry.month=8-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=22-FPAN Expiry
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith
  • sourceOfFunds.provided.card.deviceSpecificNumber=453224xxxxxx4198-Token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=8-Token Expiry
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=22-Token Expiry

Shipping Address

  • shipping.address.contact.firstName=Tony
  • shipping.address.contact.lastName=Tyre
  • shipping.address.street=Level 42, 700 Somewhere Street
  • shipping.address.city=St. Brisbane
  • shipping.address.stateProvince=QLD
  • shipping.address.postcode=4000
  • shipping.address.country=AUS

Customer Details

  • customer.email=emulator@tnsi.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 300 Adelaide Street, Floor 21
Scenario: SRC Returns a Network Token and a Dynamic Card Security Code
Scheme Last 4 digits of FPAN SRC Correlation ID Resulting API UPDATE_SESSION_FROM_WALLET Response Resulting API AUTHORIZE or PAY Response
Mastercard xxx0008 261af700-e576-43bf-af92-bd0f6810e8fb
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=520424xxxxxx5996-Token
  • sourceOfFunds.provided.card.expiry.month=11-Token Expiry
  • sourceOfFunds.provided.card.expiry.year=22-Token Expiry
  • sourceOfFunds.provided.card.securityCode=xxx-Dynamic CSC
  • sourceOfFunds.provided.card.maskedFpan=512345xxxxxx0008-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=5-FPAN Expiry
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=21-FPAN Expiry

Shipping Address

  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2 = Floor 14, CBD
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=222300xxxxxx0007-FPAN
  • sourceOfFunds.provided.card.expiry.month=5-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=11-FPAN Expiry
  • sourceOfFunds.provided.card.deviceSpecificNumber=520424xxxxxx5996-Token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=11-Token Expiry
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=22-Token Expiry

Shipping Address

  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd, O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street, Floor 14, CBD
Visa xxx0002 12345671-visaDTVV-expiry0822-colShiptrue
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=453224xxxxxx4198-Token
  • sourceOfFunds.provided.card.expiry.month=8-Token Expiry
  • sourceOfFunds.provided.card.expiry.year=22-Token Expiry
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith
  • sourceOfFunds.provided.card.securityCode=xxx-Dynamic CSC
  • sourceOfFunds.provided.card.devicePayment.3DSecure.eciIndicator=07
  • sourceOfFunds.card.maskedFpan=444411xxxxxx3333-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=8-FPAN Expiry
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=22-FPAN Expiry

Shipping Address

  • shipping.address.contact.firstName=Tony
  • shipping.address.contact.lastName=Tyre
  • shipping.address.street=Level 42
  • shipping.address.street2=O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=4000
  • shipping.address.country=AUS

Customer Details

  • customer.email=emulator@tnsi.com
  • customer.firstName=Mr.John Smith
  • customer.lastName=John
  • customer.mobilePhone=+61 0444111222
  • customer.phone=+61 0444111222

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2=Floor 21
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=444411xxxxxx3333-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.month=8-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=22-FPAN Expiry
  • sourceOfFunds.provoded.card.nameOnCard=Mr. John Smith
  • sourceOfFunds.provided.card.deviceSpecificNumber=520424xxxxxx5996-Token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=8-Token Expiry
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=22-Token Expiry

Shipping Address

  • shipping.address.contact.firstName=tony
  • shipping.address.contact.lastName=tyre
  • sshipping.address.street=Level 42, 700 Somewhere Street
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=AUS

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
  • customer.phone=+61 0444111222

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street, Floor 14, CBD
American Express xxx0017 cf3de1e0-55a2-44cf-9563-5ef9e648c492
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=AMEX
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=453224xxxxxx4198-Token
  • sourceOfFunds.provided.card.expiry.month=12-Token Expiry
  • sourceOfFunds.provided.card.expiry.year=22-Token Expiry
  • sourceOfFunds.provided.card.securityCode=xxx-Dynamic CSC
  • sourceOfFunds.card.maskedFpan=444411xxxxxx3333-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=8-FPAN Expiry
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=22-FPAN Expiry

Shipping Address

  • shipping.address.contact.firstName=loggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=4000
  • shipping.address.country=USA

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=Mr.John Smith
  • customer.lastName=John
  • customer.mobilePhone=+61 0444111222

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2=Floor 14
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=AMES
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=444411xxxxxx3333-FPAN
  • sourceOfFunds.provided.card.expiry.month=5-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=21-FPAN Expiry
  • sourceOfFunds.provided.card.deviceSpecificNumber=520424xxxxxx5996-Token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=12-Token Expiry
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=22-Token Expiry

Shipping Address

  • shipping.address.contact.firstName=laggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=AUS

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street, Floor 14, CBD
Scenario: SRC Returns the Card Number and Card expiry date (card does not support network tokenization)
Scheme Last 4 digits of FPAN SRC Correlation ID Resulting API UPDATE_SESSION_FROM_WALLET Response Resulting API AUTHORIZE or PAY Response
Mastercard xxx0305 8e455e8b-4e52-46cf-a3da-83aa3cf9a76e
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=550690xxxxxx0305-FPAN
  • sourceOfFunds.provided.card.expiry.month=5-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=21-FPAN Expiry
  • sourceOfFunds.provided.card.nameOnCard=John Smith
  • sourceOfFunds.provided.card.maskedFpan=550690xxxxxx0305-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=5-FPAN Expiry
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=21-FPAN Expiry

Shipping Address

  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2 = Floor 14, CBD
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=550690xxxxxx0305-FPAN -FPAN
  • sourceOfFunds.provided.card.expiry.month=5-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=11-FPAN Expiry
  • sourceOfFunds.provided.card.nameOnCard=John Smith

Shipping Address

  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd, O'Fallon, extended address
  • shipping.address.street2=O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street, Floor 14, CBD
Visa xxx0001 12345671-visa1-expiry0822
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=400552xxxxxx4821-FPAN
  • sourceOfFunds.provided.card.expiry.month=8-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=22-FPAN Expiry
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith
  • sourceOfFunds.card.maskedFpan=444411xxxxxx3333-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=8-FPAN Expiry
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=22-FPAN Expiry

Customer Details

  • customer.email=emulator@tnsi.com
  • customer.firstName=Mr.John Smith
  • customer.lastName=John
  • customer.mobilePhone=+61 0444111222
  • customer.phone=+61 0444111222

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2=Floor 21
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=444411xxxxxx3333-FPAN
  • sourceOfFunds.provided.card.expiry.month=8-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=22-FPAN Expiry
  • sourceOfFunds.provoded.card.nameOnCard=Mr. John Smith

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
  • customer.phone=+61 0444111222

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street=300 Adelaide Street, Floor 21
American Express xxx4564 bb978084-42b7-4985-af9d-2e41ee0a370c
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=AMEX
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=345678xxxxx4564-FPAN
  • sourceOfFunds.provided.card.expiry.month=12-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=22-FPAN Expiry
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith
  • sourceOfFunds.provided.card.maskedFpan=345678xxxxx4564-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=8-FPAN Expiry
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=21-FPAN Expiry

Shipping Address

  • shipping.address.contact.firstName=loggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=4000
  • shipping.address.country=USA

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=Mr.John Smith
  • customer.lastName=John
  • customer.mobilePhone=+61 0444111222

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2=Floor 14
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=AMEX
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=444411xxxxxx3333-FPAN
  • sourceOfFunds.provided.card.expiry.month=5-FPAN Expiry
  • sourceOfFunds.provided.card.expiry.year=21-FPAN Expiry

Shipping Address

  • shipping.address.contact.firstName=laggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, extended address
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=AUS

Customer Details

  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234

Billing Address

  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street, Floor 14, CBD

Testing SRC with 3-D Secure Authentication

If your merchant profile is enabled for EMV 3-D Secure Authentication (3DS2) you can use the SRC test details shown in the table below to trigger either a frictionless flow or a challenge flow.

Scenario: 3DS2 Challenge Flow
Scheme Last 4 digits of FPAN SRC Correlation ID Resulting API Response
Mastercard xxx0009 1049624e-cc67-45f6-bd5f-c625eb4c6cc1
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.deviceSpecificNumber = 512345xxxxxx8212
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month = 5
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year = 21
  • sourceOfFunds.provided.card.number = 512345xxxxxx0009
  • sourceOfFunds.provided.card.expiry.month = 9
  • sourceOfFunds.provided.card.expiry.year = 55
Visa xxx4222 12312345671-SRC3DSChallenge-expiry0822-colShiptrue
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type = SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme = VISA
  • sourceOfFunds.provided.card.brand= VISA
  • sourceOfFunds.provided.card.devicePayment.3DSecure.eciIndicator=07
  • sourceOfFunds.provided.card.devicePayment.3DSecure.onlinePaymentCryptogram=AgAAAAAABkwdwbyAkpPMQAAAAAA=
  • sourceOfFunds.provided.card.number = 453224xxxxxx4222
  • sourceOfFunds.provided.card.expiry.month = 8
  • ssourceOfFunds.provided.card.expiry.year = 22
American Express xxx0017 16e051bc-bd25-46db-a7d3-d2944fbb05cf
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type = SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme = AMEX
  • sourceOfFunds.provided.card.brand= AMEX
  • sourceOfFunds.provided.card.deviceSpecificNumber = 373224xxxxx9117
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month = 5
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year = 21
  • sourceOfFunds.provided.card.number = 373224xxxxxx4570
  • sourceOfFunds.provided.card.expiry.month = 8
  • ssourceOfFunds.provided.card.expiry.year = 22
Scenario: 3DS2 Frictionless Flow
Scheme Last 4 digits of FPAN SRC Correlation ID Resulting API Response
Mastercard xxx0010 16e051bc-bd25-46db-a7d3-d2944fbb05cf
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.deviceSpecificNumber = 512345xxxxxx8170
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month = 5
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year = 21
  • sourceOfFunds.provided.card.number = 512345xxxxxx0010
  • sourceOfFunds.provided.card.expiry.month = 8
  • sourceOfFunds.provided.card.expiry.year = 55
Visa xxx4180 12345671-SRC3DSFrictionless-expiry0822-colShiptrue
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type = SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme = VISA
  • sourceOfFunds.provided.card.brand= VISA
  • sourceOfFunds.provided.card.devicePayment.3DSecure.eciIndicator=07
  • sourceOfFunds.provided.card.devicePayment.3DSecure.onlinePaymentCryptogram=AgAAAAAABkwdwbyAkpPMQAAAAAA=
  • sourceOfFunds.provided.card.number = 453224xxxxxx4180
  • sourceOfFunds.provided.card.expiry.month = 8
  • ssourceOfFunds.provided.card.expiry.year = 22
American Express xxx4564 17e051bc-bd25-46db-a7d3-d2944fbb05cf
  • order.walletProvider=SECURE_REMOTE_COMMERCE
  • sourceOfFunds.type = SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme = AMEX
  • sourceOfFunds.provided.card.brand= AMEX
  • sourceOfFunds.provided.card.deviceSpecificNumber = 373224xxxxx9299
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month = 5
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year = 21
  • sourceOfFunds.provided.card.securityCode = xxx
  • sourceOfFunds.provided.card.number = 373224xxxxxx4570
  • sourceOfFunds.provided.card.expiry.month = 5
  • ssourceOfFunds.provided.card.expiry.year = 21

Frequently Asked Questions

As a payer, I've added a card to my Click To Pay wallet. Why doesn't it appear on the checkout page?

While your payer's Click to Pay profile itself can contain cards for any supported card schemes, for a given transaction your payer can only use Click to Pay for those cards where:

  • The card scheme has been activated for SRC on your merchant profile, and
  • Your merchant profile is configured to process cards with this scheme and the transaction currency.  

Is End to End testing available with Click To Pay?

Currently, End to End testing is not supported with Click To Pay. Merchants are able to test with live merchants in MTF for the Click To Pay interaction only.  

Copyright © 2023 Suncorp