Apple Pay direkte Einbindung AUTH

  Zuletzt aktualisiert: 

 

Der folgende Inhalt setzt voraus, dass Sie die erforderliche PCI-Zertifizierung erhalten haben, um sensible Karteninhaberdaten in der Anfrage an unsere Webservices API zu verarbeiten und zu übermitteln.
Lesen Sie diesen Artikel, um mehr zu erfahren.

 

In diesem Dokument wird davon ausgegangen, dass Sie Ihre eigene Integration mit Apple Pay konfiguriert haben und ein Gateway für die Abwicklung der Zahlung benötigen. Sobald Sie Folgendes befolgt haben   Apples Anleitung zur Überprüfung der Token-Signatur und zur Entschlüsselung des Tokens (Link zu externer Seite)muss Ihr System die Schlüsselwerte aus der Datei paymentData, billingContact und shippingContact Objekte zurück und übermitteln sie in einer AUTH -Anfrage an Trust Payments. Die vollständigen Zuordnungen der von Apple Pay zurückgegebenen Felder zu den in der AUTH -Anfrage übermittelten Feldern finden Sie unten.

 

AUTH Anfrage

Im Folgenden finden Sie ein Beispiel für einen AUTH Antrag mit den oben beschriebenen Anforderungen:

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 = {
"accounttypedescription":"ECOM",
"baseamount":"2000",
"currencyiso3a":"GBP",
"eci":"2",
"expirydate":"07/2023",
"pan":"5100000000000511",
"requesttypedescriptions": ["AUTH"],
"sitereference": "test_site12345",
"tavv":"ALFoEd4DhmGzAIj3dUo4AoABFA==",
"walletdisplayname":"MasterCard 0511",
"walletsource":"APPLEPAY"
}

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

 

Feldspezifikation

  Feld Zuordnung zu den Feldern des entschlüsselten Tokens Format Beschreibung
X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
K.A. Alpha (20) Reichen Sie "ECOM" ein, um eine E-Commerce-Transaktion darzustellen.
X1-EN.png baseamount
XPath: /billing/amount
K.A. Numerisch (13)

Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. £10 wird als 1000 übermittelt. Dieser Wert muss größer als Null sein.

X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
K.A. Alpha (3) Die Währung der Transaktion. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
X1-EN.png eci
XPath: /threedsecure/eci
paymentData ≫ eciIndicator Alphanumerisch (2) Die mit der Transaktion verbundene Sicherheitsstufe ECI (E-Commerce Indicator). Klicken Sie hier, um mehr über die möglichen ECI Werte zu erfahren.
X1-EN.png expirydate
XPath: /billing/payment/expirydate
paymentData ≫ applicationExpirationDate Datum MM/JJJJ

Das auf der Karte aufgedruckte Ablaufdatum.

Das von Trust Payments akzeptierte Format unterscheidet sich von dem von Apple zurückgegebenen Format. Während Apple die Daten im Format "JJMMTT" zurückgibt, müssen Sie sie in der Anfrage an AUTH im Format "MM/JJJJ" übermitteln.

X1-EN.png pan
XPath: /billing/payment/pan
paymentData ≫ applicationPrimaryAccountNumber Numerisch (12-19) Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
X1-EN.png requesttypedescriptions
XPath: /@type
K.A. Alpha (20) Unterstützte Kombinationen Anforderungstyp :
  • [“AUTH”]
  • [“AUTH”, “RISKDEC”]
  • [“AUTH”, “SUBSCRIPTION”]
  • [“ACCOUNTCHECK”, “AUTH”]
  • [“ACCOUNTCHECK”, “SUBSCRIPTION”]
  • [“RISKDEC”, “AUTH”]
  • [“RISKDEC”, “AUTH”, “SUBSCRIPTION”]
  • [“RISKDEC”, “ACCOUNTCHECK”, “AUTH”]
  • [“RISKDEC”, “ACCOUNTCHECK”, “AUTH”, “SUBSCRIPTION”]

Klicken Sie hier, um mehr über die Antragsarten zu erfahren.

X1-EN.png sitereference
XPath: /operation/sitereference
K.A. Alphanumerisch
& Unterstrich (50)
Identifiziert Ihre Website auf dem System Trust Payments .
X1-EN.png tavv
XPath: /threedsecure/tavv
paymentData ≫ onlineZahlungKryptogramm Alphanumerische Zeichen und Sonderzeichen (32) Token Authentifizierung Verifizierungswert
X1-EN.png walletdisplayname
XPath:/billing/payment/wallet/displayname

Zahlungsdaten ≫ Anzeigename

Numerisch (4) Hierbei handelt es sich um Informationen des Kartenausstellers, die dem Kunden angezeigt werden können, um die Zahlungsmethode zu identifizieren. Dazu gehören in der Regel die letzten 4 Ziffern der Kartennummer.
X1-EN.png walletsource
XPath: /billing/payment/wallet/source
K.A. Alpha (8) Muss mit dem Wert "APPLEPAY" eingereicht werden.
X2-EN.png billingfirstname
XPath: /billing/name/first
billingContact ≫ givenName Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsvorname.

Erforderlich für Glücksspielanbieter.

X2-EN.png billinglastname
XPath: /billing/name/last
billingContact ≫ Familienname Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsnachname.

Erforderlich für Glücksspielanbieter.

X2-EN.png customerpostcode
XPath: /customer/postcode
shippingContact ≫ Postleitzahl Alphanumerisch (25)

Die Postleitzahl des Kunden. Es muss sich um eine gültige Postleitzahl für den customercountryiso2a vorgelegt.

Erforderlich, wenn Kunden Categorie Nummer (MCC) gleich 6012 und Zahlungsart gleich VISA ist.

X2-EN.png customerlastname
XPath: /customer/name/last
shippingKontakt ≫ Familienname Alphanumerisch einschließlich
Symbole (127)

Der letzte Name in der Lieferadresse des Kunden.

Erforderlich, wenn Kunden Categorie Nummer (MCC) gleich 6012 und Zahlungsart gleich VISA ist.

X3-EN.png billingcountryiso2a
XPath: /billing/country
billingContact ≫ countryCode Alpha (2)

Das Land der Rechnungsadresse des Kunden. Diese muss im ISO2A-Format vorliegen.

Klicken Sie hier für eine vollständige Liste der Ländercodes.

X3-EN.png billingemail
XPath: /billing/email
billingContact ≫ emailAdresse E-Mail (255) Die Adresse des Kunden Rechnungs-E-Mail . Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Zeichen).
X3-EN.png billingpostcode
XPath: /billing/postcode
billingContact ≫ postalCode Alphanumerisch (25)

Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a vorgelegt.

X3-EN.png billingpremise
XPath: /billing/premise
billingContact ≫ addressLines Alphanumerisch einschließlich
Symbole (25)
Der Hausname/die Hausnummer in der Rechnungsadresse des Kunden.
X3-EN.png billingtelephone
XPath: /billing/telephone
billingContact ≫ TelefonNummer Alphanumerisch einschließlich
Symbole (20)
Die Telefonnummer des Kunden für die Rechnungsstellung. Gültige Zeichen:
  • Ziffern 0-9
  • Räume
  • Sonderzeichen: + - ( )
X3-EN.png billingtown
XPath: /billing/town
billingContact ≫ Ortschaft Alphanumerisch einschließlich
Symbole (127)
Der Ort, der für die Rechnungsadresse des Kunden eingegeben wurde.
X3-EN.png customercountryiso2a
XPath: /customer/country
shippingContact ≫ countryCode Alpha (2)

Das Land der Lieferadresse des Kunden. Es muss im ISO2A-Format angegeben werden.

Klicken Sie hier für eine vollständige Liste der Ländercodes.

X3-EN.png customeremail
XPath: /customer/email
shippingKontakt ≫ emailAdresse E-Mail (255) Die Liefer-E-Mail-Adresse des Kunden. Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Symbol).
X3-EN.png customerfirstname
XPath: /customer/name/first
shippingContact ≫ Vorname Alphanumerisch einschließlich
Symbole (127)

Der erste Name in der Lieferadresse des Kunden.

X3-EN.png customerpremise
XPath: /customer/premise
shippingContact ≫ addressLines Alphanumerisch einschließlich
Symbole (25)
Der Hausname/die Hausnummer auf der Lieferadresse des Kunden.
X3-EN.png customertelephone
XPath: /customer/telephone
shippingContact ≫ TelefonNummer Alphanumerisch einschließlich
Symbole (20)
Die Telefonnummer des Kunden für die Zustellung. Gültige Zeichen:
  • Ziffern 0-9
  • Räume
  • Sonderzeichen: + - ( )
X3-EN.png customertown
XPath: /customer/town
VersandKontakt ≫ Ort Alphanumerisch einschließlich
Symbole (127)
Die Stadt in der Lieferadresse des Kunden.
X3-EN.png orderreference
XPath: /merchant/orderreference
K.A. Alphanumerisch einschließlich
Symbole (25)

Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann.

X3-EN.png paymenttypedescription
XPath: /billing/payment/@type
K.A. Alpha (20) Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").

 

AUTH Antwort

Nach dem Absenden der Anfrage AUTH erhalten Sie eine Antwort von AUTH :

Python PHP Rohes JSON Rohes XML
{
u 'requestreference': u 'A0bxh87wt',
u 'version': u '1.00',
u 'responses': [{
u 'accounttypedescription': u 'ECOM',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST09',
u 'authmethod': u 'FINAL',
u 'baseamount': u '2000',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'eci': u '02',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'issuercountryiso2a': u 'JP',
u 'livestatus': u '0',
u 'maskedpan': u '510000######0511',
u 'merchantcategorycode': u '1234',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'merchantnumber': u '00000000',
u 'orderreference': u 'My_Order_123',
u 'operatorname': u 'webservices@example.com',
u 'paymenttypedescription': u 'MASTERCARD',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '0',
u 'settleduedate': u '2023-03-22',
u 'settlestatus': u '0',
u 'splitfinalnumber': u '1',
u 'tavv': u 'ALFoEd4DhmGzAIj3dUo4AoABFA==',
u 'tid': u '27882788',
u 'tokenisedpayment': u '1',
u 'tokentype': u 'APPLEPAY',
u 'transactionreference': u '36-9-286248',
u 'transactionstartedtimestamp': u '2023-03-22 09:34:31',
u 'walletdisplayname': u 'MasterCard 0511',
u 'walletsource': u 'APPLEPAY'
}]
}

 

Feldspezifikation

  Feld Format Beschreibung
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) "ECOM" wird in der Antwort zurückgegeben, um eine E-Commerce-Transaktion darzustellen.
X4-EN.png authmethod
XPath: /operation/authmethod
Alpha (11)

Die authmethod gibt an, wie eine Transaktion vom Kartenaussteller verarbeitet werden soll. Sie sollten erwarten, dass einer der folgenden Werte zurückgegeben wird, um die authmethod beschäftigt. Klicken Sie auf die folgenden Links, um mehr zu erfahren:

Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.

X4-EN.png baseamount
XPath: /billing/amount
Numerisch (13) Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. £10 wird als 1000 übermittelt. Dieser Wert muss größer als Null sein.
X4-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha (3)

Die Währung der Transaktion.

Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.

X4-EN.png dccenabled
XPath: /billing/dcc/@enabled
Numerisch (1) Da Apple Pay nicht unterstützt DCCnicht unterstützt, wird "0" zurückgegeben, um anzuzeigen, dass DCC für diese Transaktion deaktiviert ist.
X4-EN.png debtrepayment
XPath: /merchant/debtrepayment
Numerisch (1)

Zeigt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist. Klicken Sie hier, um mehr zu erfahren.

X4-EN.png eci
XPath: /threedsecure/eci
Alphanumerisch (2) Die mit der Transaktion verbundene Sicherheitsstufe ECI (E-Commerce Indicator). Klicken Sie hier, um mehr über die möglichen ECI Werte zu erfahren.
X4-EN.png 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.

X4-EN.png errormessage
XPath: /error/message
Alphanumerisch (255) Hier finden Sie eine kurze Erklärung für die Fehlerursache.

Bei erfolgreichen Transaktionen wird dies als "Ok" zurückgegeben.

Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerte.

X4-EN.png issuercountryiso2a
XPath: /billing/payment/issuercountry
Alpha (2)

Das Land des Kartenausstellers des Kunden.
Es wird im ISO2A-Format angegeben.

Klicken Sie hier für eine vollständige Liste der Ländercodes.

X4-EN.png livestatus
XPath: /live
Numerisch (1)
  • 0 - Die Transaktion wurde über ein Testkonto abgewickelt.
  • 1 - Transaktion wird über ein Live-Konto abgewickelt.
X4-EN.png maskedpan
XPath: /billing/payment/pan
Alphanumerisch einschließlich "#" (12-19) Die maskedpan steht für die Kartennummer des Kunden. Der Wert von maskedpan Feld ist in der Antwort maskiert. Der größte Teil der Nummer wird absichtlich durch "#"-Zeichen verdeckt, z. B. 411111######0211.
X4-EN.png operatorname
XPath: /merchant/operatorname
Alphanumerisch (255) Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha (20) Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
X4-EN.png requesttypedescription
XPath: /@type
Alpha (20) "AUTH" wird in der Antwort zurückgegeben.
X4-EN.png securityresponseaddress
XPath: /security/address
Numerisch (1) Das Ergebnis der AVS und Sicherheitscode-Prüfungen.

Klicken Sie hier, um mehr zu erfahren.

X4-EN.png securityresponsepostcode
XPath: /security/postcode
Numerisch (1)
X4-EN.png securityresponsesecuritycode
XPath: /security/securitycode
Numerisch (1)
X4-EN.png settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-TT Das Datum, an dem die Transaktion abgewickelt wird.
X4-EN.png settlestatus
XPath: /settlement/settlestatus
Numerisch (3)

Ein numerischer Wert, der verwendet wird, um den Fortschritt von Abrechnung in Bezug auf diese Transaktion anzuzeigen.

Klicken Sie hier für eine vollständige Liste der settlestatus Werte.

X4-EN.png splitfinalnumber
XPath: /operation/splitfinalnumber
Numerisch (2) Da Apple Pay keine geteilten Sendungen unterstützt, wird eine "1" zurückgegeben, um anzuzeigen, dass der Betrag in einem Durchgang beglichen wird.
X4-EN.png tavv
XPath: /threedsecure/tavv
Alphanumerische Zeichen und Sonderzeichen (32) Token Authentifizierung Verifizierungswert
X4-EN.png tid
XPath: /merchant/tid
Alphanumerisch (255) Die für die Bearbeitung der Transaktion verwendete Terminal-ID. Diese wird Ihrer Händlernummer zugeordnet, wenn wir Ihr Konto in unserem System einrichten.
X4-EN.png tokenisedpayment
XPath: /billing/payment/pan/@tokenised
Numerisch (1) Dieser wird mit dem Wert 1 zurückgegeben, um anzuzeigen, dass die Transaktion unter Verwendung eines Tokens verarbeitet wurde.
X4-EN.png tokentype
XPath: /billing/payment/pan/@tokentype
Alphanumerisch (50) Dient zur Identifizierung der Art des für diese Zahlung verwendeten Tokens (in diesem Fall "APPLEPAY").
X4-EN.png transactionreference
XPath: /transactionreference
Alphanumerisch einschließlich
Bindestriche (25)
Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird. Sie benötigen diese Referenz, um eine Erstattung durchzuführen oder die Transaktion zu aktualisieren.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
X4-EN.png walletdisplayname
XPath: /billing/payment/wallet/displayname
Alphanumerisch (255) Die vom Kunden verwendete Kartenart und die letzten vier Ziffern seiner Kartennummer (z. B. "Visa 1111").
X4-EN.png walletsource
XPath: /billing/payment/wallet/source
Alphanumerisch (20) Wird verwendet, um die Art der für diese Zahlung verwendeten Geldbörse zu identifizieren (in diesem Fall "APPLEPAY").
X2-EN.png acquirerresponsecode
XPath: /acquirerresponsecode
Alphanumerisch (255)

Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen.

Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.

X2-EN.png authcode
XPath: /authcode
Alphanumerisch (255)

Der Autorisierung Code, der von der ausstellenden Bank bereitgestellt wird. Dieser ist je nach Bank unterschiedlich.

Wird nur zurückgegeben, wenn die Transaktion genehmigt ist.

X2-EN.png errordata
XPath: /error/data
Alphanumerisch (255)

Zusätzliche Informationen zur Behebung des Fehlers.

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

X2-EN.png merchantcategorycode
XPath: /merchant/merchantcategorycode
Alphanumerisch (255)

Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. Um diese Felder zu ändern, wenden Sie sich bitte an unser Support-Team.

Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab.

X2-EN.png merchantcity
XPath: /merchant/merchantcity
Alphanumerisch (127)
X2-EN.png merchantcountryiso2a
XPath: /merchant/merchantcountryiso2a
Alpha (2)
X2-EN.png merchantname
XPath: /merchant/merchantname
Alphanumerisch (255)
X2-EN.png merchantstatecode
XPath: /merchant/merchantstatecode
Alphanumerisch (127)
X2-EN.png merchantzipcode
XPath: /merchant/merchantzipcode
Alphanumerisch (10)
X2-EN.png orderreference
XPath: /merchant/orderreference
Alphanumerisch einschließlich
Symbole (25)

Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann.

Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.

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