PaysafeCard for Webservices API

  Zuletzt aktualisiert: 

PaysafeCard

A PaysafeCard ist ein Prepaid-Gutschein, der vom Zahlungsunternehmen PaySafe herausgegeben wird und von Ihren Kunden in Verkaufsstellen auf der ganzen Welt erworben werden kann (z. B. in PayPoint-Filialen). Jeder Gutschein wird durch eine eindeutige PIN identifiziert. Die PaysafeCard ist besonders beliebt in den Bereichen Online-Gaming, Streaming und digitale Dienstleistungen.

Kunden können optional ein PaysafeCard registrieren, um ihre PINs zu speichern, Gutscheinsalden zusammenzuführen, ihre Transaktionshistorie einzusehen und vieles mehr.

Um einen Einkauf abzuschließen, geben die Kunden entweder ihre Gutschein-PIN an der Kasse ein oder melden sich bei ihrem PaysafeCard an, um von ihrem Guthaben 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 Bezahlvorgangs 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 zu Paysafe weitergeleitet, wo er entweder seine PIN(s) eingibt oder sich bei seinem PaysafeCard anmeldet.
  • Der Kunde überprüft seine Bestellung und stimmt der Zahlung zu.
  • Der Kunde wird auf Ihre Website weitergeleitet, wo eine Bestätigung angezeigt wird (z. B. "Zahlung erfolgreich").
Warenkorb Seite
Detailseite
Paysafe-Seite
Antwortseite

 

Wie funktioniert das hinter den Kulissen?

Der PaysafeCard kann in drei Hauptteile unterteilt werden, wie unten dargestellt:


  1. Initiieren Sie den Kunden
    • Der Kunde erklärt sich mit einer Zahlung mit 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.

  2. Weiterleitung zu PaysafeCard
    • Der Händler leitet den Browser des Kunden auf die customerredirecturl.
    • Der Kunde gibt die PIN(s) ein, die sich auf seiner PaysafeCard befinden, oder meldet sich an.
    • Bei Erfolg wird der Browser des Kunden auf die Seite returnurl.

        Wenn die PaysafeCard storniert 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.

  3. 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 der Kunde mit PaysafeCard bezahlen möchte, muss Ihr System eine ORDER durchführen und die zurückgegebene Antwort interpretieren.

 

ORDER Beispiel anfordern

Python PHP cURL Rohes JSON Rohes XML
#!/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

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Vollständige Domainliste anzeigen.

 

Feldspezifikation

  Feld Format Beschreibung
  Erforderlich accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Nur "ECOM" (E-Commerce) wird unterstützt.
  Erforderlich 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.
  Erforderlich 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.
  Erforderlich cancelurl
XPath: /merchant/cancelurl
URL (2048) Die URL, zu der der Kunde zurückgeführt wird, wenn er die Autorisierung auf den Servern von Paysafe widerruft.
  Erforderlich currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3) Die Währung , in der die Transaktion abgewickelt werden soll. PaysafeCard 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

Weitere Informationen zu den Währung finden Sie hier.

  Erforderlich paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Dieser Wert muss als "PAYSAFECARD" angegeben werden.
  Erforderlich requesttypedescription
XPath: /@type
Alpha (20) Der Wert in der Anfrage muss "ORDER" lauten.
  Erforderlich returnurl
XPath: /merchant/returnurl
URL (2048) Die URL, zu der der Kunde nach der Bestätigung der Zahlung durch Paysafe zurückgeführt wird.
  Erforderlich 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.
  Optional 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.
  Optional 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.

Vollständige Liste der Ländercodes anzeigen.

  Optional paysafekyclevel
XPath: /billing/payment/paysafe/kyclevel
Alpha (6)

Gibt die erforderliche KYC-Stufe für den PaysafeCard 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.
  Optional paysafeminage
XPath: /billing/payment/paysafe/minage
Numerisch (3) Gibt das Mindestalter des PaysafeCard an.

Wenn Sie z. B. nur über 18-Jährige zulassen möchten, geben Sie in diesem Feld "18" ein.

 

ORDER Antwortbeispiel

Python PHP Rohes JSON Rohes XML
{
'requestreference': 'A0bxh87wt',
'version': '1.00',
'responses': [{
'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'
}]
}

 

Feldspezifikation

  Feld Format Beschreibung
  Zurückgeschickt accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Der zurückgegebene Wert ist "ECOM".
  Zurückgeschickt customerredirecturl
XPath: /customer/redirecturl
URL (500) Sie müssen den Browser des Kunden auf diese URL umleiten, um mit der Zahlung fortzufahren.
  Zurückgeschickt 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.

Vollständige Liste der errorcode und Nachrichtenwerte.

  Zurückgeschickt errormessage
XPath: /error/message
Alphanumerisch (255) Dies ist die entsprechende Meldung zum obigen Code.

Vollständige Liste der errorcode und Nachrichtenwerte.

  Zurückgeschickt livestatus
XPath: /live
Numerisch (1)
  • 0 - Die Transaktion wurde über ein Testkonto abgewickelt.
  • 1 - Transaktion wird über ein Live-Konto abgewickelt.
  Zurückgeschickt operatorname
XPath: /merchant/operatorname
Alphanumerisch (255) Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
  Zurückgeschickt paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Der zurückgegebene Wert ist "PAYSAFECARD".
  Zurückgeschickt paysafeid
XPath: /paysafe/@id
Alphanumerisch (255) Eine eindeutige ID, die der Transaktion von Paysafe zugewiesen wurde. Sie können diese IDs für zukünftige Korrespondenz mit Paysafe speichern.
  Zurückgeschickt requesttypedescription
XPath: /@type
Alpha (20) Der zurückgegebene Wert ist "ORDER".
  Zurückgeschickt settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-TT Das Datum, an dem die Transaktion abgewickelt wird.
  Zurückgeschickt 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.
  Zurückgeschickt 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.

  Zurückgeschickt transactionstartedtimestamp
XPath: /timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss Der Zeitpunkt, zu dem die Anfrage bearbeitet wurde.
  Bedingt errordata
XPath: /error/data
Alphanumerisch (255)

Zusätzliche Informationen zur Behebung des Fehlers.

Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.

  Bedingt 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.

Vollständige Liste der Ländercodes anzeigen.

Wird zurückgesendet, wenn es in der Anfrage ORDER angegeben wurde.

  Bedingt paysafekyclevel
XPath: /billing/payment/paysafe/kyclevel
Alpha (6)

Gibt die erforderliche KYC-Stufe für den PaysafeCard 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.

  Bedingt paysafeminage
XPath: /billing/payment/paysafe/minage
Numerisch (3)

Das Mindestalter des PaysafeCard , wie in der ORDER angegeben.

Wird zurückgesendet, wenn es in der Anfrage ORDER angegeben wurde.

 

2. Umleitung zu Paysafe

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

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

paysafecard: Der fällige Betrag wird angezeigt, zusammen mit der Möglichkeit, die PIN(s) einzugeben oder sich anzumelden, gefolgt von einer Erklärung, wie es funktioniert.

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 PaysafeCard an.

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

  Wenn Sie bestimmte Einschränkungen in der ORDER angeben (z.B. ein Mindestalter), kann der Kunde gezwungen sein, sich in sein PaysafeCard einzuloggen, um seine Angaben zu verifizieren (z.B. um sein Alter zu überprüfen).

 

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 Paysafe zum returnurl die auf Ihren Servern gehostet werden, bevor Sie fortfahren.

 

Wenn der Kunde storniert

Der Kunde kann die Bestellung abbrechen, indem er das Kreuz in der oberen rechten Ecke anklickt. Dadurch wird der Browser des Kunden auf die Seite cancelurl die in der ORDER angegeben sind. Sie können dann alternative Zahlungsarten anbieten. Wenn der Kunde es erneut mit PaysafeCard versuchen möchte, müssen Sie eine neue ORDER stellen.

  Beim Testen wird Ihnen die von Paysafe 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 Test-Zugangsdaten zu erhalten, die Sie in der Sandbox eingeben können.

 

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 für PaysafeCard verarbeitet wird.

Python PHP cURL Rohes JSON Rohes XML
#!/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

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Vollständige Domainliste anzeigen.

 

Feldspezifikation

  Feld Format Beschreibung
  Erforderlich parenttransactionreference
XPath: /operation/parenttransactionreference
Alphanumerisch
& Bindestriche (25)
Geben Sie in dem Antrag die transactionreference der vorangegangenen ORDER.
  Erforderlich paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Dieser Wert muss als "PAYSAFECARD" angegeben werden.
  Erforderlich requesttypedescription
XPath: /@type
Alpha (20) Der Wert in der Anfrage muss "AUTH" lauten.
  Erforderlich 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 AUTH für PaysafeCard.

Python PHP Rohes JSON Rohes XML
{
'requestreference': 'A0dcb11e6',
'version': '1.00',
'responses': [{
'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'
}]
}

 

Feldspezifikation

  Feld Format Beschreibung
  Zurückgeschickt accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Der zurückgegebene Wert ist "ECOM".
  Zurückgeschickt baseamount
XPath: /billing/amount
Numerisch (11) Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, so dass €10 als 1000 zurückgegeben werden.
  Zurückgeschickt currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3) Die Währung, in der die Transaktion verarbeitet wurde (im ISO3A-Format).
  Zurückgeschickt 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.

Vollständige Liste der errorcode und Nachrichtenwerte.

  Zurückgeschickt errormessage
XPath: /error/message
Alphanumerisch (255) Dies ist die entsprechende Meldung zum obigen Code.

Vollständige Liste der errorcode und Nachrichtenwerte.

  Zurückgeschickt livestatus
XPath: /live
Numerisch (1)
  • 0 - Die Transaktion wurde über ein Testkonto abgewickelt.
  • 1 - Transaktion wird über ein Live-Konto abgewickelt.
  Zurückgeschickt operatorname
XPath: /merchant/operatorname
Alphanumerisch (255) Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
  Zurückgeschickt parenttransactionreference
XPath: /operation/parenttransactionreference
Alphanumerisch
& Bindestriche (25)
Die transactionreference der vorangegangenen ORDER.
  Zurückgeschickt paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Der zurückgegebene Wert ist "PAYSAFECARD".
  Zurückgeschickt paysafeid
XPath: /paysafe/@id
Alphanumerisch (255) Eine eindeutige ID, die der Transaktion von Paysafe zugewiesen wurde. Sie können diese IDs für zukünftige Korrespondenz mit Paysafe speichern.
  Zurückgeschickt requesttypedescription
XPath: /@type
Alpha (20) Der zurückgegebene Wert ist "AUTH".
  Zurückgeschickt settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-TT Das Datum, an dem die Transaktion abgewickelt wird.
  Zurückgeschickt settlestatus
XPath: /settlement/settlestatus
Numerisch (3)
  • "100" bedeutet, dass die Mittel sofort eingezogen werden.
  • "3" bedeutet, dass die Anfrage erfolglos war.
  Zurückgeschickt transactionreference
XPath: /transactionreference
Alphanumerisch einschließlich
Bindestriche (25)
Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird.
  Zurückgeschickt transactionstartedtimestamp
XPath: /timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
  Bedingt errordata
XPath: /error/data
Alphanumerisch (255)

Zusätzliche Informationen zur Behebung des Fehlers.

Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.

  Bedingt 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.

  Bedingt 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.

Vollständige Liste der Ländercodes anzeigen.

Wird zurückgesendet, wenn es in der Anfrage ORDER angegeben wurde.

  Bedingt paysafekyclevel
XPath: /billing/payment/paysafe/kyclevel
Alpha (6)

Gibt die erforderliche KYC-Stufe für den PaysafeCard 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.

  Bedingt paysafeminage
XPath: /billing/payment/paysafe/minage
Numerisch (3)

Das Mindestalter des PaysafeCard , wie in der 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

Wenn die Anfragen erfolgreich waren, werden die Gelder sofort nach Abschluss der Zahlung durch den Kunden abgerechnet. Sie können PaysafeCard nicht mehr stornieren oder anderweitig aktualisieren, nachdem Sie die AUTH eingereicht haben.

 

Payouts

Sie können Payout über die Webservices verarbeiten, um Geld auf das PaysafeCard des Kunden zu überweisen.

  Sie müssen eine PaysafeCard CFT haben, die mit Ihrem Trust Payments verbunden ist. Wenn Sie sich nicht sicher sind, ob Ihre Händlernummer dies unterstützt, empfehlen wir Ihnen, sich mit Paysafe in Verbindung zu setzen, um dies zu klären. Bitte vergewissern Sie sich außerdem, dass Sie alle von Paysafe vorgegebenen Richtlinien 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 wird das Geld sofort auf das PaysafeCard des Kunden überwiesen. Sie könnenPayouts nach der 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 für PaysafeCard bearbeitet wird.

Python PHP cURL Rohes JSON Rohes XML
#!/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

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Vollständige Domainliste anzeigen.

 

Feldspezifikation

  Feld Format Beschreibung
  Erforderlich accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Der Wert in der Anfrage muss "CFT" lauten.
  Erforderlich 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.

  Erforderlich billingdob
XPath: /billing/dob
Datum JJJJ-MM-TT Das Geburtsdatum des Kunden.
  Erforderlich billingfirstname
XPath: /billing/name/first
Alphanumerisch einschließlich
Symbole (127)
Der Vorname des Kunden.
  Erforderlich 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.
  Erforderlich billinglastname
XPath: /billing/name/last
Alphanumerisch einschließlich
Symbole (127)
Der Nachname des Kunden.
  Erforderlich currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

Die Währung , in der die Transaktion verarbeitet werden soll (im ISO3A-Format).

Eine Liste der von PaysafeCard unterstützten Währung finden Sie in der Liste oben auf dieser Seite.

  Erforderlich paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Dieser Wert muss als "PAYSAFECARD" angegeben werden.
  Erforderlich requesttypedescription
XPath: /@type
Alpha (20) Der Wert in der Anfrage muss "REFUND" lauten.
  Erforderlich 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.
  Bedingt billingemail
XPath: /billing/email
E-Mail (255)

Muss die E-Mail sein, die der Kunde bei der Registrierung für sein PaysafeCard verwendet hat.

Gültige Zeichen:

  • Buchstaben A-Z, a-z
  • Ziffern 0-9
  • Gängige Sonderzeichen (außer *)
  • Maximale Länge 64 vor dem @ und 255 insgesamt.

Abgesehen von den oben genannten Anforderungen hält sich unser System an RFC 5322, das das Standardformat für gültige E-Mail-Adressen definiert. Erfahren Sie mehr über RFC 5322 (Link zu externer Seite)

Erforderlich, wenn customeraccountnumber und customeraccountnumbertype nicht vorgelegt.

  Bedingt customeraccountnumber
XPath: /customer/accountnumber
Numerisch (12)

Id des PaysafeCard des Kunden.

Erforderlich, wenn billingemail nicht vorgelegt.

  Bedingt 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 für PaysafeCard.

Python PHP Rohes JSON Rohes XML
{
'requestreference': 'A0dcb11e6',
'version': '1.00',
'responses': [{
'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'
}]
}

 

Feldspezifikation

  Feld Format Beschreibung
  Zurückgeschickt accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) Der zurückgegebene Wert ist "CFT".
  Zurückgeschickt acquirertransactionreference
XPath: /acquirertransactionreference
Alphanumerisch einschließlich Symbole (127) Eindeutige Transaktionsnummer , die von Paysafe vergeben wird.
  Zurückgeschickt baseamount
XPath: /billing/amount
Numerisch (11) Der Auszahlungsbetrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte, so dass €10 als 1000 zurückgegeben werden.
  Zurückgeschickt currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3) Die Währung, in der die Transaktion verarbeitet wurde (im ISO3A-Format).
  Zurückgeschickt 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.

Vollständige Liste der errorcode und Nachrichtenwerte.

  Zurückgeschickt errormessage
XPath: /error/message
Alphanumerisch (255) Dies ist die entsprechende Meldung zum obigen Code.

Vollständige Liste der errorcode und Nachrichtenwerte.

  Zurückgeschickt livestatus
XPath: /live
Numerisch (1)
  • 0 - Die Transaktion wurde über ein Testkonto abgewickelt.
  • 1 - Transaktion wird über ein Live-Konto abgewickelt.
  Zurückgeschickt operatorname
XPath: /merchant/operatorname
Alphanumerisch (255) Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
  Zurückgeschickt paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Der zurückgegebene Wert ist "PAYSAFECARD".
  Zurückgeschickt paysafeid
XPath: /paysafe/@id
Alphanumerisch (255) Eine eindeutige ID, die der Transaktion von Paysafe zugewiesen wurde. Sie können diese IDs für zukünftige Korrespondenz mit Paysafe speichern.
  Zurückgeschickt requesttypedescription
XPath: /@type
Alpha (20) Der zurückgegebene Wert ist "REFUND".
  Zurückgeschickt settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-TT Das Datum, an dem die Transaktion abgewickelt wird.
  Zurückgeschickt settlestatus
XPath: /settlement/settlestatus
Numerisch (3)
  • "100" bedeutet, dass die Mittel sofort eingezogen werden.
  • "3" bedeutet, dass die Anfrage erfolglos war.
  Zurückgeschickt transactionreference
XPath: /transactionreference
Alphanumerisch einschließlich
Bindestriche (25)
Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird.
  Zurückgeschickt transactionstartedtimestamp
XPath: /timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
  Bedingt customeraccountnumbertype
XPath: /customer/accountnumber/@type
Alpha (7)

Der zurückgegebene Wert ist "ACCOUNT".

Wird nur zurückgesendet, wenn es im Antrag angegeben wurde.

  Bedingt errordata
XPath: /error/data
Alphanumerisch (255)

Zusätzliche Informationen zur Behebung des Fehlers.

Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.

  Bedingt maskedcustomeraccountnumber
XPath: /customer/accountnumber
Numerisch & # (20)

Maskierte ID des PaysafeCard des Kunden.

Wird nur zurückgesendet, wenn es im Antrag angegeben wurde.

  Bedingt 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.

  Bedingt 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 können bei PaysafeCard nicht durchgeführt werden.

 

Gesperrte Karten

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

Erfahren Sie mehr über gesperrte Karten (Link zu externer Seite).

 

Wenn der Kunde seine PIN nicht eingibt

Nach der Durchführung der ORDER und dem Erhalt einer erfolgreichen Antwort hat der Kunde 30 Minuten Zeit, um seine Zahlungsdaten auf der Website von Paysafe einzugeben, danach wird die Zahlung von Paysafe als "abgelaufen" gekennzeichnet und der Kunde muss eine neue ORDER durchführen.

 

Konto-Typ

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

 

iframes

Die von Paysafe gehostete Seite kann in einem iframe gehostet werden.

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

Die Zahlungsseite von Paysafe 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.

War dieser Artikel hilfreich?
0 von 0 Personen fanden dies hilfreich