SCHEMEUPDATE

A Kartensystemaktualisierung (SCHEMEUPDATE) ist eine Anfrage, die Ihr System in den Tagen vor einer wiederkehrenden Zahlung manuell über unsere Webservices API an Trust Payments senden kann, um zu prüfen, ob die gespeicherten Zahlungsinformationen des Kunden noch aktuell sind. Im Rahmen dieses Prozesses kontaktieren wir die Systeme Visa Account Updater (VAU) und Mastercard's Automatic Billing Updater (ABU), um nach Aktualisierungen zu suchen und alle aktualisierten Zahlungsdaten auf unseren sicheren Servern für zukünftige Zahlungen zu speichern.

Voraussetzungen

• Wir unterstützen sowohl Visa Account Updater (VAU) als auch Mastercard's Automatic Billing Updater (ABU) Systeme. Daher unterstützt die Anfrage Kartensystemaktualisierung alle Karten der Marken Mastercard und Visa.
• Die Karte Kartensystemaktualisierungen wird nur von teilnehmenden Kartenherausgebern unterstützt. Wenn sich der Kartenaussteller nicht an Visa oder Mastercard wendet, um bei der Ausgabe einer neuen Karte die aktualisierten Zahlungsdaten mitzuteilen, können wir die aktualisierten Zahlungsdaten nicht erfolgreich abrufen.
• Falls Sie dies noch nicht getan haben, müssen Sie sich vor der Implementierung von Kartensystemaktualisierungen mit unserem Support-Team in Verbindung setzen. Sie können Ihnen dabei helfen, herauszufinden, ob wir Kartensystemaktualisierungen für Ihre Acquiring-Bank unterstützen, und dann die Funktionalität auf Ihrer Website-Referenz aktivieren.
• Wenn Sie Kartensystemaktualisierungen aktivieren, wird unser Support-Team auch Benachrichtigungen konfigurieren, die die Ergebnisse der Kartensystemaktualisierung Prüfungen an Ihr System zurücksenden (wir erläutern diese später in diesem Dokument genauer):
  • E-Mail-Berichte - Wir senden eine E-Mail an eine von Ihnen gewählte Adresse, die eine Tabelle mit den Ergebnissen von Kartensystemaktualisierungen enthält, die in den letzten 24 Stunden bei Trust Payments eingegangen sind.
  • URL-Benachrichtigungen - Ihr System erhält eine URL-Benachrichtigung für jede Kartensystemaktualisierung, die alle aktualisierten Zahlungsdaten enthält.

Überblick über den Prozess

1. Bevor Sie eine neue wiederkehrende Zahlung verarbeiten können, muss Ihr System manuell eine SCHEMEUPDATE Anfrage an Trust Payments über unsere Webservices API senden und die zurückgegebene Antwort überprüfen.

2. Wir setzen uns mit Visa oder Mastercard in Verbindung und prüfen, ob die Zahlungsdaten des Kunden aktuell sind.
3. Visa oder Mastercard liefert Informationen über den Status der Zahlungsdaten des Kunden, die wir über URL-Benachrichtigung an Ihr System weiterleiten. Wir speichern die aktualisierte Zahlungsart, die Kartennummer und das Ablaufdatum. Diese Angaben werden über URL-Benachrichtigung an Ihr System zurückgegeben (die Kartennummer wird aus Sicherheitsgründen maskiert).

1. Einreichen der Kartensystemaktualisierung

Ihr System übermittelt manuell eine Anfrage an SCHEMEUPDATE und analysiert und interpretiert dann die zurückgegebene Antwort.

SCHEMEUPDATE Beispiel anfordern

#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

schemeupdate = {
  "sitereference": "test_site12345",
  "requesttypedescriptions": ["SCHEMEUPDATE"],
  "parenttransactionreference": "23-9-80000"
}

strequest = securetrading.Request()
strequest.update(schemeupdate)
stresponse = st.process(strequest) #stresponse contains the transaction response

<?php

if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
throw new Exception('Composer autoloader file could not be found.');
}
require_once($autoload);

$configData = array(
  'username' => 'webservices@example.com',
  'password' => 'Password1^',
);

$requestData = array(
  'sitereference' => 'test_site12345', 
  'requesttypedescriptions' => array('SCHEMEUPDATE'),
  'parenttransactionreference' => '23-9-80000'
);

$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());

?>

curl --user webservices@example.com:Password1^ <DOMAIN>/json/ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
  "alias":"webservices@example.com",
  "version": "1.00",
  "request": [{
    "sitereference": "test_site12345",
    "requesttypedescriptions": ["SCHEMEUPDATE"],
    "parenttransactionreference": "23-9-80000"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "sitereference":"test_site12345",
    "requesttypedescriptions":["SCHEMEUPDATE"],
    "parenttransactionreference":"23-9-80000"
  }]
}

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="SCHEMEUPDATE">
    <operation>
      <parenttransactionreference>23-9-80000</parenttransactionreference>
      <sitereference>test_site12345</sitereference>
    </operation>
  </request>
</requestblock>

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.

Feldspezifikation

	Feld	Format	Beschreibung
	parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Sie müssen die Transaktionsnummer der ursprünglichen AUTH Transaktion einreichen (die "übergeordnete" Anfrage, wie im Dokument für wiederkehrende Zahlungen beschrieben). Wir übernehmen die gespeicherten Zahlungsdaten aus dieser Transaktion und senden diese an das jeweilige Kartensystem, um zu prüfen, ob es Aktualisierungen gegeben hat.
	requesttypedescriptions XPath: /@type	Alpha (20)	Sie müssen "SCHEMEUPDATE" eingeben, wie im Beispiel des Antrags gezeigt.
	sitereference XPath: /operation/sitereference	Alphanumerisch & Unterstrich (50)	Die Website-Referenz bezieht sich auf Ihr individuelles Konto, das Sie bei der Einrichtung erhalten haben. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

SCHEMEUPDATE Antwortbeispiel

{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'transactionstartedtimestamp': u '2018-11-28 11:18:01',
u 'parenttransactionreference': u '72-9-80001',
u 'credentialsonfile': u '1',
u 'livestatus': u '0',
u 'merchantcategorycode': u '0000',
u 'issuer': u 'Test Issuer',
u 'dccenabled': u '0',
u 'settleduedate': u '2018-11-28',
u 'errorcode': u '0',
u 'tid': u '27882788',
u 'merchantnumber': u '00000000',
u 'merchantcountryiso2a': u 'GB',
u 'transactionreference': u '72-9-80002',
u 'merchantname': u 'Test Merchant',
u 'paymenttypedescription': u 'VISA',
u 'baseamount': u '100',
u 'accounttypedescription': u 'ECOM',
u 'requesttypedescription': u 'SCHEMEUPDATE',
u 'currencyiso3a': u 'GBP',
u 'maskedpan': u '411111######1111',
u 'errormessage': u 'Ok',
u 'issuercountryiso2a': u 'US',
u 'settlestatus': u '0'
}]
}

array(3) {
  ["requestreference"] => string(9) "A3579dkvx"
  ["version"] => string(4) "1.00"
  ["responses"] => array(1) {
    [0] => array(23) {
      ["transactionstartedtimestamp"] => string(19) "2018-11-28 11:18:01"
      ["parenttransactionreference"] => string(10) "72-9-80001"
      ["credentialsonfile"] => string(1) "1"
      ["livestatus"] => string(1) "0"
      ["merchantcategorycode"] => string(4) "0000"
      ["issuer"] => string(16) "Test Issuer"
      ["dccenabled"] => string(1) "0"
      ["settleduedate"] => string(10) "2018-11-28"
      ["errorcode"] => string(1) "0"
      ["tid"] => string(8) "27882788"
      ["merchantnumber"] => string(8) "00000000"
      ["merchantcountryiso2a"] => string(2) "GB"
      ["transactionreference"] => string(10) "72-9-80002"
      ["merchantname"] => string(13) "Test Merchant"
      ["paymenttypedescription"] => string(4) "VISA"
      ["baseamount"] => string(3) "100"
      ["accounttypedescription"] => string(4) "ECOM"
      ["requesttypedescription"] => string(12) "SCHEMEUPDATE"
      ["currencyiso3a"] => string(3) "GBP"
      ["maskedpan"] => string(16) "411111######1111"
      ["errormessage"] => string(2) "Ok"
      ["issuercountryiso2a"] => string(2) "US"
      ["settlestatus"] => string(1) "0"
    }
  }
}

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "transactionstartedtimestamp":"2018-11-28 11:18:01",
    "parenttransactionreference":"72-9-80001",
    "credentialsonfile":"1",
    "livestatus":"0",
    "merchantcategorycode":"0000",
    "issuer":"SecureTrading Test Issuer1",
    "dccenabled":"0",
    "settleduedate":"2018-11-28",
    "errorcode":"0",
    "tid":"27882788",
    "merchantnumber":"00000000",
    "merchantcountryiso2a":"GB",
    "transactionreference":"72-9-80002",
    "merchantname":"Test Merchant",
    "paymenttypedescription":"VISA",
    "baseamount":"100",
    "accounttypedescription":"ECOM",
    "requesttypedescription":"SCHEMEUPDATE",
    "currencyiso3a":"GBP",
    "maskedpan":"411111######1111",
    "errormessage":"Ok",
    "issuercountryiso2a":"US",
    "settlestatus":"0"
  }],
  "secrand":"zO9"
}

<responseblock version="3.67">
  <requestreference>X12345</requestreference>
  <response type="SCHEMEUPDATE">
    <merchant>
      <merchantcategorycode>0000</merchantcategorycode>
      <tid>00000000</tid>
      <merchantnumber>00000000</merchantnumber>
      <merchantcountryiso2a>GB</merchantcountryiso2a>
      <merchantname>Merchant test site</merchantname>
    </merchant>
    <transactionreference>72-5-118</transactionreference>
    <billing>
      <amount currencycode="GBP">1234</amount>
      <payment type="VISA">
        <pan>411111######0211</pan>
        <issuercountry>ZZ</issuercountry>
        <issuer>Test Issuer</issuer>
      </payment>
      <dcc enabled="0"/>
    </billing>
    <timestamp>2019-09-19 12:26:06</timestamp>
    <error>
      <message>Ok</message>
      <code>0</code>
    </error>
    <live>0</live>
    <operation>
      <parenttransactionreference>72-5-117</parenttransactionreference>
      <accounttypedescription>ECOM</accounttypedescription>
      <credentialsonfile>1</credentialsonfile>
    </operation>
    <settlement>
      <settleduedate>2019-09-19</settleduedate>
      <settlestatus>0</settlestatus>
    </settlement>
  </response>
  <secrand>Yb3SR5Pq</secrand>
</responseblock>

2. Trust Payments kontaktiert die Kartensysteme

• Trust Payments sammelt alle Zahlungsnachweise, für die Kartensystemaktualisierungen angefordert wurde, und übermittelt diese Angaben täglich an die Kartenorganisationen.
• Nach Übermittlung der Zahlungsdaten an die Kartensysteme werden die settlestatus der einzelnen SCHEMEUPDATE wird auf "10" aktualisiert.
• Nachdem die Kartensysteme die erforderlichen Informationen über etwaige Änderungen der Zahlungsbelege gesammelt haben, übermitteln sie die Ergebnisse ihrer Prüfungen an Trust Payments.

• Sobald wir eine Antwort von den Kartensystemen erhalten haben, wird die settlestatus der einzelnen SCHEMEUPDATE auf ihren endgültigen Stand aktualisiert:
  • "100", wenn die Prüfungen erfolgreich abgeschlossen wurden.
  • "3", wenn die Kontrollen ein Problem aufwerfen.

3. Umgang mit der Antwort

• Nach Abschluss des Vorgangs erhalten Sie eine URL-Benachrichtigung für jede eingereichte SCHEMEUPDATE Anfrage. Außerdem erhalten Sie per E-Mail tägliche Berichte mit einer Zusammenfassung der Ergebnisse von Kartensystemaktualisierungen . Siehe unten für weitere Details.
• Wenn die settlestatus der SCHEMEUPDATE auf "100" aktualisiert wurde, bedeutet dies, dass die Prüfungen erfolgreich durchgeführt wurden, und wenn die Zahlungsnachweise aktualisiert wurden, werden unsere eigenen Aufzeichnungen aktualisiert, um immer die neuesten Informationen für alle zukünftigen geplanten Zahlungen zu verwenden.
• Wenn die settlestatus stattdessen auf "3" aktualisiert wurde, bedeutet dies, dass die Prüfungen von Kartensystemaktualisierung ein Problem aufgeworfen haben, das vor der Verarbeitung weiterer wiederkehrender Zahlungen mit dem Kunden behoben werden muss. Ihr System sollte die folgenden zusätzlichen Prüfungen durchführen:
  • Wenn die settlestatus ist "3" und die errorcode als "70000" angezeigt wird, bedeutet dies, dass das Kartensystem eine Anfrage des Kunden erhalten hat, weitere wiederkehrende Zahlungen einzustellen. Sie müssen davon absehen, weitere wiederkehrende Zahlungen in dieser Reihenfolge zu verarbeiten. Wir empfehlen Ihnen, sich mit dem Kunden in Verbindung zu setzen, um die Situation zu klären.
  • Wenn die settlestatus ist "3" und die errorcode ist nicht "70000", so ist bei der Durchführung der Prüfungen ein Problem aufgetreten, das eine manuelle Untersuchung erfordert. Sie müssen unsere Liste der Fehlercodes heranziehen, um die Ursache des Fehlers zu ermitteln und die Antwort entsprechend zu bearbeiten.

• Alle zukünftigen wiederkehrenden Zahlungen, die von der ursprünglichen übergeordneten Transaktion in der Anfrage SCHEMEUPDATE verarbeitet werden, verwenden automatisch die neuesten Zahlungsnachweise.
• Nach der Durchführung von Kartensystemaktualisierungen empfehlen wir, die wiederkehrende Zahlung innerhalb von 6 Tagen auszuführen, um die Wahrscheinlichkeit zu verringern, dass die Zahlungsnachweise aktualisiert werden, bevor die letzten Zahlungen verarbeitet werden.

Über Benachrichtigungen

Die Ergebnisse der Prüfungen von Kartensystemaktualisierung werden über Benachrichtigungen an Ihr System zurückgesendet:

URL-Benachrichtigung

Nach der Konfiguration enthält die empfangene URL-Benachrichtigung die aktualisierten Zahlungsdaten (Zahlungsart, Ablaufdatum und maskierte Kartennummer). Wurden die Zahlungsdaten nicht aktualisiert, werden die bestehenden Zahlungsdaten zurückgegeben. Sie müssen diese Benachrichtigungen analysieren und eine Antwort an Trust Payments zurücksenden. Klicken Sie hier, um mehr über URL-Benachrichtigungen zu erfahren.

E-Mail-Bericht

Nach der Aktivierung erhalten Sie eine E-Mail von no-reply@trustpayments.com für jeden Tag, an dem Trust Payments Ergebnisse für Kartensystemaktualisierung Prüfungen von Visa Account Updater (VAU) und Mastercard's Automatic Billing Updater (ABU) Systemen erhält, einschließlich aktualisierter Zahlungsdaten (Zahlungsart, Ablaufdatum und maskierte Kartennummer). Sie werden in Form einer Tabelle dargestellt. Sie erhalten maximal eine E-Mail pro Tag (wenn es keine Aktualisierungen gibt, erhalten Sie keine E-Mail).

E-Mail-Bericht über "Angehalten" Abonnements

Nach der Aktivierung erhalten Sie eine E-Mail von no-reply@trustpayments.com für jeden Tag, an dem Trust Payments von den Systemen Visa Account Updater (VAU) und Mastercard's Automatic Billing Updater (ABU) Anfragen zur Einstellung aktiver Abonnements erhält. Sie werden in Form einer Tabelle dargestellt. Sie erhalten maximal eine E-Mail pro Tag (wenn es keine Aktualisierungen gibt, erhalten Sie keine E-Mail).

Prüfung