Verarbeitung von Dynamic Währung Conversion (DCC) Zahlungen über unsere API - Trust Payments

Bevor Sie fortfahren, empfehlen wir Ihnen, diese Seite zu lesen, um mehr über DCC zu erfahren.

Der folgende Prozess erfordert die Implementierung einer Lösung, die unsere Webservices API nutzt, um die Konvertierung von Währung durchzuführen und unsere JavaScript Library um die Zahlung zu verarbeiten.

Die Nutzung von Webservices API beinhaltet die direkte Verarbeitung von sensiblen Karteninhaberdaten auf Ihrem Server und unterliegt daher strengeren PCI-Compliance-Standards. Bitte stellen Sie sicher, dass Sie die erforderliche Zertifizierung erhalten haben, bevor Sie fortfahren.

Wenn Sie sich nicht sicher sind, wenden Sie sich an unser Support-Team, um Hilfe zu erhalten.

Bevor Sie fortfahren, vergewissern Sie sich bitte, dass Sie alle Voraussetzungen für die Bearbeitung erfüllt haben DCC
Klicken Sie hier, um diese Informationen in einer neuen Registerkarte zu öffnen

Dynamische Währung Umrechnung (DCC) ist eine Funktion, die es Kunden ermöglicht, die Zahlung in ihrem Währung oder Ihrem lokalen Währung abzuschließen. Die Beträge werden mithilfe eines Drittanbieters mit aktuellen Umrechnungskursen berechnet.

Überblick über den Prozess

In unserer Dokumentation DCC beziehen wir uns auf die Währung des Kunden und die Währung des Händlers. Diese sind wie folgt definiert:

Die Währung des Kunden - die Währung , die mit seiner Karte verbunden ist.
Währung des Händlers - die lokale Währung , die mit Ihrem Konto verbunden ist.

Der Zahlungsfluss von DCC kann in drei Hauptteile unterteilt werden, wie unten dargestellt:

1. CURRENCYRATE Anfrage einreichen

Ihr Kassenformular muss den Kunden zur Eingabe seiner Karten- und Rechnungsdaten auffordern (dieser Vorgang folgt dem üblichen Zahlungsablauf). Übermitteln Sie diese Angaben zusammen mit dem Transaktionsbetrag in einer CURRENCYRATE Anfrage über unsere Webservices API.

2. Empfang der Antwort CURRENCYRATE

Wir setzen uns mit Ihrem Anbieter von Umrechnungskursen in Verbindung, um den neuesten Umrechnungskurs zwischen der Währung des Kunden und der Währung des Händlers zu erhalten. Wir geben eine CURRENCYRATE Antwort zurück, die den Betrag sowohl in der Währung des Kunden als auch in der Währung des Händlers enthält.

3. Transaktion verarbeiten

Sie müssen dem Kunden dann die Wahl lassen, ob er die Währung oder die Währung des Händlers für die Zahlung verwenden möchte. Sie müssen sicherstellen, dass Ihr Kassenformular so geändert wurde, dass es auf unsere JavaScript Library verweist, und dass die payload Die in der JWT übermittelten Daten enthalten zusätzliche Felder zur durchgeführten Währung Konvertierung.

Der Kunde muss nicht mehr aufgefordert werden, auf "Bezahlen" zu klicken, wenn die JavaScript Library initialisiert wird und die Karte st.Components Methode aufgerufen wird, können Sie der Methode eine Konfiguration von {startOnLoad:true}, die sofort den Zahlungsvorgang auslöst.

Klicken Sie hier, um weitere Informationen zur Erfassung von Kartendaten mit Ihrem eigenen Formular zu erhalten.

Bitte beachten Sie die folgenden Unterscheidungen:

Wenn wir von der Währung des Kunden sprechen, beziehen wir uns auf die Währung , die mit seiner Karte verbunden ist. Dies entspricht oft dem Land, in dem die Karte ausgestellt wurde, und daher sind Ihre Kunden möglicherweise eher daran gewöhnt, Zahlungen über Währung abzuwickeln.
Wenn wir über die Währung des Händlers sprechen, ist dies die lokale Währung , die Ihrem Konto bei uns zugewiesen ist. Lokale Kunden Ihres Unternehmens sind möglicherweise eher daran gewöhnt, Zahlungen über diese Währung abzuwickeln.
Im Rahmen des DCC Prozesses müssen Sie dem Kunden vor der Zahlungsabwicklung die Wahl zwischen dem Währung und Ihrem lokalen Händler Währung lassen. Wir bezeichnen die vom Kunden gewählte Währung als die endgültige Währung.

1. CURRENCYRATE Anfrage einreichen

Die Anfrage CURRENCYRATE dient dazu, sowohl die Währung des Kunden als auch den Betrag auf der Währung des Kunden zu ermitteln.

Beispielanfrage

Im Folgenden finden Sie ein Beispiel für eine CURRENCYRATE Anfrage.

#!/usr/bin/python
import securetrading

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

currencyrate = {
  "sitereference": "test_site12345",
  "requesttypedescriptions": ["CURRENCYRATE"],
  "accounttypedescription": "CURRENCYRATE",
  "dcctype": "DCC",
  "dccbaseamount": "1050",
  "dcccurrencyiso3a": "GBP",
  "orderreference": "My_Order_123",
  "pan": "4111111111111111"
}

strequest = securetrading.Request()
strequest.update(currencyrate)
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('CURRENCYRATE'),
  'accounttypedescription' => 'CURRENCYRATE',
  'dcctype' => 'DCC',
  'dccbaseamount' => '1050',
  'dcccurrencyiso3a' => 'GBP',
  'orderreference' => 'My_Order_123',
  'pan' => '4111111111111111'
);

$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": ["CURRENCYRATE"],
    "accounttypedescription": "CURRENCYRATE",
    "dcctype": "DCC",
    "dccbaseamount": "1050",
    "dcccurrencyiso3a": "GBP",
    "orderreference": "My_Order_123",
    "pan": "4111111111111111"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "sitereference":"test_site12345",
    "requesttypedescriptions":["CURRENCYRATE"],
    "accounttypedescription":"CURRENCYRATE",
    "dcctype":"DCC",
    "dccbaseamount":"1050",
    "dcccurrencyiso3a":"GBP",
    "orderreference":"My_Order_123",
    "pan":"4111111111111111"
  }]
}

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="CURRENCYRATE">
    <operation>
      <sitereference>test_site12345</sitereference>
      <accounttypedescription>CURRENCYRATE</accounttypedescription>
    </operation>
    <merchant>
      <orderreference>My_Order_123</orderreference>
    </merchant>
    <billing>
      <dcc type="DCC">
        <amount currencycode="GBP">1050</amount>
      </dcc>
      <payment>
        <pan>4111111111111111</pan>
      </payment>
    </billing>
  </request>
</requestblock>

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

Feldspezifikation

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Diese muss als "CURRENCYRATE" eingereicht werden.
dccbaseamount XPath: /billing/dcc/amount	Numerisch (13)	Der Betrag in der Währung des Händlers. Dieser Betrag sollte in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben werden, d.h. €10 wäre 1000.
dcccurrencyiso3a XPath: /billing/dcc/amount/@currencycode	Alpha (3)	Die Seite des Händlers Währung im iso3a-Format. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
dcctype XPath: /billing/dcc/dcctype	Alpha (3)	Der angegebene Wert muss "DCC" lauten.
orderreference XPath: /merchant/orderreference	Alphanumerisch einschließlich Symbole (25) Empfohlene Länge 25 Zeichen oder weniger (genaue Länge abhängig von der erwerbenden Bank). Die Nichteinhaltung dieser Anforderung kann dazu führen, dass der Text in der Transaktion abgeschnitten wird.	Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann.
pan XPath: /billing/payment/pan	Numerisch (12-19)	Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
requesttypedescriptions XPath: /@type	Alpha (20)	Sie müssen "CURRENCYRATE" 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.

2. Empfang der Antwort CURRENCYRATE

Diese Antwort enthält den Währung und den umgerechneten Betrag des Kunden, der mit dem aktuellen Umrechnungskurs berechnet wurde.

Beispielhafte Antwort

{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'transactionstartedtimestamp': u '2017-04-21 09:26:46',
u 'dcccurrencyiso3a': u 'GBP',
u 'livestatus': u '0',
u 'englishacquirertypedescription': u 'Acquirer',
u 'iin': u '411111111',
u 'dcctype': u 'DCC',
u 'dccbaseamount': u '1050',
u 'errorcode': u '0',
u 'orderreference': u 'My_Order_123',
u 'dccconversionratesource': u 'Conversion rate source',
u 'merchantnumber': u '00000000',
u 'dccexpirytimestamp': u '2017-04-25 14:26:00',
u 'transactionreference': u '23-71-101',
u 'paymenttypedescription': u 'VISA',
u 'baseamount': u '1641',
u 'dccmarginratepercentage': u '2.5000',
u 'accounttypedescription': u 'CURRENCYRATE',
u 'acquirerresponsecode': u '0',
u 'requesttypedescription': u 'CURRENCYRATE',
u 'acquirerresponsemessage': u 'Success',
u 'currencyiso3a': u 'USD',
u 'maskedpan': u '411111######1111',
u 'errormessage': u 'Ok',
u 'issuercountryiso2a': u 'ZZ',
u 'dccconversionrate': u '1.5626',
u 'operatorname': u 'webservices@example.com'
}]
}

array(3) {
  ["requestreference"] => string(9) "A3579dkvx"
  ["version"] => string(4) "1.00"
  ["responses"] => array(1) {
    [0] => array(26) {
      ["transactionstartedtimestamp"] => string(19) "2017-04-21 09:26:46"
      ["dcccurrencyiso3a"] => string(3) "GBP"
      ["livestatus"] => string(1) "0"
      ["englishacquirertypedescription"] => string(8) "Acquirer"
      ["iin"] => string(9) "411111111"
      ["dcctype"] => string(3) "DCC"
      ["dccbaseamount"] => string(4) "1050"
      ["errorcode"] => string(1) "0"
      ["orderreference"] => string(12) "My_Order_123"
      ["dccconversionratesource"] => string(22) "Conversion rate source"
      ["merchantnumber"] => string(8) "00000000"
      ["dccexpirytimestamp"] => string(19) "2017-04-25 14:26:00"
      ["transactionreference"] => string(9) "23-71-101"
      ["paymenttypedescription"] => string(4) "VISA"
      ["baseamount"] => string(4) "1641"
      ["dccmarginratepercentage"] => string(6) "2.5000"
      ["accounttypedescription"] => string(12) "CURRENCYRATE"
      ["acquirerresponsecode"] => string(1) "0"
      ["requesttypedescription"] => string(12) "CURRENCYRATE"
      ["acquirerresponsemessage"] => string(7) "Success"
      ["currencyiso3a"] => string(3) "USD"
      ["maskedpan"] => string(16) "411111######1111"
      ["errormessage"] => string(2) "Ok"
      ["issuercountryiso2a"] => string(2) "ZZ"
      ["dccconversionrate"] => string(6) "1.5626"
      ["operatorname"] => string(23) "webservices@example.com"
    }
  }
}

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "transactionstartedtimestamp":"2017-04-21 09:26:46",
    "dcccurrencyiso3a":"GBP",
    "livestatus":"0",
    "englishacquirertypedescription":"Acquirer",
    "iin":"411111111",
    "dcctype":"DCC",
    "dccbaseamount":"1050",
    "errorcode":"0",
    "orderreference":"My_Order_123",
    "dccconversionratesource":"Conversion rate source",
    "merchantnumber":"00000000",
    "dccexpirytimestamp":"2017-04-25 14:26:00",
    "transactionreference":"23-71-101",
    "paymenttypedescription":"VISA",
    "baseamount":"1641",
    "dccmarginratepercentage":"2.5000",
    "accounttypedescription":"CURRENCYRATE",
    "acquirerresponsecode":"0",
    "requesttypedescription":"CURRENCYRATE",
    "acquirerresponsemessage":"Success",
    "currencyiso3a":"USD",
    "errormessage":"Ok",
    "issuer":"Test Issuer",
    "issuercountryiso2a":"ZZ",
    "dccconversionrate":"1.5626",
    "operatorname":"webservices@example.com"
  }],
  "secrand":"zO9"
}

<responseblock version="3.67">
  <requestreference>X881587174</requestreference>
  <response type="CURRENCYRATE">
    <merchant>
      <orderreference>My_Order_123</orderreference>
      <merchantnumber>00000000</merchantnumber>
      <operatorname>webservices@example.com</operatorname>
    </merchant>
    <transactionreference>23-71-101</transactionreference>
    <billing>
      <amount currencycode="USD">1641</amount>
      <payment type="VISA">
        <iin>411111111</iin>
        <issuercountry>ZZ</issuercountry>
        <issuer>Test Issuer</issuer>
      </payment>
      <dcc>
        <marginratepercentage>2.5000</marginratepercentage>
        <amount currencycode="GBP">1050</amount>
        <dcctype>DCC</dcctype>
        <conversionrate>1.5626</conversionrate>
        <conversionratesource>Conversion rate source</conversionratesource>
        <expirytimestamp>2013-06-09 18:45:00</expirytimestamp>
        <dccproviderdata>01020304120021250373330603INR0803356200513800210875190000300124306MBB015</dccproviderdata>
      </dcc>
    </billing>
    <timestamp>2013-06-05 14:45:56</timestamp>
    <live>0</live>
    <error>
      <message>Ok</message>
      <code>0</code>
    </error>
    <acquirerresponsecode>0</acquirerresponsecode>
    <operation>
      <processor>Test DCC Provider</processor>
      <accounttypedescription>CURRENCYRATE</accounttypedescription>
    </operation>
    <acquirerresponsemessage>Success</acquirerresponsemessage>
  </response>
  <secrand>1Enh1O0h</secrand>
</responseblock>

Nachdem Sie die Antwort CURRENCYRATE erhalten haben, überprüfen Sie, ob die in der Datei Währung zurückgegebene currencyiso3a unterscheidet sich von dem im Feld dcccurrencyiso3a Feld.

Wenn die Währungen unterschiedlich sind:

Wenn die Währungen gleich sind:

Bieten Sie dem Kunden die Wahl zwischen der Abwicklung der Zahlung über Währung oder über Währung.

Hinweis: Einige Acquirer verlangen möglicherweise, dass dem Kunden auf der Auswahlseite Währung bestimmte Informationen angezeigt werden, wie z. B. der verwendete Umrechnungskurs und der Name des Anbieters des Umrechnungskurses. Bitte vergewissern Sie sich bei Ihrer anwerbenden Bank, dass Sie alle erforderlichen Informationen anzeigen.

Fordern Sie den Kunden auf, zu bestätigen, dass er fortfahren möchte, bevor Sie die Zahlung bearbeiten.

Feldspezifikation

Es ist unbedingt erforderlich, dass alle Transaktionen, die die vom Anbieter des Umrechnungskurses Währung bereitgestellten Umrechnungen verwenden, vor der dccexpirytimestamp (die in der Antwort CURRENCYRATE zurückgegeben wird) abgewickelt werden.

Wenn Sie dies nicht tun, indem Sie das Datum Abrechnung verschieben, kann dies dazu führen, dass der Kunde einen falschen Betrag bezahlt und Ihre Vereinbarung mit dem Anbieter des Umrechnungskurses oder dem Acquirer ungültig wird.

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Dies wird als "CURRENCYRATE" zurückgegeben.
acquirerresponsecode XPath: /acquirerresponsecode	Alphanumerisch (255)	Wird vom Anbieter DCC verwendet, um das Ergebnis der Anfrage anzugeben. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
acquirerresponsemessage XPath: /acquirerresponsemessage	Alphanumerisch (255)
baseamount XPath: /billing/amount	Numerisch (13)	Der Gesamtbetrag in der Währung des Kunden. Dieser Wert enthält die Umrechnungsgebühr, die zur Deckung der Kosten für die Umrechnung des Betrags in die Landeswährung erhoben wird. Der Betrag wird in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben, d. h. €10 sind 1000.
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die Adresse des Kunden Währung im iso3a-Format. Diese wird durch Analyse der in der Anfrage angegebenen Kartendaten ermittelt. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
dccbaseamount XPath: /billing/amount	Numerisch (13)	Der Betrag in der Währung des Händlers. Der Betrag sollte in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben werden, d.h. €10 wäre 1000. Der in der Antwort zurückgegebene Wert entspricht dem in der Anfrage angegebenen Wert.
dccconversionrate XPath: /billing/dcc/conversionrate	Numerisch (255)	Der Umrechnungskurs, der zur Berechnung des Betrags auf Währung verwendet wird.
dccconversionratesource XPath: /billing/dcc/conversionratesource	Alphanumerisch (255)	Die Quelle des vom Anbieter DCC zurückgegebenen Umrechnungskurses.
dcccurrencyiso3a XPath: /billing/dcc/amount/@currencycode	Alpha (3)	Die Seite des Händlers Währung im iso3a-Format. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
dccexpirytimestamp XPath: /billing/dcc/expirytimestamp	Datum Uhrzeit "JJJJ-MM-TT HH:MM:SS"	Das Ablaufdatum des CURRENCYRATE look-up. Zahlungen, die CURRENCYRATE als übergeordneten Anfrage verwenden, müssen vor diesem Datum und dieser Uhrzeit abgerechnet werden. Format: JJJJ-MM-TT HH:MM:SS
dccmarginratepercentage XPath: /billing/dcc/marginratepercentage	Numerisch (11)	Der Prozentsatz, der zur Berechnung der Währung Umrechnungsgebühr verwendet wird (4 Dezimalstellen), die vom Anbieter DCC automatisch zu dem Betrag auf Währung hinzugefügt wird.
dccprovider XPath: /billing/dcc/provider	Alphanumerisch (255)	Der Name des Drittanbieters DCC , der den für die Zahlung verwendeten Umrechnungskurs bereitgestellt hat. Dieses Feld wird zurückgegeben, wenn die Daten vom Anbieter des Umrechnungskurses bereitgestellt wurden.
dccproviderdata XPath: /billing/dcc/dccproviderdata	Alphanumerisch (255)	Eine eindeutige Zeichenfolge, die Informationen über den berechneten Umrechnungskurs enthält und direkt von bestimmten Anbietern von Umrechnungskursen zurückgegeben wird. Dieses Feld wird zurückgegeben, wenn die Daten vom Anbieter des Umrechnungskurses bereitgestellt wurden.
dcctype XPath: /billing/dcc/dcctype	Alpha (3)	Dies wird als "DCC" zurückgegeben.
englishacquirertypedescription XPath: /operation/processor	Alphanumerisch (255)	Der Name des Drittanbieters DCC , der den für die Zahlung verwendeten Umrechnungskurs bereitgestellt hat. Dies ist eine englische Beschreibung des Anbieters, die auf Ihren Seiten angezeigt werden kann.
iin XPath: /billing/payment/iin	Numerisch (9)	Issuer Identification Number (IIN) - Dies sind die ersten 9 Ziffern am Anfang der Kartennummer des Kunden.
issuercountryiso2a XPath: /billing/payment/issuercountry	Alpha (2)	Das Land, in dem der Kartenaussteller des Kunden ansässig ist. Es wird im ISO2A-Format angegeben. Klicken Sie hier für eine vollständige Liste der Ländercodes.
maskedpan XPath: /billing/payment/pan	Alphanumerisch einschließlich "#" (12-19)	Die Kartennummer des Kunden. Diese ist in der Antwort maskiert. Ein Teil der Nummer wird absichtlich durch "#"-Zeichen unkenntlich gemacht, z. B. 411111######0211.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
requesttypedescription XPath: /@type	Alpha (20)	Dies wird als "CURRENCYRATE" zurückgegeben.
transactionreference XPath: /transactionreference	Alphanumerisch einschließlich Bindestriche (25)	Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird.

3. Transaktion verarbeiten

Nachdem Sie die Antwort CURRENCYRATE erhalten und den Kunden aufgefordert haben, die endgültige Währung auszuwählen, muss der Kunde in Ihrem Kassenformular auf "Bezahlen" klicken, um die Zahlung abzuschließen. Sie müssen sicherstellen, dass Ihr Kassenformular aktualisiert wurde, um auf unser JavaScript Library zu verweisen, und dass die payload die als Teil des JWT übermittelt wurde, wurde aktualisiert und enthält nun zusätzliche Felder für die Umwandlung von Währung (siehe unten).

Es ist unbedingt erforderlich, dass alle Transaktionen, die die vom Anbieter des Umrechnungskurses Währung bereitgestellten Umrechnungen verwenden, vor dem dccexpirytimestamp (zurückgegeben in der Antwort CURRENCYRATE ) abgerechnet werden. Wenn Sie dies nicht tun, indem Sie das Abrechnung Datum verschieben, kann dies dazu führen, dass der Kunde einen falschen Betrag bezahlt und Ihre Vereinbarung mit dem Anbieter des Umrechnungskurses oder dem Acquirer ungültig wird.

(Payload Beispiel:)

{
  "payload":{
    "accounttypedescription":"ECOM",
    "baseamount":"1641",
    "currencyiso3a":"USD",
    "sitereference":"test_site12345",
    "parenttransactionreference":"23-71-101",
    "pan":"4111111111111111",
    "expirydate":"12/2037",
    "securitycode":"123",
    "dcctype":"DCC",
    "dccoffered":"1",
    "dccconversionrate":"1.5626",
    "dcccurrencyiso3a":"GBP",
    "dccbaseamount":"1050",
    "requesttypedescriptions":["THREEDQUERY","AUTH"]
  },
  "iat":1559033849,
  "iss":"jwt.user"
}

Sie müssen die JWT-Antwort überprüfen, um zu bestätigen, dass die Zahlung erfolgreich war. Wie bei einer Standardzahlung müssen Sie besonders auf die errorcode und settlestatus Felder.

Quittungstext

Ausgewählte Acquirer können verlangen, dass dem Kunden nach einer Transaktion bestimmte Informationen auf einem Beleg angezeigt werden, z. B. der verwendete Umrechnungskurs und der Name des Anbieters des Umrechnungskurses. Bitte vergewissern Sie sich bei Ihrer erwerbenden Bank, dass Sie alle erforderlichen Informationen anzeigen.

Feldspezifikation

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Diese muss als "ECOM" (E-Commerce) eingereicht werden.
baseamount XPath: /billing/amount	Numerisch (13)	Der Betrag in der endgültigen Währung. Dieser Betrag sollte in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben werden, d.h. €10 wäre 1000.
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die endgültige Währung. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
dccbaseamount XPath: /billing/dcc/amount	Numerisch (13)	Der Betrag in der Währung des Händlers. Dieser Betrag sollte in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben werden, d.h. €10 wäre 1000.
dccconversionrate XPath: /billing/dcc/conversionrate	Numerisch (255)	Der Umrechnungskurs, der zur Berechnung des Betrags auf Währung verwendet wird.
dccconversionratesource XPath: /billing/dcc/conversionratesource	Alphanumerisch (255)	Die Quelle des vom Anbieter DCC zurückgegebenen Umrechnungskurses.
dcccurrencyiso3a XPath: /billing/dcc/amount/@currencycode	Alpha (3)	Die Seite des Händlers Währung im iso3a-Format. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
dccmarginratepercentage XPath: /billing/dcc/marginratepercentage	Numerisch (11)	Der Prozentsatz, der zur Berechnung der Währung Umrechnungsgebühr verwendet wird (4 Dezimalstellen), die vom Anbieter DCC automatisch zu dem Betrag auf Währung hinzugefügt wird.
dccoffered XPath: /billing/dcc/offered	Numerisch (1)	Bitte verwenden Sie einen der folgenden Werte: 1 - DCC Offered & Accepted Der Kunde hat das Angebot von DCC angenommen und sich für die Zahlung mit der Karte seines Kartenausgebers entschieden. Währung baseamount; currencyiso3a; dccconversionrate; dcccurrencyiso3a; & dccbaseamount sind Werte aus der Antwort CURRENCYRATE in Schritt 2. 2 - DCC Nicht verfügbar Der Kunde zahlt in der Währung des Händlers Währung baseamount; currencyiso3a; dcccurrencyiso3a; & dccbaseamount sind Händler Basisbetrag und Währung. 3 - DCC Offered & Refused Der Kunde hat das Angebot von DCC abgelehnt und sich für die Zahlung in der Währung baseamount; currencyiso3a; dcccurrencyiso3a; & dccbaseamount sind Händler Basisbetrag und Währung bevor DCC angeboten wurde.
dccprovider XPath: /billing/dcc/provider	Alphanumerisch (255)	Der Name des Drittanbieters DCC , der den für die Zahlung verwendeten Umrechnungskurs bereitgestellt hat.
dccproviderdata XPath: /billing/dcc/dccproviderdata	Alphanumerisch (255)	Eine eindeutige Zeichenfolge, die Informationen über den berechneten Umrechnungskurs enthält und direkt von bestimmten Anbietern von Umrechnungskursen zurückgegeben wird.
dcctype XPath: /billing/dcc/dcctype	Alpha (3)	Der angegebene Wert muss "DCC" lauten.
expirydate XPath: /billing/payment/expirydate	Datum MM/JJJJ	Das auf der Karte aufgedruckte Ablaufdatum.
pan XPath: /billing/payment/pan	Numerisch (12-19)	Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Rufen Sie die transactionreference Wert aus der Antwort CURRENCYRATE , und übermitteln Sie diesen in der parenttransactionreference Feld in der payload des JWT. Anmerkung: Wir unterstützen die Möglichkeit, die Konvertierung von Währung über Ihren eigenen DCC Anbieter durchzuführen. In einem solchen Fall wird die parenttransactionreference Feld ist nicht erforderlich. Klicken Sie hier für weitere Informationen.
requesttypedescriptions	Liste	Diese muss auf [“THREEDQUERY”,”AUTH”].
securitycode XPath: /billing/payment/securitycode	Numerisch (3-4)	Dies ist der dreistellige Sicherheitscode, der auf der Rückseite der Karte aufgedruckt ist. (Bei AMEX Karten ist dies ein 4-stelliger Code, der sich auf der Vorderseite der Karte befindet) Dieses Feld ist für Trust Payments nicht unbedingt erforderlich, wird aber für die Verarbeitung von Sicherheitscodeprüfungen dringend empfohlen. Außerdem können einige Banken die Zahlung ablehnen, wenn der Sicherheitscode nicht vorhanden ist.
sitereference XPath: /operation/sitereference	Alphanumerisch & Unterstrich (50)	Eindeutige Referenz, die Ihre Website Trust Payments identifiziert.

Prüfung

Wir empfehlen Ihnen, Ihre Lösung gründlich zu testen, bevor Sie Zahlungen im Echtbetrieb abwickeln.
Klicken Sie hier, um Details zu den Testkarten zu erhalten, die Sie beim Testen angeben können.

Verarbeitung von Dynamic Währung Conversion (DCC) Zahlungen mit unserer API

Überblick über den Prozess

1. CURRENCYRATE Anfrage einreichen

2. Empfang der Antwort CURRENCYRATE

3. Transaktion verarbeiten

Bitte beachten Sie die folgenden Unterscheidungen:

1. CURRENCYRATE Anfrage einreichen

Beispielanfrage

Feldspezifikation

2. Empfang der Antwort CURRENCYRATE

Beispielhafte Antwort

Feldspezifikation

3. Transaktion verarbeiten

Quittungstext

Feldspezifikation

Prüfung

Weitere Lektüre zu diesem Thema