Strong Customer Authentication

Applies to: In-App Payments SDK - Android | In-App Payments SDK - iOS | Web Payments SDK | Payments API | Customers API

Learn how to use Strong Customer Authentication to verify buyers for online and in-app payments.

Use Strong Customer Authentication (SCA) with the Web Payment SDK and In-App Payments SDK to verify the buyer and reduce the chance of fraudulent transactions. SCA uses the 3D Secure (3DS) protocol and in the European Economic Area (EEA).

Currently, when paying online, customers must enter their card number, expiration date, CVV, and postal code to make a payment. Buyers are required to complete two of the three factors of authentication when initiating a payment: something they know, something they own, and something they are. For online card payments, the SCA requirements are met by implementing 3DS. For in-store payments, SCA requirements are met through the use of chip and PIN or mobile wallets. Payments without this additional authentication are declined by the cardholder's bank. Payments initiated by sellers, such as recurring transactions or mail-order/telephone order (MOTO), don't require SCA.

SCA is a standard protocol developed by a collaboration of several payment card issuers. It defines a multi-factor authentication mechanism that can be used to satisfy authentication requirements in regions wherever SCA is required.

SCA can also be used to authenticate buyers in countries where SCA isn't a requirement. In those countries, Square provides the SCA mechanism for those sellers who opt to use it. SCA creates the same buyer experience regardless of whether it's initiated from an SCA-required country. For more information about SCA, see Strong Customer Authentication FAQ.

Before Square implemented SCA for payments, a seller could be liable for payment card chargebacks for online payments. For card present payments, sellers aren't liable for fraud. With SCA, the liability for fraudulent chargebacks is shifted to the card issuer in most cases. This liability shift to the issuer occurs when the payment is authenticated through SCA and the card involved is a Mastercard, American Express, JCB, Visa, Diners Club International or UnionPay card. Any of these cards that can be saved on file with Square can also use SCA. For more information, see Charge a Card on File with SCA.

As long as verifyBuyer has been called to start the SCA flow before processing payments, most of them will be protected from fraud liability when the issuer authorized the transaction. This still applies even if the issuer is unable to support 3D Secure.

Square advises all Square developers and partners operating in the European Economic Area (EEA), including the UK, to take appropriate steps to be ready for SCA enforcement starting January 1, 2021, to avoid an increase in declined payments for European cardholders.

In the UK, banks started asking their cardholders to complete SCA, with full enforcement of the SCA requirements by March 14, 2022. Across the rest of the EEA, banks are ramping up SCA enforcement starting January 1, 2021, with a staggered ramp-up through 2021.

Square provides SCA features for the Web Payments SDK and In-App Payments SDK within Europe, where the business taking the payment and the cardholder's bank are both in the EEA.

Sellers that integrate their applications with Square APIs need to flag buyer-initiated or seller-initiated payments by using the CustomerDetails object with the Payments API CreatePayment endpoint. The CustomerDetails object accepts booleans on customer initiated payments and seller keyed-in payment details:

Developers and partners that use Square developer products (such as the Web Payments SDK, In-App Payments SDK, and Square APIs) must ensure that their applications are SCA-compliant to minimize the impact of declined payments by following these guidelines:

• If the buyer is present and initiates the payment, call Payments.verifyBuyer and set CustomerDetails.customer_initiated to true.

• If the buyer initiates the payment, but is not present (such as for a mail order / telephone only (MOTO) payment), then you don't need to call Payments.verifyBuyer, but instead set CustomerDetails.customer_initiated to true, and CustomerDetails.seller_keyed_in to true.

• If the seller initiates the payment and the buyer is not present, then you don't need to call Payments.verifyBuyer, but instead set CustomerDetails.customer_initiated to false.

Sellers that use Square Online and Square Invoices have their integrations managed by Square and don't need to flag transactions for SCA authentication.

The SCA flow is started for a buyer if their payment card meets any of the conditions listed in the Square Risk Manager Glossary. For sellers outside of regions that require SCA, Square provides a mechanism in Risk Manager to let them opt in for 3DS on a location basis. For example, a seller might have an in-person location, an in-person and online location, and an online only location. Online payments are card-not-present payments and benefit from the added security of 3DS. In this case, a seller might opt in for 3DS in those locations.

A payment card might trigger the SCA authentication flow and verify the identity of the buyer without generating a payment alert. A payment alert is only created in Risk Manager if the payment appears to be suspicious or fraudulent. Sellers in the European Union can use Risk Manager to manage potential fraud even though 3DS is enabled for them by default.

To enable SCA, a non-EU seller uses an application integrated with a Square payments SDK to take a payment with a debit or credit card. If the application called the verifyBuyer function when getting a payment token, the seller can enable SCA in Risk Manager for the location that called the function. When enabled, SCA is active until the seller disables it. SCA cannot be enabled until verifyBuyer has been called by the application at least once.

You can also configure the application to call verifyBuyer and enable other authentication mechanisms, as the buyer verification process checks if the application has any verification method to apply to the payment. Currently, SCA is the only authentication mechanism that Square supports.

Learn how SCA works by walking through the steps in the following example:

Step	Flow Illustration
1. Generate a token with the Square online payment SDK or in-app payment SDK. You can skip this step if you're charging a customer card on file.
2. Call verifyBuyer() with the payment token or the customer card ID and the transactional details. Square collects all the required device-based information.
3. Square automatically checks whether the transaction requires Strong Customer Authentication.
4. If a challenge is required, Square automatically displays the challenge to the buyer.
5. When the SCA process is complete, you get back a verification token.
6. Use the verification token along with the payment token and customer card ID to charge the customer using Square APIs, version 2019-06-12 or newer.

Implement SCA in your application to start the SCA flow by reading the following topics:

• For Web Payments SDK: Add Strong Customer Authentication to a Card Payment
• For In-App Payments SDK: Verify a Buyer