JSON Objekt

threeDSPolicy

threeDSPolicy

ParameterFormatBedingungBeschreibung
skipThreeDSstringOGibt 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
threeDSExemptionobjectOObjekt, das die angeforderten SCA-Ausnahmen genauer angibt
challengePreferencestringCGibt 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

ParameterFormatBedingungBeschreibung
exemptionReasonstringMBezeichnet die Art der SCA-Ausnahme (z.B. Acquirer TRA oder MIT), die anzuwenden ist. Zulässige Werte: · transactionRiskAnalysis · delegatedAuthority · merchantInitiatedTransaction · lowValue Beachten Sie bitte, dass Acquirer-Ausnahmen und vom Händler initiierte Transaktionen (MIT) auch durch eine Autorisierung ohne Authentifizierung angefordert werden können (d. h. EMV 3DS oder EMV 3DS Data Only). Beachten Sie bitte, dass merchantInitiatedTransaction ist nur in Kombination mit credentialOnFile gültig ist.
merchantFraudRateintegerODie Händler-Betrugsrate in bps berücksichtige 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

{

        “$schema”: “http://json-schema.org/draft-07/schema#”,

        “$id”: “https://www.computop-paygate.com/schemas/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”, “merchantInitiatedTransaction”, “lowValue”]

                               },

                               “merchantFraudRate”: {

                                      “type”: “integer”,

                                      “minimum”: 1,

                                      “maximum”: 99

                               }

                       },

                       “required”: [“exemptionReason”],

                       “additionalProperties”: false

               }

        },

        “additionalProperties”: false

}

Beispiel – Anforderung SCA-Ausnahme

{

        “skipThreeDS”: “outOfScope”,

        “threeDSExemption”: {

               “exemptionReason”: “merchantInitiatedTransaction”,

               “merchantFraudRate”: 4

        }
}


Beispiel – neue Auslösung nach Soft Decline

{

    “challengePreference”: “mandateChallenge”


}