paysafecard für Webservices API

A "paysafecard" ist eine Prepaid-Karte, die von Ihren Kunden in Verkaufsstellen auf der ganzen Welt (z. B. bei PayPoint) erworben werden kann. Jede paysafecard enthält eine eindeutige PIN, die der Kunde auf der Kassenseite eingeben kann, um einen Kauf abzuschließen.

"myPaysafe" ist ein persönliches Online-Zahlungskonto, das den Kunden hilft, den Überblick über mehrere paysafecard PINs zu behalten. Der Kunde kann sich zum Zeitpunkt des Kaufs bei seinem "myPaysafe" Konto anmelden, um mit den auf seinem Konto gespeicherten paysafecard PINs zu bezahlen.

Unterstützte Kundenländer	Keine Einschränkungen für Kundenländer
Unterstützte Währungen	ARS, AUD, BGN, CAD, CHF, CZK, DKK, EUR, GBP, HUF, MXN, NOK, NZD, PEN, PLN, RON, SEK, TRY, USD, UYU
Rückerstattungen	Nur Payouts werden unterstützt.
Rückbuchungen	Zahlungen sind von Rückbuchungen ausgeschlossen.
Zero-authorisation	Nicht unterstützt.
Wiederkehrende Zahlungen	Nicht unterstützt.

Konfiguration

Um paysafecard für Ihr Konto zu aktivieren, wenden Sie sich bitte an Ihren Kundenbetreuer.
Ein Test-Sandbox-Konto wird zur Verfügung gestellt, das Sie zum Testen Ihrer Implementierung benötigen.

Überblick über den Prozess

Was wird der Kunde sehen?

Während des Bestellvorgangs bietet Ihre Website paysafecard als Zahlungsmethode an.
Der Kunde wählt seine bevorzugte Lieferadresse auf Ihrer Kassenseite aus und entscheidet sich für die Zahlung mit paysafecard.
Der Kunde wird auf paysafecard weitergeleitet, wo er entweder seine PIN(s) eingibt oder sich bei seinem "myPaysafe" Konto anmeldet.
Der Kunde überprüft seine Bestellung und stimmt der Zahlung auf paysafecard zu.
Der Kunde wird auf Ihre Website weitergeleitet, wo eine Bestätigung angezeigt wird (z. B. "Zahlung erfolgreich").

Wie funktioniert das hinter den Kulissen?

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

Initiieren Sie den Kunden
- Der Kunde erklärt sich mit einer Zahlung über paysafecard auf der Website des Händlers einverstanden.
- Der Händler sendet eine Anfrage an ORDER , um die Sitzung zu initiieren, einschließlich cancelurl und returnurl.
- Der Händler erhält die Antwort ORDER , einschließlich customerredirecturl.
Weiterleiten zu paysafecard
- Der Händler leitet den Browser des Kunden auf die customerredirecturl.
- Der Kunde gibt die PIN(s) ein, die er auf seiner paysafecard findet, oder meldet sich an.
- Bei Erfolg wird der Browser des Kunden auf die Seite returnurl.
  
  Wenn die Bestellung paysafecard abgebrochen wird, wird der Browser auf die Seite cancelurl wo eine Fehlermeldung angezeigt werden kann. Wir empfehlen, dass alternative Zahlungsmethoden angezeigt werden, damit der Kunde es erneut versuchen kann.
Bearbeitung der Autorisierung
- Nur wenn dies erfolgreich war, stellt der Händler eine Anfrage an AUTH , um die Zahlung zu verarbeiten.
- Der Händler erhält die Antwort AUTH und zeigt dem Kunden die Quittungsseite an.

1. Initiieren Sie den Kunden

Wenn sich der Kunde für die Zahlung mit paysafecard entscheidet, muss Ihr System eine ORDER Anfrage durchführen und die zurückgegebene Antwort interpretieren.

ORDER Beispiel anfordern

#!/usr/bin/python
import securetrading

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

order = {
  "currencyiso3a": "GBP",
  "requesttypedescription": "ORDER",
  "accounttypedescription": "ECOM",
  "sitereference": "test_site12345",
  "baseamount": "2001",
  "paymenttypedescription": "PAYSAFECARD",
  "returnurl": "https://www.example.com/return",
  "cancelurl": "https://www.example.com/cancel",
  "billingid": "000001",
  "paysafeminage": "18",
  "paysafekyclevel": "SIMPLE",
  "paysafecountryrestriction": "DE"
}

strequest = securetrading.Request()
strequest.update(order)
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(
  'currencyiso3a' => 'GBP',
  'requesttypedescription' => 'ORDER',
  'accounttypedescription' => 'ECOM',
  'sitereference' => 'test_site12345',
  'baseamount' => '2001',
  'paymenttypedescription' => 'PAYSAFECARD',
  'returnurl' => 'https://www.example.com/return',
  'cancelurl' => 'https://www.example.com/cancel',
  'billingid' => '000001',
  'paysafeminage' => '18',
  'paysafekyclevel' => 'SIMPLE',
  'paysafecountryrestriction' => 'DE'
);

$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": [{
    "currencyiso3a": "GBP",
    "requesttypedescription": "ORDER",
    "accounttypedescription": "ECOM",
    "sitereference": "test_site12345",
    "baseamount": "2001",
    "paymenttypedescription": "PAYSAFECARD",
    "returnurl": "https://www.example.com/return",
    "cancelurl": "https://www.example.com/cancel",
    "billingid": "000001",
    "paysafeminage": "18",
    "paysafekyclevel": "SIMPLE",
    "paysafecountryrestriction": "DE"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "currencyiso3a":"GBP",
    "requesttypedescription":"ORDER",
    "accounttypedescription":"ECOM",
    "sitereference":"test_site12345",
    "baseamount":"2001",
    "paymenttypedescription":"PAYSAFECARD",
    "returnurl":"https://www.example.com/return",
    "cancelurl":"https://www.example.com/cancel",
    "billingid":"000001",
    "paysafeminage":"18",
    "paysafekyclevel":"SIMPLE",
    "paysafecountryrestriction":"DE"
  }]
}'

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="ORDER">
    <merchant>
      <returnurl>https://www.example.com/return</returnurl>
      <cancelurl>https://www.example.com/cancel</cancelurl>
    </merchant>
    <billing id="000001">
      <amount currencycode="GBP">100</amount>
      <payment type="PAYSAFECARD">
        <paysafe>
          <minage>18</minage>
          <kyclevel>SIMPLE</kyclevel>
          <countryrestriction>DE</countryrestriction>
        </paysafe>
      </payment>
    </billing>
    <operation>
      <sitereference>test_site12345</sitereference>
      <accounttypedescription>ECOM</accounttypedescription>
    </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
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Nur "ECOM" (E-Commerce) wird unterstützt.
baseamount XPath: /billing/amount	Numerisch (11)	Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. €10 werden als 1000 übermittelt. Dieser Wert muss größer als Null sein.
billingid XPath: /billing/@id	Alphanumerisch (100)	Eine von Ihnen bereitgestellte Kennung, die zur Identifizierung des Kunden dient. Sie müssen immer eine billingid: Jedem Kunden muss eine eindeutige ID zugewiesen werden. Dieser Ausweis muss von wiederkehrenden Kunden wiederverwendet werden.
cancelurl XPath: /merchant/cancelurl	URL (2048)	Die URL, zu der der Kunde zurückkehrt, wenn er die Autorisierung abbricht, während er auf den Servern von paysafecardist.
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die Währung , in der die Transaktion abgewickelt wird. paysafecard Transaktionen können in den folgenden Währungen abgewickelt werden: ARS, AUD, BGN, CAD, CHF, CZK, DKK, EUR, GBP, HUF, MXN, NOK, NZD, PEN, PLN, RON, SEK, TRY, USD, UYU Klicken Sie hier, um weitere Informationen über Währung Codes zu erhalten.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Dieser Wert muss als "PAYSAFECARD" angegeben werden.
requesttypedescription XPath: /@type	Alpha (20)	Der Wert in der Anfrage muss "ORDER" lauten.
returnurl XPath: /merchant/returnurl	URL (2048)	Die URL, zu der der Kunde nach der Bestätigung der Zahlung durch paysafecard zurückgeführt wird.
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.
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.
paysafecountryrestriction XPath: /billing/payment/paysafe/countryrestriction	Alpha (2)	Schränkt ein, dass die Zahlung ausschließlich aus dem angegebenen Land (im iso2a-Format) abgewickelt wird. z. B. "GB" für das Vereinigte Königreich. Klicken Sie hier für eine vollständige Liste der Ländercodes.
paysafekyclevel XPath: /billing/payment/paysafe/kyclevel	Alpha (6)	Gibt die erforderliche KYC-Stufe für den "myPaysafe" Kontoinhaber an. Es gibt zwei Stufen: "SIMPLE" - Der Kunde hat die Erstregistrierung erfolgreich abgeschlossen und seine Handynummer und E-Mail Adresse bestätigt. "FULL" - Zusätzlich zu den oben genannten Angaben hat der Kunde einen Ausweis (z. B. Reisepass, Führerschein) und einen Adressnachweis (z. B. Rechnung eines Versorgungsunternehmens) vorgelegt.
paysafeminage XPath: /billing/payment/paysafe/minage	Numerisch (3)	Gibt das Mindestalter des Kontoinhabers "myPaysafe" an. Wenn Sie z. B. nur über 18-Jährige zulassen möchten, geben Sie in diesem Feld "18" ein.

ORDER Antwortbeispiel

{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'transactionreference': u '72-32-20002',
u 'paymenttypedescription': u 'PAYSAFECARD',
u 'settleduedate': u '2016-12-23',
u 'transactionstartedtimestamp': u '2016-12-23 15:35:40',
u 'errormessage': u 'Ok',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'customerredirecturl': u 'https://www.paysafecard.com/etc',
u 'requesttypedescription': u 'ORDER',
u 'settlestatus': u '0',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'paysafeminage': u '18',
u 'paysafekyclevel': u 'SIMPLE',
u 'paysafecountryrestriction': u 'DE',
u 'paysafeid': u '23842'
}]
}

array(3) {
  ["requestreference"] => string(9) "A349bdehj"
  ["version"] => string(4) "1.00"
  ["responses"] =>array(1) {
    [0] => array(16) {
      ["transactionreference"] => string(11) "72-32-20002"
      ["paymenttypedescription"] => string(11) "PAYSAFECARD"
      ["settleduedate" ]=> string(10) "2016-12-23"
      ["transactionstartedtimestamp"] => string(19) "2016-12-23 15:35:40"
      ["errormessage"] => string(2) "Ok"
      ["accounttypedescription"] => string(4) "ECOM"
      ["errorcode"] => string(1) "0"
      ["customerredirecturl"] => string(137) "https://www.paysafecard.com/etc"
      ["requesttypedescription"] => string(5) "ORDER"
      ["settlestatus"] => string(1) "0"
      ["operatorname"] => string(23) "webservices@example.com"
      ["livestatus"] => string(1) "0"
      ["paysafeminage"] => string(2) "18"
      ["paysafekyclevel"] => string(6) "SIMPLE"
      ["paysafecountryrestriction"] => string(2) "DE"
      ["paysafeid"] => string(5) "23842"
    }
  }
}

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "transactionreference":"72-32-20002",
    "paymenttypedescription":"PAYSAFECARD",
    "settleduedate":"2016-12-23",
    "transactionstartedtimestamp":"2016-12-23 15:35:40",
    "errormessage":"Ok",
    "accounttypedescription":"ECOM",
    "errorcode":"0",
    "customerredirecturl":"https://www.paysafecard.com/etc",
    "requesttypedescription":"ORDER",
    "settlestatus":"0",
    "operatorname":"webservices@example.com",
    "livestatus":"0",
    "paysafeminage":"18",
    "paysafekyclevel":"SIMPLE",
    "paysafecountryrestriction":"DE",
    "paysafeid":"23842"
  }],
  "secrand":"zO9"
}

<responseblock version="3.67">
  <requestreference>X62d3qhev</requestreference>
  <response type="ORDER">
    <merchant>
      <operatorname>webservices@example.com</operatorname>
    </merchant>
    <customer>
      <redirecturl>https://www.paysafecard.com/etc</redirecturl>
    </customer>
    <transactionreference>1-2-345</transactionreference>
    <billing id="000001">
      <payment type="PAYSAFECARD">
        <paysafe>
          <!--Elements only returned if submitted in the request-->
          <minage>18</minage>
          <kyclevel>SIMPLE</kyclevel>
          <countryrestriction>DE</countryrestriction>
        </paysafe>
      </payment>
    </billing>
    <timestamp>2014-11-27 12:08:04</timestamp>
    <settlement>
      <settleduedate>2014-11-27</settleduedate>
      <settlestatus>0</settlestatus>
    </settlement>
    <live>0</live>
    <error>
      <message>Ok</message>
      <code>0</code>
    </error>
    <operation>
      <accounttypedescription>ECOM</accounttypedescription>
    </operation>
    <paysafe id="23842"/>
  </response>
  <secrand>vSQ</secrand>
</responseblock>

Feldspezifikation

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Der zurückgegebene Wert ist "ECOM".
customerredirecturl XPath: /customer/redirecturl	URL (500)	Sie müssen den Browser des Kunden auf diese URL umleiten, um mit der Zahlung fortzufahren.
errorcode XPath: /error/code	Numerisch (1-5)	Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht. Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich. Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
errormessage XPath: /error/message	Alphanumerisch (255)	Dies ist die entsprechende Meldung zum obigen Code. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
livestatus XPath: /live	Numerisch (1)	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
operatorname XPath: /merchant/operatorname	Alphanumerisch (255)	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Der zurückgegebene Wert ist "PAYSAFECARD".
paysafeid XPath: /paysafe/@id	Alphanumerisch (255)	Eine eindeutige ID, die der Transaktion von paysafecard zugewiesen wurde. Sie können diese IDs für zukünftige Korrespondenz mit paysafecard speichern.
requesttypedescription XPath: /@type	Alpha (20)	Der zurückgegebene Wert ist "ORDER".
settleduedate XPath: /settlement/settleduedate	Datum JJJJ-MM-TT	Das Datum, an dem die Transaktion abgewickelt wird.
settlestatus XPath: /settlement/settlestatus	Numerisch (3)	"0" bedeutet, dass bisher keine Probleme aufgetreten sind, die die Durchführung von Abrechnung verhindern würden. "3" bedeutet, dass die Anfrage erfolglos war.
transactionreference XPath: /transactionreference	Alphanumerisch einschließlich Bindestriche (25)	Eine eindeutige Referenz für die Anfrage, die von Trust Payments zugewiesen wird. Diese Referenz müssen Sie in dem folgenden Antrag AUTH angeben.
transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Der Zeitpunkt, zu dem die Anfrage bearbeitet wurde.
errordata XPath: /error/data	Alphanumerisch (255)	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
paysafecountryrestriction XPath: /billing/payment/paysafe/countryrestriction	Alpha (2)	Schränkt ein, dass die Zahlung ausschließlich aus dem angegebenen Land (im iso2a-Format) abgewickelt wird. z. B. "GB" für das Vereinigte Königreich. Klicken Sie hier für eine vollständige Liste der Ländercodes. Wird zurückgesendet, wenn es in der Anfrage ORDER angegeben wurde.
paysafekyclevel XPath: /billing/payment/paysafe/kyclevel	Alpha (6)	Gibt die erforderliche KYC-Stufe für den "myPaysafe" Kontoinhaber an. Es gibt zwei Stufen: "SIMPLE" - Der Kunde hat die Erstregistrierung erfolgreich abgeschlossen und seine Handynummer und E-Mail Adresse bestätigt. "FULL" - Zusätzlich zu den oben genannten Angaben hat der Kunde einen Ausweis (z. B. Reisepass, Führerschein) und einen Adressnachweis (z. B. Rechnung eines Versorgungsunternehmens) vorgelegt. Wird zurückgesendet, wenn es in der Anfrage ORDER angegeben wurde.
paysafeminage XPath: /billing/payment/paysafe/minage	Numerisch (3)	Das Mindestalter des Kontoinhabers von "myPaysafe", wie in der Anfrage von ORDER angegeben. Wird zurückgesendet, wenn es in der Anfrage ORDER angegeben wurde.

2. Weiterleiten an paysafecard

Nach erfolgreicher Übermittlung einer ORDER Anfrage, erhält Ihr System eine customerredirecturl in der Antwort. Ihr System muss den Kunden zu dieser URL umleiten, die eine von paysafecard gehostete Seite ist, um die Zahlung zu verarbeiten.

Beim Testen werden Sie auf die Sandbox-Seite von paysafecardweitergeleitet, die die Seite simuliert, die Ihren Kunden angezeigt wird (siehe Screenshot unten).

Der Kunde hat die Wahl zwischen zwei Möglichkeiten:

Eingabe der auf der Karte befindlichen PIN (bei Bedarf können mehrere PINs eingegeben werden).
Sie melden sich bei ihrem "myPaysafe" Konto an.

Der Kunde kann mit der Zahlung fortfahren, indem er auf die Schaltfläche "Zahlen" klickt.

Wenn Sie in der ORDER Anfrage bestimmte Einschränkungen angeben (z.B. ein Mindestalter), kann der Kunde gezwungen sein, sich in sein "myPaysafe" Konto einzuloggen, um seine Angaben zu überprüfen (z.B. um sein Alter zu kontrollieren). Weitere Informationen finden Sie in den eigenen Ressourcen von paysafecard (Link zu externer Seite).

Bei erfolgreicher Authentifizierung

Der Browser des Kunden wird auf die Seite returnurl in der Anfrage ORDER angegeben.

Die Zahlung ist erst abgeschlossen, wenn Sie die unten beschriebene Anfrage AUTH erfolgreich bearbeitet haben.

Sie müssen warten, bis der Kunde von paysafecard zurück zum returnurl die auf Ihren Servern gehostet werden, bevor Sie fortfahren.

Wenn der Kunde storniert

Der Kunde kann die Bestellung abbrechen, indem er auf das Kreuz oben rechts klickt. Dadurch wird der Browser des Kunden auf die Seite cancelurl die in der Anfrage ORDER angegeben sind. Sie können dann alternative Zahlungsmöglichkeiten anbieten. Wenn der Kunde es noch einmal mit paysafecard versuchen möchte, müssen Sie eine neue ORDER Anfrage einreichen.

Beim Testen wird Ihnen die von paysafecard bereitgestellte Sandbox angezeigt. Um eine Testtransaktion durchzuführen, müssen Sie den Anweisungen auf dem Bildschirm folgen. Bitte wenden Sie sich an Ihren Kundenbetreuer, um die Test-Zugangsdaten zu erhalten, die Sie in der Sandbox eingeben müssen.

3. Bearbeitung der Autorisierungen

Wird der Kunde auf die Seite cancelurl:

Bieten Sie Ihren Kunden alternative Zahlungsmöglichkeiten an, damit sie es noch einmal versuchen können.

Wird der Kunde auf die Seite returnurl:

Befolgen Sie die nachstehenden Anweisungen.

AUTH Beispiel anfordern

Dieses Beispiel zeigt, wie eine AUTH Anfrage für paysafecard verarbeitet wird.

#!/usr/bin/python
import securetrading

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

auth = {
  "requesttypedescription": "AUTH",
  "sitereference": "test_site12345",
  "parenttransactionreference": "72-32-20002",
  "paymenttypedescription": "PAYSAFECARD"
}

strequest = securetrading.Request()
strequest.update(auth)
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(
  'requesttypedescription' => 'AUTH',
  'sitereference' => 'test_site12345',
  'parenttransactionreference' => '72-32-20002',
  'paymenttypedescription' => 'PAYSAFECARD'
);

$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": [{
    "requesttypedescription": "AUTH",
    "sitereference": "test_site12345",
    "parenttransactionreference": "72-32-20002",
    "paymenttypedescription": "PAYSAFECARD"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescription":"AUTH",
    "sitereference":"test_site12345",
    "parenttransactionreference":"72-32-20002",
    "paymenttypedescription":"PAYSAFECARD"
  }]
}

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="AUTH">
    <operation>
      <sitereference>test_site12345</sitereference>
      <parenttransactionreference>1-2-345</parenttransactionreference>
    </operation>
    <billing>
      <payment type="PAYSAFECARD"/>
    </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
parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Geben Sie in dem Antrag die transactionreference der vorangegangenen ORDER.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Dieser Wert muss als "PAYSAFECARD" angegeben werden.
requesttypedescription XPath: /@type	Alpha (20)	Der Wert in der Anfrage muss "AUTH" lauten.
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.

AUTH Antwortbeispiel

Hier ist ein Beispiel für eine Antwort von AUTH für paysafecard.

{
u 'requestreference': u 'A0dcb11e6',
u 'version': u '1.00',
u 'responses': [{
u 'transactionreference': u '72-32-20004',
u 'merchantname': u 'Test Merchant',
u 'paymenttypedescription': u 'PAYSAFECARD',
u 'transactionstartedtimestamp': u '2016-12-23 15:36:31',
u 'errormessage': u 'Ok',
u 'parenttransactionreference': u '72-32-20003',
u 'accounttypedescription': u 'ECOM',
u 'errorcode': u '0',
u 'settleduedate': u '2017-05-30',
u 'currencyiso3a': u 'GBP',
u 'baseamount': u '2001',
u 'requesttypedescription': u 'AUTH',
u 'operatorname': u 'webservices@example.com',
u 'livestatus': u '0',
u 'settlestatus': u '0',
u 'paysafeminage': u '18',
u 'paysafekyclevel': u 'SIMPLE',
u 'paysafecountryrestriction': u 'DE',
u 'paysafeid': u '23842'
}]
}

array(3) {
  ["requestreference"] => string(9) "A58cdfkpy"
  ["version"] => string(4) "1.00"
  ["responses"] => array(1) {
    [1] =>array(19) {
      ["transactionreference"] => string(11) "72-32-20004"
      ["merchantname"] => string(13) "Test Merchant"
      ["paymenttypedescription"] => string(11) "PAYSAFECARD"
      ["transactionstartedtimestamp"] => string(19) "2016-12-23 15:36:31"
      ["errormessage"] => string(2) "Ok"
      ["parenttransactionreference"] => string(11) "72-32-20003"
      ["accounttypedescription"] => string(4) "ECOM"
      ["errorcode"] => string(1) "0"
      ["settleduedate"] => string(10) "2017-05-30"
      ["currencyiso3a"] => string(3) "GBP"
      ["baseamount"] => string(4) "2001"
      ["requesttypedescription"] => string(4) "AUTH"
      ["operatorname"] => string(23) "webservices@example.com"
      ["livestatus"] => string(1) "0"
      ["settlestatus"] => string(1) "0"
      ["paysafeminage"] => string(2) "18"
      ["paysafekyclevel"] => string(6) "SIMPLE"
      ["paysafecountryrestriction"] => string(2) "DE"
      ["paysafeid"] => string(5) "23842"
    }
  }
}

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "transactionreference":"72-32-20004",
    "merchantname":"Test Merchant",
    "paymenttypedescription":"PAYSAFECARD",
    "transactionstartedtimestamp":"2016-12-23 15:36:31",
    "errormessage":"Ok",
    "parenttransactionreference":"72-32-20003",
    "accounttypedescription":"ECOM",
    "errorcode":"0",
    "settleduedate":"2017-05-30",
    "currencyiso3a":"GBP",
    "baseamount":"2001",
    "requesttypedescription":"AUTH",
    "operatorname":"webservices@example.com",
    "livestatus":"0",
    "settlestatus":"0",
    "paysafeminage":"18",
    "paysafekyclevel":"SIMPLE",
    "paysafecountryrestriction":"DE",
    "paysafeid":"23842"
  }],
  "secrand":"zO9"
}

<responseblock version="3.67">
  <requestreference>X538160153</requestreference>
  <response type="AUTH">
    <merchant>
      <merchantname>My Test Site</merchantname>
      <merchantnumber>00000000</merchantnumber>
      <operatorname>webservices@example.com</operatorname>
    </merchant>
    <transactionreference>1-2-347</transactionreference>
    <timestamp>2016-09-30 16:40:02</timestamp>
    <operation>
      <parenttransactionreference>1-2-346</parenttransactionreference>
      <accounttypedescription>ECOM</accounttypedescription>
    </operation>
    <settlement>
      <settleduedate>2016-10-01</settleduedate>
      <settlestatus>100</settlestatus>
    </settlement>
    <billing>
      <amount currencycode="GBP">100</amount>
      <payment type="PAYSAFECARD">
        <paysafe>
          <minage>18</minage>
          <kyclevel>SIMPLE</kyclevel>
          <countryrestriction>DE</countryrestriction>
        </paysafe>
      </payment>
    </billing>
    <live>0</live>
    <error>
      <message>Ok</message>
      <code>0</code>
    </error>
    <paysafe id="23842"/>
  </response>
  <secrand>7iNleP44</secrand>
</responseblock>

Feldspezifikation

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Der zurückgegebene Wert ist "ECOM".
baseamount XPath: /billing/amount	Numerisch (11)	Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, so dass €10 als 1000 zurückgegeben werden.
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die Währung, in der die Transaktion verarbeitet wurde (im ISO3A-Format).
errorcode XPath: /error/code	Numerisch (1-5)	Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht. Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich. Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
errormessage XPath: /error/message	Alphanumerisch (255)	Dies ist die entsprechende Meldung zum obigen Code. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
livestatus XPath: /live	Numerisch (1)	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
operatorname XPath: /merchant/operatorname	Alphanumerisch (255)	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche (25)	Die transactionreference der vorangegangenen ORDER.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Der zurückgegebene Wert ist "PAYSAFECARD".
paysafeid XPath: /paysafe/@id	Alphanumerisch (255)	Eine eindeutige ID, die der Transaktion von paysafecard zugewiesen wurde. Sie können diese IDs für zukünftige Korrespondenz mit paysafecard speichern.
requesttypedescription XPath: /@type	Alpha (20)	Der zurückgegebene Wert ist "AUTH".
settleduedate XPath: /settlement/settleduedate	Datum JJJJ-MM-TT	Das Datum, an dem die Transaktion abgewickelt wird.
settlestatus XPath: /settlement/settlestatus	Numerisch (3)	"100" bedeutet, dass die Mittel sofort eingezogen werden. "3" bedeutet, dass die Anfrage erfolglos war.
transactionreference XPath: /transactionreference	Alphanumerisch einschließlich Bindestriche (25)	Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird.
transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
errordata XPath: /error/data	Alphanumerisch (255)	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
merchantname XPath: /merchant/merchantname	Alphanumerisch (255)	Es handelt sich dabei um Angaben zu dem Konto, über das die Transaktion abgewickelt wird. Wenn Sie diese Felder ändern möchten, wenden Sie sich bitte an unser Support-Team. Hängt von der Konfiguration Ihres Kontos ab.
paysafecountryrestriction XPath: /billing/payment/paysafe/countryrestriction	Alpha (2)	Schränkt ein, dass die Zahlung ausschließlich aus dem angegebenen Land (im iso2a-Format) abgewickelt wird. z. B. "GB" für das Vereinigte Königreich. Klicken Sie hier für eine vollständige Liste der Ländercodes. Wird zurückgesendet, wenn es in der Anfrage ORDER angegeben wurde.
paysafekyclevel XPath: /billing/payment/paysafe/kyclevel	Alpha (6)	Gibt die erforderliche KYC-Stufe für den "myPaysafe" Kontoinhaber an. Es gibt zwei Stufen: "SIMPLE" - Der Kunde hat die Erstregistrierung erfolgreich abgeschlossen und seine Handynummer und E-Mail Adresse bestätigt. "FULL" - Zusätzlich zu den oben genannten Angaben hat der Kunde einen Ausweis (z. B. Reisepass, Führerschein) und einen Adressnachweis (z. B. Rechnung eines Versorgungsunternehmens) vorgelegt. Wird zurückgesendet, wenn es in der Anfrage ORDER angegeben wurde.
paysafeminage XPath: /billing/payment/paysafe/minage	Numerisch (3)	Das Mindestalter des Kontoinhabers von "myPaysafe", wie in der Anfrage von ORDER angegeben. Wird zurückgesendet, wenn es in der Anfrage ORDER angegeben wurde.

Benachrichtigungen

Bevor Sie mit den Tests beginnen, empfehlen wir Ihnen, sich mit unserem Support-Team in Verbindung zu setzen und zu beantragen, dass in Ihrem Konto Regeln aktiviert werden, die URL-Benachrichtigungen an Ihr System übermitteln, wenn eine Zahlung autorisiert wurde.

Konfigurieren der Benachrichtigung

Wir empfehlen, mindestens die folgenden Felder in URL-Benachrichtigungen auf Autorisierung aufzunehmen:

Basisbetrag (baseamount) (z.B. £10.50 ist "1050")*
Hauptbetrag (mainamount) (z.B. £10.50 ist "10.50")*
Rechnungsland (billingcountryiso2a)
Währung (currencyiso3a)
Fehlercode (errorcode)
Live-Status (livestatus)
Bestellnummer (orderreference)
Zahlungsart (paymenttypedescription)
Anforderungstyp (requesttypedescription)
Abrechnungsstatus (settlestatus)
Website-Referenz (sitereference)
Transaktionsnummer (transactionreference)
Zeitstempel Transaktionsstart (transactionstartedtimestamp)

*Bitte wählen Sie Ihr bevorzugtes Format.

Prüfen Sie die Benachrichtigung

Sie müssen den Inhalt jeder eingegangenen Meldung prüfen und entsprechend reagieren, indem Sie die in unserer Website beschriebenen Verfahren befolgen. URL-Benachrichtigungen Dokumentation. Insbesondere müssen Sie sich die settlestatus Wert:

Wenn die settlestatus 100" ist, bedeutet dies, dass die Zahlung genehmigt wurde und der Betrag auf Ihrem Konto eingegangen ist.
Alternativ, wenn die settlestatus ist "3", bedeutet dies, dass ein Fehler aufgetreten ist und die Zahlung storniert wurde. Sie können die errorcode um die Ursache des Fehlers zu ermitteln.

Abrechnung

Sofern die Anfragen erfolgreich waren, wird der Betrag unmittelbar nach Abschluss der Zahlung durch den Kunden überwiesen. Sie können die Transaktionen von paysafecard nicht mehr stornieren oder anderweitig aktualisieren, nachdem Sie die Anfrage an AUTH gestellt haben.

Payouts

Sie können Payout Anfragen mit der Webservices API verarbeiten, um Geld auf das "myPaysafe" Konto des Kunden zu überweisen.

Sie müssen eine paysafecard CFT Händlernummer haben, die mit Ihrem Trust Payments Konto verbunden ist. Wenn Sie sich nicht sicher sind, ob Ihre Händlernummer dies unterstützt, empfehlen wir Ihnen, sich an paysafecard zu wenden, um dies zu klären. Vergewissern Sie sich außerdem, dass Sie alle Richtlinien von paysafecard befolgen, bevor Sie fortfahren.

Es gibt zwei Möglichkeiten, das Konto des Kunden in der Anfrage zu identifizieren. Sie können sich für eine der beiden entscheiden:

customeraccountnumber und customeraccountnumbertype (wie in den folgenden Beispielen gezeigt)
OR die billingemail

Nach einer erfolgreichen Payout werden die Gelder sofort auf das Konto "myPaysafe" des Kunden überwiesen. Sie können paysafecard Payouts nach Abrechnung nicht stornieren oder anderweitig aktualisieren.

Anhand der Beispiele und des Feldschemas unten erfahren Sie, wie eine Payout -Anfrage an Trust Payments aufgebaut ist und was Sie in der Antwort erwarten können.

Payout Beispiel anfordern

Dieses Beispiel zeigt, wie eine Payout Anfrage für paysafecard verarbeitet wird.

#!/usr/bin/python
import securetrading

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

auth = {
  "requesttypedescription": "REFUND",
  "sitereference": "test_site12345",
  "accounttypedescription": "CFT",
  "billingid": "000001",
  "currencyiso3a": "GBP",
  "baseamount": "2001",
  "paymenttypedescription": "PAYSAFECARD",
  "billingdob": "2012-01-26",
  "billingfirstname": "Joe",
  "billinglastname": "Bloggs",
  "customeraccountnumbertype": "ACCOUNT",
  "customeraccountnumber": "123456789012"
}

strequest = securetrading.Request()
strequest.update(auth)
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(
  'requesttypedescription' => 'REFUND',
  'sitereference' => 'test_site12345',
  'accounttypedescription' => 'CFT',
  'billingid' => '000001',
  'currencyiso3a' => 'GBP',
  'baseamount' => '2001',
  'paymenttypedescription' => 'PAYSAFECARD',
  'billingdob' => '2012-01-26',
  'billingfirstname' => 'Joe',
  'billinglastname' => 'Bloggs',
  'customeraccountnumbertype' => 'ACCOUNT',
  'customeraccountnumber' => '123456789012'
);

$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": [{
    "requesttypedescription":"REFUND",
    "sitereference":"test_site12345",
    "accounttypedescription":"CFT",
    "billingid":"000001",
    "currencyiso3a":"GBP",
    "baseamount":"2001",
    "paymenttypedescription":"PAYSAFECARD",
    "billingdob":"2012-01-26",
    "billingfirstname":"Joe",
    "billinglastname":"Bloggs",
    "customeraccountnumbertype":"ACCOUNT",
    "customeraccountnumber":"123456789012"
  }]
}'

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescription":"REFUND",
    "sitereference":"test_site12345",
    "accounttypedescription":"CFT",
    "billingid":"000001",
    "currencyiso3a":"GBP",
    "baseamount":"2001",
    "paymenttypedescription":"PAYSAFECARD",
    "billingdob":"2012-01-26",
    "billingfirstname":"Joe",
    "billinglastname":"Bloggs",
    "customeraccountnumbertype":"ACCOUNT",
    "customeraccountnumber":"123456789012"
  }]
}'

<requestblock version="3.67">
  <alias>webservices@example.com</alias>
  <request type="REFUND">
    <operation>
      <sitereference>test_site12345</sitereference>
      <accounttypedescription>CFT</accounttypedescription>
    </operation>
    <billing id="000001">
      <amount currencycode="GBP">2001</amount>
      <payment type="PAYSAFECARD"/>
      <dob>2012-01-26</dob>
      <name>
        <first>Joe</first>
        <last>Bloggs</last>
      </name>
    </billing>
    <customer>
      <accountnumber type="ACCOUNT">123456789012</accountnumber>
    </customer>
  </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)	Der Wert in der Anfrage muss "CFT" lauten.
baseamount XPath: /billing/amount	Numerisch (11)	Der Auszahlungsbetrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. €10 werden als 1000 eingegeben. Dieser Wert muss größer als Null sein.
billingdob XPath: /billing/dob	Datum JJJJ-MM-TT	Das Geburtsdatum des Kunden.
billingfirstname XPath: /billing/name/first	Alphanumerisch einschließlich Symbole (127)	Der Vorname des Kunden.
billingid XPath: /billing/@id	Alphanumerisch (100)	Eine von Ihnen bereitgestellte Kennung, die zur Identifizierung des Kunden dient. Sie müssen immer eine billingid: Jedem Kunden muss eine eindeutige ID zugewiesen werden. Dieser Ausweis muss von wiederkehrenden Kunden wiederverwendet werden.
billinglastname XPath: /billing/name/last	Alphanumerisch einschließlich Symbole (127)	Der Nachname des Kunden.
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die Währung , in der die Transaktion verarbeitet werden soll (im ISO3A-Format). Eine Liste der Währung Codes, die von paysafecard unterstützt werden, finden Sie in der Liste oben auf dieser Seite.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Dieser Wert muss als "PAYSAFECARD" angegeben werden.
requesttypedescription XPath: /@type	Alpha (20)	Der Wert in der Anfrage muss "REFUND" lauten.
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.
billingemail XPath: /billing/email	E-Mail (255)	Muss die E-Mail sein, die der Kunde bei der Registrierung für "myPaysafe" verwendet hat. Erforderlich, wenn customeraccountnumber und customeraccountnumbertype nicht vorgelegt.
customeraccountnumber XPath: /customer/accountnumber	Numerisch (12)	Id des "myPaysafe" Kontos des Kunden. Erforderlich, wenn billingemail nicht vorgelegt.
customeraccountnumbertype XPath: /customer/accountnumber/@type	Alpha (7)	Der Wert in der Anfrage muss "ACCOUNT" sein. Erforderlich, wenn billingemail nicht vorgelegt.

Payout Antwortbeispiel

Hier ist ein Beispiel für eine erfolgreiche Payout Antwort für paysafecard.

{
u 'requestreference': u 'A0dcb11e6',
u 'version': u '1.00',
u 'responses': [{
u 'requesttypedescription': u 'REFUND',
u 'acquirertransactionreference': u '1234-5678-9012-3456',
u 'baseamount': u '2001',
u 'currencyiso3a': u 'GBP',
u 'paymenttypedescription': u 'PAYSAFECARD',
u 'customeraccountnumbertype': u 'ACCOUNT',
u 'maskedcustomeraccountnumber': u '123456##9012',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'livestatus': u '0',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '00000000',
u 'operatorname': u 'webservices@example.com',
u 'accounttypedescription': u 'CFT',
u 'paysafeid': u '23843',
u 'settleduedate': u '2022-02-08',
u 'settlestatus': u '100',
u 'transactionstartedtimestamp': u '2022-02-08 14:39:18',
u 'transactionreference': u '1-2-347'
}]
}

array(3) {
  ["requestreference"] => string(9) "A58cdfkpy"
  ["version"] => string(4) "1.00"
  ["responses"] => array(1) {
    [1] =>array(19) {
      ["requesttypedescription"] => string(6) "REFUND"
      ["acquirertransactionreference"] => string(19) "1234-5678-9012-3456"
      ["baseamount"] => string(4) "2001"
      ["currencyiso3a"] => string(3) "GBP"
      ["paymenttypedescription"] => string(11) "PAYSAFECARD"
      ["customeraccountnumbertype"] => string(7) "ACCOUNT"
      ["maskedcustomeraccountnumber"] => string(12) "123456##9012"
      ["errorcode"] => string(1) "0"
      ["errormessage"] => string(2) "Ok"
      ["livestatus"] => string(1) "0"
      ["merchantname"] => string(13) "Test Merchant"
      ["merchantnumber"] => string(8) "00000000"
      ["operatorname"] => string(23) "webservices@example.com"
      ["accounttypedescription"] => string(3) "CFT"
      ["paysafeid"] => string(5) "23843"
      ["settleduedate"] => string(10) "2022-02-08"
      ["settlestatus"] => string(3) "100"
      ["transactionstartedtimestamp"] => string(19) "2022-02-08 14:39:18"
      ["transactionreference"] => string(7) "1-2-347"
    }
  }
}

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "requesttypedescription":"REFUND",
    "acquirertransactionreference":"1234-5678-9012-3456",
    "baseamount":"2001",
    "currencyiso3a":"GBP",
    "paymenttypedescription":"PAYSAFECARD",
    "customeraccountnumbertype":"ACCOUNT",
    "maskedcustomeraccountnumber":"123456##9012",
    "errorcode":"0",
    "errormessage":"Ok",
    "livestatus":"0",
    "merchantname":"Test Merchant",
    "merchantnumber":"00000000",
    "operatorname":"webservices@example.com",
    "accounttypedescription":"CFT",
    "paysafeid":"23843",
    "settleduedate":"2022-02-08",
    "settlestatus":"100",
    "transactionstartedtimestamp":"2022-02-08 14:39:18",
    "transactionreference":"1-2-347"
  }],
  "secrand":"789"
}

<responseblock version="3.67">
  <requestreference>X19vnxntc</requestreference>
  <response type="REFUND">
    <acquirertransactionreference>1234-5678-9012-3456</acquirertransactionreference>
    <billing>
      <amount currencycode="GBP">2001</amount>
      <payment type="PAYSAFECARD"/>
    </billing>
    <customer>
      <accountnumber type="ACCOUNT">123456##9012</accountnumber>
    </customer>
    <error>
      <code>0</code>
      <message>Ok</message>
    </error>
    <live>0</live>
    <merchant>
      <merchantname>Test Merchant</merchantname>
      <merchantnumber>00000000</merchantnumber>
      <operatorname>webservices@example.com</operatorname>
    </merchant>
    <operation>
      <accounttypedescription>CFT</accounttypedescription>
    </operation>
    <paysafe id="23843"/>
    <settlement>
      <settleduedate>2022-02-08</settleduedate>
      <settlestatus>100</settlestatus>
    </settlement>
    <timestamp>2022-02-08 14:39:18</timestamp>
    <transactionreference>1-2-347</transactionreference>
  </response>
  <secrand>789</secrand>
</responseblock>

Feldspezifikation

Feld	Format	Beschreibung
accounttypedescription XPath: /operation/accounttypedescription	Alpha (20)	Der zurückgegebene Wert ist "CFT".
acquirertransactionreference XPath: /acquirertransactionreference	Alphanumerisch einschließlich Symbole (127)	Einzigartige Transaktionsnummer zugewiesen von paysafecard.
baseamount XPath: /billing/amount	Numerisch (11)	Der Auszahlungsbetrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte, so dass €10 als 1000 zurückgegeben werden.
currencyiso3a XPath: /billing/amount/@currencycode	Alpha (3)	Die Währung, in der die Transaktion verarbeitet wurde (im ISO3A-Format).
errorcode XPath: /error/code	Numerisch (1-5)	Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht. Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich. Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
errormessage XPath: /error/message	Alphanumerisch (255)	Dies ist die entsprechende Meldung zum obigen Code. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.
livestatus XPath: /live	Numerisch (1)	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
operatorname XPath: /merchant/operatorname	Alphanumerisch (255)	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
paymenttypedescription XPath: /billing/payment/@type	Alpha (20)	Der zurückgegebene Wert ist "PAYSAFECARD".
paysafeid XPath: /paysafe/@id	Alphanumerisch (255)	Eine eindeutige ID, die der Transaktion von paysafecard zugewiesen wurde. Sie können diese IDs für zukünftige Korrespondenz mit paysafecard speichern.
requesttypedescription XPath: /@type	Alpha (20)	Der zurückgegebene Wert ist "REFUND".
settleduedate XPath: /settlement/settleduedate	Datum JJJJ-MM-TT	Das Datum, an dem die Transaktion abgewickelt wird.
settlestatus XPath: /settlement/settlestatus	Numerisch (3)	"100" bedeutet, dass die Mittel sofort eingezogen werden. "3" bedeutet, dass die Anfrage erfolglos war.
transactionreference XPath: /transactionreference	Alphanumerisch einschließlich Bindestriche (25)	Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird.
transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
customeraccountnumbertype XPath: /customer/accountnumber/@type	Alpha (7)	Der zurückgegebene Wert ist "ACCOUNT". Wird nur zurückgesendet, wenn es im Antrag angegeben wurde.
errordata XPath: /error/data	Alphanumerisch (255)	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
maskedcustomeraccountnumber XPath: /customer/accountnumber	Numerisch & # (20)	Maskierte ID des "myPaysafe" Kontos des Kunden. Wird nur zurückgesendet, wenn es im Antrag angegeben wurde.
merchantname XPath: /merchant/merchantname	Alphanumerisch (255)	Es handelt sich dabei um Angaben zu dem Konto, über das die Transaktion abgewickelt wird. Wenn Sie diese Felder ändern möchten, wenden Sie sich bitte an unser Support-Team. Hängt von der Konfiguration Ihres Kontos ab.
merchantnumber XPath: /merchant/merchantnumber	Alphanumerisch (32)	Die Händlernummer, die zur Bearbeitung der Transaktion verwendet wurde. Wird von der erwerbenden Bank zur Verfügung gestellt. Hängt von der Konfiguration Ihres Kontos ab.

Zusätzliche Hinweise

Betrugsprävention

Betrug und doppelte Kontrollen

Betrugs- und Dublettenprüfungen werden bei paysafecard nicht durchgeführt.

Adressprüfdienst (AVS) prüft

AVS Prüfungen können nicht für paysafecard Transaktionen durchgeführt werden.

Gesperrte Karten

paysafecards können auf Wunsch des Kunden gesperrt werden, um alle weiteren Käufe zu verhindern.

Klicken Sie hier für weitere Informationen (Link zu externer Seite).

Wenn der Kunde seine PIN nicht eingibt

Nach der Durchführung der Anfrage ORDER und dem Erhalt einer erfolgreichen Antwort hat der Kunde 30 Minuten Zeit, um seine Zahlungsdaten auf der Website paysafecardeinzugeben. Danach wird die Zahlung von paysafecard als "abgelaufen" gekennzeichnet und der Kunde muss mit einer neuen ORDER erneut beginnen.

Konto-Typ

Nur "ECOM" (e-commerce) wird als Kontotyp für paysafecard Transaktionen unterstützt. Der Kunde muss zum Zeitpunkt des Kaufs anwesend sein, um seine PIN einzugeben oder sich bei seinem Konto anzumelden.

iframes

Die Seite paysafecard-hosted kann in einem iframe gehostet werden.

Erlauben Sie immer vertikales Scrollen oder dynamische Größenanpassung. Maximale Höhe von 840px.

Die paysafecard-Zahlungsseite ist automatisch für mobile Geräte optimiert.

Wenn ein Kunde ein Gerät mit einer Auflösung von weniger als 600px Breite verwendet, wird automatisch ein für mobile Geräte optimiertes Zahlungspanel angezeigt. Dies ist auch der Fall, wenn das eingebettete iframe eine geringere Breite als 600px hat.

Weitere Lektüre zu diesem Thema