Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space ENWORK and version Documentation

schemeReferenceID

Table Excerpt
nameschemeReferenceID
KeyFormatCNDDescriptionBeschreibung
schemeReferenceID

ans..64

C

Card scheme specific transaction ID required for subsequent credential-on-file payments, delayed authorizations and resubmissions.

Mandatory: CredentialOnFile – initial false – unscheduled MIT / recurring

schemeReferenceID is returned for 3DS2-payments. In case of fallback to 3DS1 you will also need to check for TransactionId.

The schemeReferenceID is a unique identifier generated by the card brands and as a rule

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePartner-Name
PageWithExcerptWording
merchants can continue to use the SchemeReferenceIDs for subscription plans that were created while using another PSP environment /
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
MerchantID / Acquirer ContractID / Acquirer.

Spezifische Transaktions-ID des Kartenschemas, die für nachfolgende Zahlungen mit gespeicherten Zugangsdaten, verzögerte Autorisierungen und Wiedereinreichungen erforderlich ist.

Pflicht: CredentialOnFile – initial false – unschedule MIT / recurring

schemeReferenceID wird bei 3DS2-Zahlungsvorgängen zurückgegeben. Bei einem Fallback auf 3DS1 prüfen Sie bitte zusätzlich auf TransactionId.

Die SchemeReferenceID ist eine eindeutige Kennung, die von den Kartenmarken generiert wird. In der Regel können

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptDE:Wording
-Händler die SchemeReferenceIDs für Abonnements übergreifend verwenden, welche unter Verwendung eines anderen PSP / separater
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptDE:Wording
-MerchantID / separater Acquirer ContractID / Acquirer erstellt wurden.

schemeReferenceID_REST

Table Excerpt
nameschemeReferenceID_REST
KeyRESTFormatCNDDescriptionBeschreibung
schemeReferenceID"payment": {"card": { "schemeReferenceId": "..." }}

ans..64

C

Card scheme specific transaction ID required for subsequent credential-on-file payments, delayed authorizations and resubmissions.

Mandatory: CredentialOnFile – initial false – unscheduled MIT / recurring

schemeReferenceID is returned for 3DS2-payments. In case of fallback to 3DS1 you will also need to check for TransactionId.

The schemeReferenceID is a unique identifier generated by the card brands and as a rule

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePartner-Name
PageWithExcerptWording
merchants can continue to use the SchemeReferenceIDs for subscription plans that were created while using another PSP environment /
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
MerchantID / Acquirer ContractID / Acquirer.

Spezifische Transaktions-ID des Kartenschemas, die für nachfolgende Zahlungen mit gespeicherten Zugangsdaten, verzögerte Autorisierungen und Wiedereinreichungen erforderlich ist.

Pflicht: CredentialOnFile – initial false – unschedule MIT / recurring

schemeReferenceID wird bei 3DS2-Zahlungsvorgängen zurückgegeben. Bei einem Fallback auf 3DS1 prüfen Sie bitte zusätzlich auf TransactionId.

Die SchemeReferenceID ist eine eindeutige Kennung, die von den Kartenmarken generiert wird. In der Regel können

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptDE:Wording
-Händler die SchemeReferenceIDs für Abonnements übergreifend verwenden, welche unter Verwendung eines anderen PSP / separater
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptDE:Wording
-MerchantID / separater Acquirer ContractID / Acquirer erstellt wurden.

Table of Contents

English

Multiexcerpt
MultiExcerptNameEN
shouldDisplayInlineCommentsInIncludesfalse
Important note: dummy SchemereferenceIDs expire end of October 2022

If you as a merchant still use the dummy SchemereferenceIDs issued by the card brands, these must be converted / updated by 01.11.2022.

This means that your customers must be requested to update their card data and, in addition, a 3DS authentication is mandatory. For this process the following options are available to you, which you can send to your customer by creating a payment link or customers are requested to do so in the shop via a separate function.

Transaction including reservation of an invoice amount X

If you want to update/convert to a valid SchemereferenceID during a regular payment, i.e. the customer should also be charged for an amount X, use the standard credit card interfaces (...payssl.aspx or ...paynow.aspx).
Important here is that the JSON object credentialOnFile must be initialized as CIT and initial=true. This makes a 3DS challenge mandatory and the SchemereferenceID is generated based on this and can be used as MIT for further subsequent collections. 

Card verification - 0.00€ transaction

If you want to update/convert to a valid SchemereferenceID for an account verification (check the card data at the bank with a 0.00€ transaction), please also use the standard credit card interfaces (...payssl.aspx or ...paynow.aspx). Here also it is important that the transaction is initialized with the JSON object credentialOnFile as CIT and initial=true. This makes a 3DS challenge mandatory and the SchemereferenceID is generated based on this and can be used as MIT for further subsequent collections.

In addition, in this case please also send the key value pair parameter AccVerify, this will trigger a 0.00 transaction downstream.

Common information

The SchemereferenceID is a unique transaction identifier provided directly from the card schemes like VISA and MC in order to uniquely reference a transaction in the whole payment ecosystem. It was introduced initially by VISA in accordance to their Framework specifications like COF (Credential On File) and MIT (Merchant Initiated Transactions), relevant to use cases involving transaction types such as Recurring, UCOF (MIT), Incremental, Delayed Authorization, Resubmission etc.

With the release of EMV 3DS specifications it came as a requirement also for MasterCard to make use of such a unique identifier which they called “traceID” or “grandfathering ID”. The logic behind it, is that the Issuer could rely on this identifier to link the initial payment with all the subsequent ones related to a standing order in a COF or MIT regime. This will allow the Issuer to apply different transaction rules (i.e. no CVV/CVC, no additional authentication in EMV 3DS) for all the subsequent payments.

In the current situation for Mastercard/Maestro transactions on which the initial payment (Establishment of an Agreement) has been put in place prior to enforcement date of the regulation, merchants have not been provided with the “schemeReferenceID” in authorization responses. 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePartner-Name
PageWithExcerptWording
will require those merchants dealing with the above use cases to align with their acquirer on the usage of the card-scheme approved static value "grandfathering" in all the subsequent (COF/MIT) transactions.


For Initial payments (Establishment of an Agreement) after enforcement date of the PSD2 regulation the merchants
must save the “schemeReferenceID” value provided in the response and submit it to 

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
in all the subsequent payments related to that Initial agreement. As for VISA the “schemeReferenceID” will be the equivalent of the previous 
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
parameter “TransactionID” that the merchants are currently submitting in accordance to COF & MIT Frameworks.


Info

If you have older card tokens for which no schemeReferenceID was recorded, we recommend using the following placeholders for subsequent transactions::
VISA: 887001863998888
MasterCard: 1231_MCC999999

(info) These values are valid until October 2022, combined with the 3DSecure 1.0 deactivation. 

If a subsequent transaction should also fail with the placeholder schemeReferenceID, an initial transaction must be carried out again in the presence of the customer in order to receive a schemeReferenceID.


Deutsch

Multiexcerpt
MultiExcerptNameDE
shouldDisplayInlineCommentsInIncludesfalse
Wichtige Information: Dummy SchemereferenceIDs laufen zu Ende Oktober 2022 ab

Nutzen sie als Händler noch die von den Kartenmarken ausgegebenen dummy SchemereferenceIDs, müssen diese zum 01.11.2022 umgestellt / aktualisiert werden.

Das bedeutet für sie, dass ihre Kunden aufgefordert werden müssen ihre Kartendaten zu aktualisieren und zusätzlich ist eine 3DS Authentifizierung verpflichtend. Für diesen Prozess stehen ihnen die nachfolgenden Möglichkeiten zur Verfügung, welche Sie durch die Erstellung eines Payment Links an die Kunden geben können oder Kunden werden im Shop über eine separate Funktion dazu aufgefordert.

Transaktion inkl. Reservierung eines Rechnungsbetrag X

Möchten Sie die Aktualisierung/Umstellung auf eine gültige SchemereferenceID während eines regulären Payments durchführen, d.h. der Kunde soll über einen Betrag X auch belastet werden, nutzen Sie hierfür die Standard Kreditkartenschnittstellen (...payssl.aspx oder auch ...paynow.aspx).

Wichtig hierbei ist, dass das JSON Objekt credentialOnFile als CIT + initial=true initialisiert werden muss. Dadurch ist eine 3DS-Challenge verpflichtend und die SchemereferenceID wird basierend darauf generiert und kann für weitere Folgeeinzüge als MIT verwendet werden.

Kartenverifikation - 0.00€ Transaktion

Möchten Sie die Aktualisierung/Umstellung auf eine gültige SchemereferenceID als Account Verifikation (Prüfung der Kartendaten bei der Bank mit einer 0.00€ Transaktion) durchführen, nutzen Sie hierfür bitte auch die Standard Kreditkartenschnittstellen (...payssl.aspx oder auch ...paynow.aspx).

Auch hier ist es wichtig das die Transaktion mit dem JSON Objekt credentialOnFile als CIT + initial=true initialisiert wird. Dadurch ist eine 3DS-Challenge verpflichtend und die SchemereferenceID wird basierend darauf generiert und kann für weitere Folgeeinzüge als MIT verwendet werden.
Zusätzlich senden Sie in in diesem Fall bitte den weitere Key-Value-Parameter AccVerify mit, dadurch wird nachgelagert eine 0.00 Transaktion ausgelöst.

Allgemeine Information

Die SchemereferenceID ist eine eindeutige direkt von den Kartensystemen wie VISA und MC bereitgestellte Transaktions-ID, um eine Transaktion im gesamten Zahlungs-Ökosystem eindeutig zu referenzieren. Sie wurde anfänglich von VISA gemäß deren Framework-Spezifikationen wie COF (Credential On File) und MIT (Merchant Initiated Transactions) eingeführt und ist relevant für Anwendungsfälle mit Transaktionsarten wie Wiederkehrend, UCOF (MIT), Inkrementell, Verzögerte Autorisierung, Wiedervorlage usw.

Mit der Veröffentlichung der EMV 3DS-Spezifikationen entstand auch für MasterCard die Anforderung, eine derartige eindeutige ID zu verwenden, welche sie “traceID” oder “grandfathering ID” nannten. Die Logik dahinter ist, dass sich der Issuer auf diese ID verlassen kann, um die anfängliche Zahlung mit allen nachfolgenden zu verknüpfen, die sich in einem Dauerauftrag in in einem COF- oder MIT-Regime darauf beziehen. Das ermöglicht dem Issuer, für alle nachfolgenden Zahlungen abweichende Transakationsregeln anzuwenden (d.h. kein CVV/CVC, keine zusätzlichen Authentisierung in EMV 3DS).

In der derzeitigen Situation wurde den Händlern für Mastercard/Maestro-Transaktionen, bei denen die anfängliche Zahlung (Einrichtung einer Vereinbarung) vor dem Inkrafttreten der Regulierung erfolgt ist, in den Autorisierungsantworten keine “schemeReferenceID” bereitgestellt. 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptDE:Wording
fordert von jenen Händlern, die diese Anwendungsfälle betreffen, sich bei diesem Parameter bei allen nachfolgenden (COF/MIT) Transaktionen mit ihrem Acquirer über die Verwendung des vom Kartenschemes genehmigten statischen Wertes "Grandfathering" abzustimmen.


Bei anfänglichen Zahlungen (Einrichtung einer Vereinbarung) nach Inkrafttreten der PSD2-Regulierung müssen die Händler den in der Antwort als “schemeReferenceID” bereitgestellten Wert speichern und in allen nachfolgenden Zahlungen, die sich auf diese anfängliche Vereinbarung beziehen, an das 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptDE:Wording
übermitteln. Bei VISA ist die “schemeReferenceID” äquivalent zum vorherigen
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptDE:Wording
-Parameter “TransactionID”, den die Händler derzeit gemäß COF & MIT Frameworks übermitteln.


Info

Sollten Ihnen ältere Kartentoken vorliegen, bei denen keine schemeReferenceID erfasst wurde, empfehlen wir die Verwendung der folgenden Platzhalter bei Folgetransaktionen:
VISA: 887001863998888
MasterCard: 1231_MCC999999

(info) Diese Werte sind gültig bis Oktober 2022 kombiniert mit der Deaktivierung von 3DSecure 1.0.

Sollte eine Folgetransaktion auch mit Platzhalter-schemeReferenceID fehlschlagen, muss erneut eine initiale Transaktion im Beisein des Kunden durchgeführt werden, um eine schemeReferenceID zu erhalten.