3-D Secure flow

SumUp is supporting 3-D Secure payments for an additional layer of security when it comes to online transactions.

EMVCo have developed 3D Secure 2, a new authentication protocol for payment card transactions, to meet the requirements of SCA. This protocol will reduce fraud with its additional security layers, such as biometrics.

SCA (Strong Customer Authentication) is a security measure that relies on two-factor authentication to verify the identity of the consumer in a payment transaction. As a result, these factors are strictly consumer-based. SCA can combine two of the following three factors, which must be strictly independent of each other:

• Something the customer knows (e.g. Password, PIN)
• Something the customer has (e.g. Phone, Token generator)
• Something the customer is (e.g. Fingerprint, Face ID)

Each of these elements must be independent from each other, to ensure the security of others is not compromised in the event of a security breach.

How it works

For the flow to be followed, both the merchant account and the customer credit card issuer must support 3-D Secure.

The flow includes an additional step during checkout, that is shown depending on the card scheme and issuing bank.

Integration for Single Payments

To begin supporting the 3-D Secure flow, add the redirect_url parameter to your create a checkout request scheme. The parameter refers to a url where the end user is redirected once the payment processing completes.

Proceed with processing the checkout which will return a response containing necessary details for the following required step for processing the payment.

This table includes the response content, you will use to successfully redirect the end user to a challenge screen:

Parameter	Value
method	POST
url	ex. https://issuing-bank.com/acs?reqid=B69D8F090C031E959A3BB2C4D7DFE7F8F7C09B28
payload	An object containing additional parameters that have to be passed to the url parameter. The object key number can vary
param_1	A key-value pair of the payload object
...	Other key-value pairs of the payload object

One approach for accomplishing the end user redirection is through a form:

<form name="autoSubmitForm" action="https://issuing-bank.com/acs?reqid=B69D8F090C031E959A3BB2C4D7DFE7F8F7C09B28" method="POST">
    <input type="hidden" name="param_1" value="..." />
    <input type="hidden" name="param_2" value="..." />
    <input type="hidden" name="param_3" value="..." />
</form>
<script type="text/javascript">
    document.autoSubmitForm.submit();
</script>

Once the form is submitted, the end user will be redirected to their issuer’s bank authentication screen, where the end user must provide an additional authentication (e.g. a challenge token, SMS or other data). After submitting, SumUp completes the payment and the end user is redirected to the redirect_url appointed at the checkout creation, through a GET request with the corresponding checkout_id query parameter.

To confirm a checkout's status, make a GET request to the retrieve a checkout endpoint.