Page History

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. 

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 

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. 

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