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
  Erforderlich accounttypedescription
XPath: /operation/accounttypedescription
K.A. Alpha (20) Reichen Sie "ECOM" ein, um eine E-Commerce-Transaktion darzustellen.
  Erforderlich 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.

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

  Erforderlich pan
XPath: /billing/payment/pan
paymentData ≫ applicationPrimaryAccountNumber Numerisch (12-19) Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
  Erforderlich 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.

  Erforderlich sitereference
XPath: /operation/sitereference
K.A. Alphanumerisch
& Unterstrich (50)
Identifiziert Ihre Website auf dem System Trust Payments .
  Erforderlich tavv
XPath: /threedsecure/tavv
paymentData ≫ onlineZahlungKryptogramm Alphanumerische Zeichen und Sonderzeichen (32) Token Authentifizierung Verifizierungswert
  Erforderlich 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.
  Erforderlich walletsource
XPath: /billing/payment/wallet/source
K.A. Alpha (8) Muss mit dem Wert "APPLEPAY" eingereicht werden.
  Bedingt billingfirstname
XPath: /billing/name/first
billingContact ≫ givenName Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsvorname.

Erforderlich für Glücksspielanbieter.

  Bedingt billinglastname
XPath: /billing/name/last
billingContact ≫ Familienname Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsnachname.

Erforderlich für Glücksspielanbieter.

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

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

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

  Optional 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).
  Optional 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.

  Optional billingpremise
XPath: /billing/premise
billingContact ≫ addressLines Alphanumerisch einschließlich
Symbole (25)
Der Hausname/die Hausnummer in der Rechnungsadresse des Kunden.
  Optional 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: + - ( )
  Optional billingtown
XPath: /billing/town
billingContact ≫ Ortschaft Alphanumerisch einschließlich
Symbole (127)
Der Ort, der für die Rechnungsadresse des Kunden eingegeben wurde.
  Optional 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.

  Optional 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).
  Optional customerfirstname
XPath: /customer/name/first
shippingContact ≫ Vorname Alphanumerisch einschließlich
Symbole (127)

Der erste Name in der Lieferadresse des Kunden.

  Optional customerpremise
XPath: /customer/premise
shippingContact ≫ addressLines Alphanumerisch einschließlich
Symbole (25)
Der Hausname/die Hausnummer auf der Lieferadresse des Kunden.
  Optional 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: + - ( )
  Optional customertown
XPath: /customer/town
VersandKontakt ≫ Ort Alphanumerisch einschließlich
Symbole (127)
Die Stadt in der Lieferadresse des Kunden.
  Optional orderreference
XPath: /merchant/orderreference
K.A. Alphanumerisch einschließlich
Symbole (25)

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

  Optional 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
  Zurückgeschickt accounttypedescription
XPath: /operation/accounttypedescription
Alpha (20) "ECOM" wird in der Antwort zurückgegeben, um eine E-Commerce-Transaktion darzustellen.
  Zurückgeschickt 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.

  Zurückgeschickt 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.
  Zurückgeschickt 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.

  Zurückgeschickt 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.
  Zurückgeschickt debtrepayment
XPath: /merchant/debtrepayment
Numerisch (1)

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

  Zurückgeschickt 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.
  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.

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

  Zurückgeschickt 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.

  Zurückgeschickt 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.

  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 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.
  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) Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
  Zurückgeschickt requesttypedescription
XPath: /@type
Alpha (20) "AUTH" wird in der Antwort zurückgegeben.
  Zurückgeschickt securityresponseaddress
XPath: /security/address
Numerisch (1) Das Ergebnis der AVS und Sicherheitscode-Prüfungen.

Klicken Sie hier, um mehr zu erfahren.

  Zurückgeschickt securityresponsepostcode
XPath: /security/postcode
Numerisch (1)
  Zurückgeschickt securityresponsesecuritycode
XPath: /security/securitycode
Numerisch (1)
  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)

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.

  Zurückgeschickt 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.
  Zurückgeschickt tavv
XPath: /threedsecure/tavv
Alphanumerische Zeichen und Sonderzeichen (32) Token Authentifizierung Verifizierungswert
  Zurückgeschickt 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.
  Zurückgeschickt 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.
  Zurückgeschickt tokentype
XPath: /billing/payment/pan/@tokentype
Alphanumerisch (50) Dient zur Identifizierung der Art des für diese Zahlung verwendeten Tokens (in diesem Fall "APPLEPAY").
  Zurückgeschickt 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.
  Zurückgeschickt transactionstartedtimestamp
XPath: /timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
  Zurückgeschickt walletdisplayname
XPath: /billing/payment/wallet/displayname
Alphanumerisch (255) Die vom Kunden verwendete Kartenart und die letzten vier Ziffern seiner Kartennummer (z. B. "Visa 1111").
  Zurückgeschickt 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").
  Bedingt 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.

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

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

Zusätzliche Informationen zur Behebung des Fehlers.

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

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

  Bedingt merchantcity
XPath: /merchant/merchantcity
Alphanumerisch (127)
  Bedingt merchantcountryiso2a
XPath: /merchant/merchantcountryiso2a
Alpha (2)
  Bedingt merchantname
XPath: /merchant/merchantname
Alphanumerisch (255)
  Bedingt merchantstatecode
XPath: /merchant/merchantstatecode
Alphanumerisch (127)
  Bedingt merchantzipcode
XPath: /merchant/merchantzipcode
Alphanumerisch (10)
  Bedingt 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