Für Kunden, die eine Zahlung mit DCC abgeschlossen haben, ist es möglich, Erstattungen zu bearbeiten, indem sie manuell eine REFUND Anfrage über unsere Webservices API oder MyST einreichen.
Bevor Sie fortfahren, beachten Sie bitte die folgenden Hinweise:
- Die Währung des Kunden ist die Währung , die mit seiner Karte verbunden ist.
- Die Währung des Händlers ist die lokale Währung , die mit Ihrem Konto verbunden ist.
Wenn der Kunde sich dafür entschieden hat, die Zahlung über die Website des Händlers Währung abzuwickeln:
- Verarbeiten Sie eine Standardanfrage REFUND über unsere Webservices API. Klicken Sie hier für die Dokumentation.
- Bearbeiten Sie eine Erstattung mit MyST. Klicken Sie hier, um mehr zu erfahren.
Wenn der Kunde die Zahlung über Währung abwickeln möchte, wählen Sie eine der vier folgenden Optionen:
DCC Rückerstattungen, die über unsere Webservices API abgewickelt werden, haben eine ähnliche Struktur wie die Standardanfragen von REFUND , unterliegen jedoch zusätzlichen Anforderungen, die im Folgenden beschrieben werden.
Es liegt in Ihrer Verantwortung sicherzustellen, dass alle DCC Feldwerte, die Sie in DCC REFUND Anfragen einfügen, korrekt und mit Ihrem Anbieter von Umrechnungskursen abgestimmt sind.
Ihr Anbieter von Umrechnungskursen legt das erforderliche Verfahren für die Abwicklung von Erstattungen für Ihr Konto fest. Wir empfehlen Ihnen, die verfügbaren Optionen zu prüfen und unser Support-Team für weitere Informationen zu kontaktieren.
Anforderung
Die Anfrage hat dieselbe Struktur wie eine Standardanfrage REFUND, mit dem Unterschied, dass Ihr System zusätzlich entweder die Felder des Kunden Währung ODER die Felder des Händlers Währung erneut übermitteln muss, wie unten gezeigt:
Geben Sie in der Anfrage entweder die beiden folgenden Kundenfelder Währung an:
| currencyiso3a | Der Kunde ist Währung. |
| baseamount | Der Betrag auf der Website des Kunden Währung. |
Oder, wenn Sie es vorziehen, die Felder des Händlers Währung in der Anfrage zu übermitteln:
| dcccurrencyiso3a | Die Seite des Händlers Währung. |
| dccbaseamount | Der Betrag auf der Website des Händlers Währung. |
Wie bei den Standardanfragen REFUND müssen die eingereichten parenttransactionreference muss sich auf den zu erstattenden übergeordneten Antrag AUTH beziehen (nicht auf den Antrag CURRENCYRATE).
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
refund= {
"requesttypedescriptions": ["REFUND"],
"sitereference": "test_site12345",
"parenttransactionreference": "1-2-345678",
"currencyiso3a": "USD",
"baseamount": "1641"
}
strequest = securetrading.Request()
strequest.update(refund)
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(
'requesttypedescriptions' => array('REFUND'),
'sitereference' => 'test_site12345',
'parenttransactionreference' => '1-2-345678',
'currencyiso3a' => 'USD',
'baseamount' => '1641'
);
$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": [{
"requesttypedescriptions": ["REFUND"],
"sitereference": "test_site12345",
"parenttransactionreference": "1-2-345678",
"currencyiso3a": "USD",
"baseamount": "1641"
}]}'
{"alias":"webservices@example.com","version":"1.00","request":[{"requesttypedescriptions":["REFUND"],"sitereference":"test_site12345","parenttransactionreference":"1-2-345678","currencyiso3a":"USD","baseamount":"1641"}]}
<?xml version='1.0' encoding='utf-8'?>
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="REFUND">
<billing>
<amount currencycode="USD">1641</amount>
</billing>
<operation>
<sitereference>test_site12345</sitereference>
<parenttransactionreference>1-2-345678</parenttransactionreference>
</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 | |
|
Reichen Sie einen dieser Beträge ein |
baseamount XPath: /billing/amount |
Numerisch (13) |
Der zu erstattende Betrag in der Währung des Kunden (einschließlich der Gebühr, die bei der Berechnung des Prozentsatzes der Gewinnspanne hinzugefügt wird). Der Betrag sollte in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben werden, also €10 wäre 1000. Hinweis: Bei der Einreichung der baseamount, müssen Sie auch das zugehörige Feld currencyiso3a übermitteln. |
| dccbaseamount XPath: /billing/dcc/amount |
Numerisch (13) |
Der zu erstattende 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. Hinweis: Bei der Einreichung der dccbaseamount, müssen Sie auch das zugehörige Feld dcccurrencyiso3a übermitteln. |
|
|
Eine dieser Währungen einreichen |
currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
Die Website des Kunden Währung im iso3a-Format. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. Erforderlich, wenn die baseamount vorgelegt wird. |
| 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. Erforderlich, wenn die dccbaseamount vorgelegt wird. |
|
 |
dccconversionrate XPath: /billing/dcc/conversionrate |
Numerisch (255) | Der Umrechnungskurs, der ursprünglich verwendet wurde, um den Betrag auf Währung zu berechnen (zurückgegeben in der ursprünglichen Antwort CURRENCYRATE). |
|
dccconversionratesource XPath: /billing/dcc/conversionratesource |
Alphanumerisch (255) | Die Quelle des ursprünglichen Umrechnungskurses, der vom Anbieter DCC zurückgegeben wurde (zurückgegeben in der ursprünglichen Antwort CURRENCYRATE). |
|
dccmarginratepercentage XPath: /billing/dcc/marginratepercentage |
Numerisch (11) | Der Prozentsatz (4 Dezimalstellen), der im Rahmen der Anfrage CURRENCYRATE zur Berechnung der Umrechnungsgebühr Währung verwendet wird, die nach der Berechnung automatisch an den Betrag auf Währung angehängt wird. |
|
dccprovider XPath: /billing/dcc/provider |
Alphanumerisch (255) | Der Name des Drittanbieters DCC , der den in der Zahlung verwendeten Umrechnungskurs bereitgestellt hat (zurückgegeben in der ursprünglichen Antwort CURRENCYRATE). |
|
dccproviderdata XPath: /billing/dcc/dccproviderdata |
Alphanumerisch (255) | Eine eindeutige Zeichenfolge, die Informationen über den berechneten Umrechnungskurs enthält, die direkt von den teilnehmenden Anbietern von Umrechnungskursen zurückgegeben werden (in der ursprünglichen Antwort CURRENCYRATE). |
|
dcctype XPath: /billing/dcc/dcctype |
Alpha (3) | Falls eingereicht, muss dies "DCC" sein. |
 |
parenttransactionreference XPath: /operation/parenttransactionreference |
Alphanumerisch & Bindestriche (25) |
Dieses Feld muss die Transaktionsnummer des AUTH Antrags enthalten, den Sie erstatten möchten. |
|
requesttypedescriptions XPath: /@type |
Alpha (20) | Sie müssen "REFUND" eingeben. |
|
sitereference XPath: /operation/sitereference |
Alphanumerisch & Unterstrich (50) |
Identifiziert Ihre Website auf dem System Trust Payments . Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team. |
Teilweise Erstattung
Durch die Einreichung eines baseamount OR dccbaseamount mit einem niedrigeren Wert als ursprünglich genehmigt, kann Ihr System Teilerstattungen verarbeiten. Wir werden den Betrag in der anderen Währung automatisch neu berechnen und diesen in der Antwort zurückgeben.
Antwort
Die zurückgesendete Antwort hat eine ähnliche Struktur wie eine Standardantwort von REFUND, mit dem Zusatz von DCC-spezifischen Feldern, wie unten beschrieben.
Die zurückgegebenen DCC-spezifischen Felder haben die gleichen Werte wie in den ursprünglichen CURRENCYRATE und AUTH Anfragen, was zeigt, dass die gleichen Konvertierungsdaten angewendet wurden.
Die dccratio Wert wird anhand des Erstattungsbetrags in der Kunden- und Händlerwährung berechnet. Da dieser Wert berechnet wird nach die Umrechnung stattgefunden hat und der umgerechnete Betrag gerundet ist, wird der dccratio die in der Antwort zurückgegeben wird, kann sich geringfügig von der ursprünglichen Zahlung unterscheiden.
Feldspezifikation
| Feld | Format | Beschreibung | |
 |
baseamount XPath: /billing/amount |
Numerisch (13) | Der in der Währung des Kunden erstattete Betrag (einschließlich der Gebühr, die bei der Berechnung des Prozentsatzes der Gewinnspanne hinzugefügt wird). Der Betrag wird in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben, d. h. €10 wären 1000. |
|
dccbaseamount XPath: /billing/dcc/amount |
Numerisch (13) | Der Erstattungsbetrag in der Währung des Händlers. Der Betrag wird in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben, d. h. €10 wären 1000. |
|
currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
Die Website des Kunden Währung im iso3a-Format. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. |
|
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. |
|
dccconversionrate XPath: /billing/dcc/conversionrate |
Numerisch (255) | Der Umrechnungskurs, der ursprünglich für die Berechnung des Betrages auf der Website Währung verwendet wurde. |
|
dccconversionratesource XPath: /billing/dcc/conversionratesource |
Alphanumerisch (255) | Die Quelle des ursprünglichen Umrechnungskurses, der vom Anbieter DCC zurückgegeben wurde. |
|
dccenabled XPath: /billing/dcc/@enabled |
Numerisch (1) | Der zurückgegebene Wert ist "1", was bedeutet, dass das für die Verarbeitung dieser Zahlung verwendete Konto für DCC aktiviert ist. |
|
dccmarginratepercentage XPath: /billing/dcc/marginratepercentage |
Numerisch (11) | Der Prozentsatz (4 Dezimalstellen), der im Rahmen der Anfrage CURRENCYRATE zur Berechnung der Umrechnungsgebühr Währung verwendet wird, die nach der Berechnung automatisch an den Betrag auf Währung angehängt wird. |
|
dccoffered XPath: /billing/dcc/offered |
Numerisch (1) |
Dieser Wert gibt an, ob die REFUND auf der Seite des Kunden Währung oder auf der Seite des Händlers Währung bearbeitet wurde:
1 - Der Kunde erhielt eine Rückerstattung auf der Website des Kunden Währung. 3 - Der Kunde wurde auf der Website des Händlers Währung entschädigt. |
|
dccproviderdata XPath: /billing/dcc/dccproviderdata |
Alphanumerisch (255) | Eine eindeutige Zeichenfolge, die Informationen über den berechneten Umrechnungskurs enthält und direkt von den teilnehmenden Anbietern von Umrechnungskursen zurückgegeben wird. |
|
dccratio XPath: /billing/dcc/ratio |
Numerisch (255) | Das Verhältnis zwischen den beiden im Antrag verarbeiteten Beträgen in Haupteinheiten. |
|
dcctype XPath: /billing/dcc/dcctype |
Alpha (3) | Dies wird als "DCC" zurückgegeben. |
|
parenttransactionreference XPath: /operation/parenttransactionreference |
Alphanumerisch & Bindestriche (25) |
Die Transaktionsnummer der AUTH beantragen eine Erstattung. |
|
requesttypedescription XPath: /@type |
Alpha (20) | Dies wird als "REFUND" zurückgegeben. |
Überblick über den Prozess
-
Führen Sie eine neue CURRENCYRATE Anfrage durch.
Anmerkung: Wenn Sie eine Teilerstattung vornehmen, müssen Sie eine niedrigere dccbaseamount in der Anfrage. - Führen Sie eine REFUND -Anfrage durch und stellen Sie sicher, dass alle DCC-spezifischen Felder, die in der neuen CURRENCYRATE -Antwort zurückgegeben werden, übermittelt werden (siehe Liste unten).
Wie bei den Standardanfragen REFUND müssen die eingereichten parenttransactionreference muss sich auf den zu erstattenden übergeordneten Antrag AUTH beziehen (nicht auf den Antrag CURRENCYRATE).
Anforderung
Im Folgenden wird ein Beispiel für eine Anfrage zur Verarbeitung einer REFUND mit einem neuen Umrechnungskurs gegeben. Dabei wird davon ausgegangen, dass Sie bereits eine neue CURRENCYRATE Anfrage durchgeführt haben und die neuen Daten in die REFUND Anfrage aufnehmen (weitere Informationen zu diesen Feldern finden Sie in der nachstehenden Feldspezifikation)
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
refund= {
"requesttypedescriptions": ["REFUND"],
"sitereference": "test_site12345",
"parenttransactionreference": "1-2-345678",
"currencyiso3a": "USD",
"baseamount": "1260",
"dcctype": "DCC",
"dccconversionrate": "1.2",
"dccconversionratesource": "Rate Source",
"dccmarginratepercentage": "2.5000",
"dcccurrencyiso3a": "GBP",
"dccbaseamount": "1050",
"dccprovider": "Test Provider",
"dccproviderdata": "01020304120021250373330603INR0803356200513800210875190000300124306MBB01"
}
strequest = securetrading.Request()
strequest.update(refund)
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(
'requesttypedescriptions' => array('REFUND'),
'sitereference' => 'test_site12345',
'parenttransactionreference' => '1-2-345678',
'currencyiso3a' => 'USD',
'baseamount' => '1260',
'dcctype' => 'DCC',
'dccconversionrate' => '1.2',
'dccmarginratepercentage' => '2.5000',
'dcccurrencyiso3a' => 'GBP',
'dccbaseamount' => '1050'
'requesttypedescriptions' => array('REFUND'),
'sitereference' => 'test_site12345',
'parenttransactionreference' => '1-2-345678',
'currencyiso3a' => 'USD',
'baseamount' => '1260',
'dcctype' => 'DCC',
'dccconversionrate' => '1.2',
'dccconversionratesource' => 'Rate Source',
'dccmarginratepercentage' => '2.5000',
'dcccurrencyiso3a' => 'GBP',
'dccbaseamount' => '1050',
'dccprovider' => 'Test Provider',
'dccproviderdata' => '01020304120021250373330603INR0803356200513800210875190000300124306MBB01'
);
$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": [{
"requesttypedescriptions": ["REFUND"],
"sitereference": "test_site12345",
"parenttransactionreference": "1-2-345678",
"currencyiso3a": "USD",
"baseamount": "1260",
"dcctype": "DCC",
"dccconversionrate": "1.2",
"dccconversionratesource": "Rate Source",
"dccmarginratepercentage": "2.5000",
"dcccurrencyiso3a": "GBP",
"dccbaseamount": "1050",
"dccprovider": "Test Provider",
"dccproviderdata": "01020304120021250373330603INR0803356200513800210875190000300124306MBB01"
}]}'
{"alias":"webservices@example.com","version":"1.00","request":[{"requesttypedescriptions":["REFUND"],"sitereference":"test_site12345","parenttransactionreference":"1-2-345678","currencyiso3a":"USD","baseamount":"1260","dcctype":"DCC","dccconversionrate":"1.2","dccconversionratesource":"Rate Source","dccmarginratepercentage":"2.5000","dcccurrencyiso3a":"GBP","dccbaseamount":"1050","dccprovider":"Test Provider","dccproviderdata":"01020304120021250373330603INR0803356200513800210875190000300124306MBB01"}]}
<?xml version='1.0' encoding='utf-8'?>
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="REFUND">
<billing>
<amount currencycode="USD">1260</amount>
<dcc type="DCC">
<amount currencycode="GBP">1050</amount>
<conversionrate>1.2</conversionrate>
<conversionratesource>Rate Source</conversionratesource>
<provider>Test Provider</provider>
<dccproviderdata>01020304120021250373330603INR0803356200513800210875190000300124306MBB015</dccproviderdata>
<marginratepercentage>2.5000</marginratepercentage>
</dcc>
</billing>
<operation>
<sitereference>test_site12345</sitereference>
<parenttransactionreference>1-2-345678</parenttransactionreference>
</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 | |
|
baseamount XPath: /billing/amount |
Numerisch (13) | Der zu erstattende Betrag in der Währung des Kunden (einschließlich der Gebühr, die bei der Berechnung des Prozentsatzes der Gewinnspanne hinzugefügt wird). Der Betrag sollte in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben werden, d.h. €10 wäre 1000. |
|
|
dccbaseamount XPath: /billing/dcc/amount |
Numerisch (13) | Der zu erstattende 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. |
|
currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
Die Website des Kunden Währung im iso3a-Format. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. |
|
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. |
|
dccconversionrate XPath: /billing/dcc/conversionrate |
Numerisch (255) | Der Umrechnungskurs, der zur Berechnung der neuen Beträge verwendet wird (wird in der neuen Antwort CURRENCYRATE zurückgegeben). |
|
dccconversionratesource XPath: /billing/dcc/conversionratesource |
Alphanumerisch (255) | Die Quelle des neuen Umrechnungskurses, der vom Anbieter DCC zurückgegeben wird (wird in der neuen Antwort CURRENCYRATE zurückgegeben). |
|
dccmarginratepercentage XPath: /billing/dcc/marginratepercentage |
Numerisch (11) | Der Prozentsatz, der als Teil der neuen CURRENCYRATE Anfrage verwendet wird, um die Währung Umrechnungsgebühr zu berechnen (4 Dezimalstellen), die vom DCC Anbieter automatisch zu dem Betrag auf Währung des Kunden addiert wird. |
 |
dccprovider XPath: /billing/dcc/provider |
Alphanumerisch (255) | Der Name des Drittanbieters DCC , der den in der Zahlung verwendeten Umrechnungskurs bereitgestellt hat (wird in der neuen Antwort CURRENCYRATE zurückgegeben). |
|
dccproviderdata XPath: /billing/dcc/dccproviderdata |
Alphanumerisch (255) | Eine eindeutige Zeichenkette mit Informationen über den berechneten Umrechnungskurs, die direkt von den teilnehmenden Anbietern von Umrechnungskursen zurückgegeben wird (in der neuen Antwort CURRENCYRATE). |
|
dcctype XPath: /billing/dcc/dcctype |
Alpha (3) | Sie müssen "DCC" eingeben. |
|
parenttransactionreference XPath: /operation/parenttransactionreference |
Alphanumerisch & Bindestriche (25) |
Dieses Feld muss die Transaktionsnummer des AUTH Antrags enthalten, den Sie erstatten möchten. |
|
requesttypedescriptions XPath: /@type |
Alpha (20) | Sie müssen "REFUND" eingeben. |
|
sitereference XPath: /operation/sitereference |
Alphanumerisch & Unterstrich (50) |
Identifiziert Ihre Website auf dem System Trust Payments . Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team. |
Antwort
Die zurückgesendete Antwort hat eine ähnliche Struktur wie eine Standardantwort von REFUND, mit dem Zusatz von DCC-spezifischen Feldern, wie unten beschrieben.
Die zurückgegebenen DCC-spezifischen Felder haben die gleichen Werte wie in der neuen CURRENCYRATE -Anfrage, was zeigt, dass die neuen Konvertierungsdaten angewendet wurden.
Feldspezifikation
| Feld | Format | Beschreibung | |
|
baseamount XPath: /billing/amount |
Numerisch (13) | Der in der Währung des Kunden erstattete Betrag (einschließlich der Gebühr, die bei der Berechnung des Prozentsatzes der Gewinnspanne hinzugefügt wird). Der Betrag wird in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben, d. h. €10 wären 1000. |
|
dccbaseamount XPath: /billing/dcc/amount |
Numerisch (13) | Der Erstattungsbetrag in der Währung des Händlers. Der Betrag wird in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben, d. h. €10 wären 1000. |
|
currencyiso3a XPath: /billing/amount/@currencycode |
Alpha (3) |
Die Website des Kunden Währung im iso3a-Format. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. |
|
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. |
|
dccconversionrate XPath: /billing/dcc/conversionrate |
Numerisch (255) | Der Umrechnungskurs, der zur Berechnung der neuen Beträge verwendet wird (wird in der neuen Antwort CURRENCYRATE zurückgegeben). |
|
dccconversionratesource XPath: /billing/dcc/conversionratesource |
Alphanumerisch (255) | Die Quelle des neuen Umrechnungskurses, der vom Anbieter DCC zurückgegeben wird (wird in der neuen Antwort CURRENCYRATE zurückgegeben). |
|
dccenabled XPath: /billing/dcc/@enabled |
Numerisch (1) | Der zurückgegebene Wert ist "1", was bedeutet, dass das für die Verarbeitung dieser Zahlung verwendete Konto für DCC aktiviert ist. |
|
dccmarginratepercentage XPath: /billing/dcc/marginratepercentage |
Numerisch (11) | Der Prozentsatz, der als Teil der neuen CURRENCYRATE Anfrage verwendet wird, um die Währung Umrechnungsgebühr zu berechnen (4 Dezimalstellen), die vom DCC Anbieter automatisch zu dem Betrag auf Währung des Kunden addiert wird. |
|
dccoffered XPath: /billing/dcc/offered |
Numerisch (1) |
Dieser Wert gibt an, ob die REFUND auf der Seite des Kunden Währung oder auf der Seite des Händlers Währung bearbeitet wurde:
1 - Der Kunde erhielt eine Rückerstattung auf der Website des Kunden Währung. 3 - Der Kunde wurde auf der Website des Händlers Währung entschädigt. |
|
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 den teilnehmenden Anbietern von Umrechnungskursen zurückgegeben wird. |
|
dccratio XPath: /billing/dcc/ratio |
Numerisch (255) | Das Verhältnis zwischen den beiden im Antrag verarbeiteten Beträgen in Haupteinheiten. |
|
dcctype XPath: /billing/dcc/dcctype |
Alpha (3) | Dies wird als "DCC" zurückgegeben. |
|
parenttransactionreference XPath: /operation/parenttransactionreference |
Alphanumerisch & Bindestriche (25) |
Die Transaktionsnummer der AUTH beantragen eine Erstattung. |
|
requesttypedescription XPath: /@type |
Alpha (20) | Dies wird als "REFUND" zurückgegeben. |
Überblick über den Prozess
Ihr Anbieter von Umrechnungskursen kann verlangen, dass Sie einen neuen Umrechnungskurs verwenden, wenn Sie eine DCC Rückerstattung durchführen, nachdem eine vorher festgelegte Anzahl von Tagen seit der Verarbeitung der übergeordneten AUTH vergangen ist (wir bezeichnen dies als x Tage). Um dieses Problem zu lösen, kann unser Support-Team Ihr Konto so konfigurieren, dass es sich folgendermaßen verhält:
- Senden Sie DCC REFUND Anfrage.
- Wenn weniger als x Tage seit der AUTH vergangen sind, erfolgt die Erstattung zum ursprünglichen Umrechnungskurs.
- Wenn mehr als x Tage seit der AUTH vergangen sind, führen wir automatisch eine neue CURRENCYRATE Anfrage durch und verwenden die Ergebnisse, um eine Rückerstattung unter Verwendung des neuesten Umrechnungskurses zu verarbeiten.
Um dies für Ihr Konto zu konfigurieren oder um weitere Informationen zu erhalten, wenden Sie sich bitte an unser Support-Team.
Anforderung
Die Anfrage hat dieselbe Struktur wie eine Standardanfrage REFUND, mit dem Unterschied, dass Ihr System zusätzlich entweder die Felder des Kunden Währung ODER die Felder des Händlers Währung erneut übermitteln muss, wie unten gezeigt:
Geben Sie in der Anfrage entweder die beiden folgenden Kundenfelder Währung an:
| currencyiso3a | Der Kunde ist Währung. |
| baseamount | Der Betrag auf der Website des Kunden Währung. |
Oder, wenn Sie es vorziehen, die Felder des Händlers Währung in der Anfrage zu übermitteln:
| dcccurrencyiso3a | Die Seite des Händlers Währung. |
| dccbaseamount | Der Betrag auf der Website des Händlers Währung. |
Wie bei den Standardanfragen REFUND müssen die eingereichten parenttransactionreference muss sich auf den zu erstattenden übergeordneten Antrag AUTH beziehen (nicht auf den Antrag CURRENCYRATE).
Diese Implementierung unterstützt sowohl Teilerstattungen als auch vollständige Erstattungen. Übermitteln Sie einfach einen niedrigeren baseamount OR dccbaseamount und wir werden den Wert in der anderen Währung berechnen.
#!/usr/bin/python
import securetrading
stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)
refund= {
"requesttypedescriptions": ["REFUND"],
"sitereference": "test_site12345",
"parenttransactionreference": "1-2-345678",
"currencyiso3a": "USD",
"baseamount": "1641"
}
strequest = securetrading.Request()
strequest.update(refund)
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(
'requesttypedescriptions' => array('REFUND'),
'sitereference' => 'test_site12345',
'parenttransactionreference' => '1-2-345678',
'currencyiso3a' => 'USD',
'baseamount' => '1641'
);
$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": [{
"requesttypedescriptions": ["REFUND"],
"sitereference": "test_site12345",
"parenttransactionreference": "1-2-345678",
"currencyiso3a": "USD",
"baseamount": "1641"
}]}'
{"alias":"webservices@example.com","version":"1.00","request":[{"requesttypedescriptions":["REFUND"],"sitereference":"test_site12345","parenttransactionreference":"1-2-345678","currencyiso3a":"USD","baseamount":"1641"}]}
<?xml version='1.0' encoding='utf-8'?>
<requestblock version="3.67">
<alias>webservices@example.com</alias>
<request type="REFUND">
<billing>
<amount currencycode="USD">1641</amount>
</billing>
<operation>
<sitereference>test_site12345</sitereference>
<parenttransactionreference>1-2-345678</parenttransactionreference>
</operation>
</request>
</requestblock>
Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.
Es ist auch möglich, DCC Zahlungen zu erstatten, indem man MyST. Wenn die Zahlung über Währung des Kunden abgewickelt wurde (in MyST angezeigt als dccoffered = 1), führen wir automatisch eine neue CURRENCYRATE Anfrage durch, um den Kunden mit einem aktuellen Umrechnungskurs zu erstatten. MyST unterstützt auch die Möglichkeit, Teilerstattungen zu verarbeiten.
Klicken Sie hier für die Dokumentation zur Durchführung von Erstattungen mit MyST.
Die Möglichkeit, Transaktionen mit MyST zu erstatten, ist auf Benutzer mit bestimmten Benutzerrollen beschränkt (Klicken Sie hier für Informationen zu den verschiedenen Benutzerrollen).
