threeDSPolicy | Computop Documents

Data Elements

Key

Format

CND

Description

skipThreeDS

string

Indicates whether and under which conditions authentication should be skipped or performed as data share only (dataOnly). By default, all transactions and SCA exemptions will be requested through EMV 3DS if not specified otherwise.

Values accepted:

thisTransaction
outOfScope
dataOnly

threeDSExemption

object

Object detailing requested SCA exemptions

challengePreference

string

Indicates the merchant's challenge preference for this transaction during 3DS authentication. Mandatory only after a Soft Decline to re-trigger the transaction with 3DS and challenge mandated. Default value noPreference.

Values accepted:

noPreference
noChallenge
requestChallenge
mandateChallenge

Note: This parameter is ignored when SCA Exemption requested (threeDSExemption parameter is present).

threeDSExemption

Key

Format

CND

Description

exemptionReason

string

Designates the type of SCA exemption (e.g. Acquirer TRA or MIT) to be applied.

Values accepted:

transactionRiskAnalysis
delegatedAuthority
lowValue
trustedBeneficiary
secureCorporatePayment

Note: Acquirer exemptions and other exemptions may be also requested through an authorization without authentication (i.e. EMV 3DS or EMV 3DS Data Only) depending on scheme specific rules.

Note: The exemption trustedBeneficiary is only valid for VISA.

merchantFraudRate

integer

Merchant fraud rate in bps taking into account all Merchant sites and card volumes, calculated as per PSD2 RTS Article 19.

The merchant fraud rate is optional and has to be calculated by the Acquirer.

The submission of this data point might be beneficial to increase the level of confidence of the ACS/issuer into the ongoing transaction. Also, Issuers may use it to decide if a merchant should be eligible for the white listing exemption.

Schema

BASEURL= https://www.computop-paygate.com/schemas

1
{
2
	"$schema": "http://json-schema.org/draft-07/schema#",
3
	"$id": "BASEURL/threeDSPolicy.json",
4
	"title": "threeDSPolicy",
5
	"description": "3DS Policy",
6
	"type": "object",
7
	"properties": {
8
		"skipThreeDS": {
9
			"type": "string",
10
			"enum": ["thisTransaction", "outOfScope", "dataOnly"] 
11
		},
12
		"threeDSExemption": {
13
			"type": "object",
14
			"properties": {
15
				"exemptionReason": {
16
					"type": "string",
17
					"enum": ["transactionRiskAnalysis", "delegatedAuthority", "lowValue", "trustedBeneficiary", "secureCorporatePayment"]
18
				},
19
				"merchantFraudRate": {
20
					"type": "integer",
21
					"minimum": 1,
22
					"maximum": 99
23
				}
24
			},
25
			"required": ["exemptionReason"],
26
			"additionalProperties": false
27
		},
28
		"challengePreference": {
29
			"type": "string",
30
			"enum": ["noPreference", "noChallenge", "requestChallenge", "mandateChallenge"] 
31
		},
32
	},
33
	"additionalProperties": false
34
}

Sample – SCA exemption request

1
{
2
	"skipThreeDS": "thisTransaction",
3
	"threeDSExemption": {
4
		"exemptionReason": "transactionRiskAnalysis",
5
		"merchantFraudRate": 4
6
	}
7
}

Sample – re-trigger after Soft Decline

1
{
2
	"challengePreference": "mandateChallenge"
3
}