Data Elements

Key

Format

CND

Description

Beschreibung

1

skipThreeDS

string

O

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

Gibt an, ob und unter welchen Bedingungen die Authentisierung übersprungen werden soll oder ob lediglich eine Datenfreigabe erfolgen soll (dataOnly). Standardmäßig werden alle Transaktionen und SCA-Ausnahmen über EMV 3DS verarbeitet, sofern nicht anders angegeben.

Zulässige Werte:

thisTransaction
outOfScope
dataOnly

2

threeDSExemption

object

O

Object detailing requested SCA exemptions

Objekt, das die angeforderten SCA-Ausnahmen genauer angibt

3

challengePreference

string

C

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).

Gibt die Präferenz des Händlers für die Challenge für diese Transaktion während der 3DS-Authentisierung an. Der Parameter ist nur nach einem Soft Decline Pflicht, um die Transaktion mit 3DS und einer verpflichtenden Challange neu auszulösen. Standardwert noPreference.

Zulässige Werte:

noPreference
noChallenge
requestChallenge
mandateChallenge

Hinweis: Dieser Parameter wird ignoriert, wenn eine SCA-Ausnahme angefordert wird (Parameter threeDSExemption ist vorhanden).

Key Format CND Description Beschreibung

1

skipThreeDS

string

O

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

Gibt an, ob und unter welchen Bedingungen die Authentisierung übersprungen werden soll oder ob lediglich eine Datenfreigabe erfolgen soll (dataOnly). Standardmäßig werden alle Transaktionen und SCA-Ausnahmen über EMV 3DS verarbeitet, sofern nicht anders angegeben.

Zulässige Werte:

thisTransaction
outOfScope
dataOnly

2

threeDSExemption

object

O

Object detailing requested SCA exemptions

Objekt, das die angeforderten SCA-Ausnahmen genauer angibt

3

challengePreference

string

C

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).

Gibt die Präferenz des Händlers für die Challenge für diese Transaktion während der 3DS-Authentisierung an. Der Parameter ist nur nach einem Soft Decline Pflicht, um die Transaktion mit 3DS und einer verpflichtenden Challange neu auszulösen. Standardwert noPreference.

Zulässige Werte:

noPreference
noChallenge
requestChallenge
mandateChallenge

Hinweis: Dieser Parameter wird ignoriert, wenn eine SCA-Ausnahme angefordert wird (Parameter threeDSExemption ist vorhanden).

threeDSExemption

Key

Format

CND

Description

Beschreibung

1

exemptionReason

string

M

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.

Bezeichnet die Art der SCA-Ausnahme (z.B. Acquirer TRA oder MIT), die anzuwenden ist.

Zulässige Werte:

transactionRiskAnalysis
delegatedAuthority
lowValue
trustedBeneficiary
secureCorporatePayment

Hinweis: Beachten Sie bitte, dass Acquirer-Ausnahmen und andere Ausnahmen je nach Scheme-spezifischen Regeln auch durch eine Autorisierung ohne Authentifizierung angefordert werden können (d. h. EMV 3DS oder EMV 3DS Data Only).

Hinweis: Die Ausnahme trustedBeneficiary gilt nur für VISA.

2

merchantFraudRate

integer

O

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.

Die Händler-Betrugsrate in bps berücksichtigt alle Händler-Seiten und Kartenumsätze und wird nach PSD2 RTS Artikel 19 berechnet.

Die Händler-Betrugsrate ist optional und muss vom Acquirer berechnet werden.

Die Übermittlung dieses Wertes könnte vorteilhaft sein, um das Vertrauen des ACS/Issuers in die lauefende Transaktion zu erhöhen. Issuer könnten ihn auch für die Entscheidung verwenden, ob ein Händler für die Whitelist-Ausnahme in Betracht kommt.

Key Format CND Description Beschreibung

1

exemptionReason

string

M

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.

Bezeichnet die Art der SCA-Ausnahme (z.B. Acquirer TRA oder MIT), die anzuwenden ist.

Zulässige Werte:

transactionRiskAnalysis
delegatedAuthority
lowValue
trustedBeneficiary
secureCorporatePayment

Hinweis: Beachten Sie bitte, dass Acquirer-Ausnahmen und andere Ausnahmen je nach Scheme-spezifischen Regeln auch durch eine Autorisierung ohne Authentifizierung angefordert werden können (d. h. EMV 3DS oder EMV 3DS Data Only).

Hinweis: Die Ausnahme trustedBeneficiary gilt nur für VISA.

2

merchantFraudRate

integer

O

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.

Die Händler-Betrugsrate in bps berücksichtigt alle Händler-Seiten und Kartenumsätze und wird nach PSD2 RTS Artikel 19 berechnet.

Die Händler-Betrugsrate ist optional und muss vom Acquirer berechnet werden.

Die Übermittlung dieses Wertes könnte vorteilhaft sein, um das Vertrauen des ACS/Issuers in die lauefende Transaktion zu erhöhen. Issuer könnten ihn auch für die Entscheidung verwenden, ob ein Händler für die Whitelist-Ausnahme in Betracht kommt.

Schema

BASEURL= https://www.payjet-cockpit.de/schemas

{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"$id": "BASEURL/threeDSPolicy.json",
	"title": "threeDSPolicy",
	"description": "3DS Policy",
	"type": "object",
	"properties": {
		"skipThreeDS": {
			"type": "string",
			"enum": ["thisTransaction", "outOfScope", "dataOnly"] 
		},
		"threeDSExemption": {
			"type": "object",
			"properties": {
				"exemptionReason": {
					"type": "string",
					"enum": ["transactionRiskAnalysis", "delegatedAuthority", "lowValue", "trustedBeneficiary", "secureCorporatePayment"]
				},
				"merchantFraudRate": {
					"type": "integer",
					"minimum": 1,
					"maximum": 99
				}
			},
			"required": ["exemptionReason"],
			"additionalProperties": false
		},
		"challengePreference": {
			"type": "string",
			"enum": ["noPreference", "noChallenge", "requestChallenge", "mandateChallenge"] 
		},
	},
	"additionalProperties": false
}

Sample - SCA exemption request

{
	"skipThreeDS": "thisTransaction",
	"threeDSExemption": {
		"exemptionReason": "transactionRiskAnalysis",
		"merchantFraudRate": 4
	}
}

Sample - re-trigger after Soft Decline

{
	"challengePreference": "mandateChallenge"
}

1Data Elements
- 1.1threeDSExemption
2Schema
3Sample - SCA exemption request
4Sample - re-trigger after Soft Decline

Page tree

Data Elements

threeDSExemption

Schema

Sample - SCA exemption request

Sample - re-trigger after Soft Decline

About Pay-Jet

Help

Intranet Tools

Manage Language Links