Über Apple Pay

Was ist Apple Pay


Logo

Info

Apple Pay ist eine digitale Geldbörse, die Zahlungsdetails speichert und einen ebenso bequemen wie sicheren Weg bietet, um in iOS-Apps, Webseiten im Browser Safari und an kontaktlosen POS-Terminals zu bezahlen. In Apps und für Webseiten können die Benutzer schnell und sicher ihre Informationen für Bezahlung, Versand und Kontakt bereitstellen, um den Kassenprozess mit nur einem Antippen mittels Touch ID zu erledigen. Die Einfachheit von Apple Pay erhöht die Konversionsraten und die bringt durch die Akzeptanz neue Benutzer hinzu.

TypZahlungen per eWallet


Die Computop-Lösung für Apple Pay unterstützt derzeit folgende Szenarien:

  • In-App-Zahlungen (auch Teil von Computop SDK)
  • Web-Zahlungen

Hinweis: Bitte beachten Sie, dass Informationen zur Haftungsumkehr direkt bei ihrem Kreditkarten-Acquirer angefragt werden müssen. Da Computop nicht im direkten Vertragsverhältnis steht, muss Ihnen der Acquirer die Regularien pro Kartenmarke mitteilen.

Hinweis: Weitere Informationen zur Button-Lösung für Apple Pay finden Sie unter https://support.computop.com/hc/de/articles/4559076653970-Apple-Pay-und-Google-Pay-Button-L%C3%B6sung-PaySSL-aspx?source=search.

Web-Zahlung

Apple Pay im Internet ermöglicht Einkäufe mittels Apple Pay beim Surfen mit dem Browser Safari. Beim Einkauf auf iPhone oder iPad erscheint nach der Auswahl von Apple Pay als Zahlungsmethode eine Zahlungsseite, die den Kunden auffordert, die Zahlung mittels Touch ID zu bestätigen. Beim Einkauf auf dem Mac müssen Kunden ein iOS-Gerät in der Nähe haben und werden auf diesem Gerät aufgefordert, die Zahlung zu autorisieren. Das wird dann mit dem Browser synchronisiert. Auf dem neuesten Mac Book kann die Zahlung auch direkt auf dem Mac Book autorisiert werden.

Anforderungen für Apple Pay:

  • iOS 10. Apple Pay Web-Zahlungen werden auf allen iOS-Geräten mit einem Secure Element unterstützt.
  • macOS 10.12. Apple Pay Web-Zahlungen werden in Safari unterstützt.
    • Der Anwender muss ein iPhone oder eine Apple Watch haben, um die Zahlung autorisieren zu können.
    • Auf dem neuesten Mac Book Pro können Zahlungen direkt mittels Touch ID autorisiert werden
  • Alle Webseiten, die Apple Pay einbeziehen, müssen gesichert über HTTPS übertragen werden.
  • Ihre Webseite muss die Richtlinien von Apple Pay einhalten. Weitere Informationen finden Sie unter Apple Pay on the Web Acceptable Use Guidelines
  • Serveranforderungen

In-App-Zahlung

Apple Pay als Zahlungsmethode kann für Zahlungen innerhalb von iOS-Apps verwenden werden. Der Hauptvorteil der Zahlung mit Apple Pay ist der reibungslose Ablauf, ohne dass Kreditkartendaten, Liefer- oder Rechnungsadressen neu eingegeben werden müssen, was auf kleineren iPhone-Display mitunter mühsam ist. Der Kunde wählt lediglich die Zahlungsmethode Apple Pay und bestätigt die Zahlung mittels Touch ID.

Der Händler kann auch Computop SDK einsetzen, um In-App-Zahlungen zu erleichtern und die Integration schneller und einfacher zu gestalten.

Anforderungen für Apple Pay:

  • Apple Pay In-App-Zahlungen werden auf allen iOS-Geräten mit einem Secure Element unterstützt.

Diagramm zum Prozessablauf

Apple Pay process flow

 

Schaltfläche für Apple Pay anzeigen

Innerhalb von Apps stellt PassKit die APIs bereit, mit denen Ihre App bestimmt, ob sie auf einem Gerät mit einem Secure Element läuft und ob dem Gerät Zahlungskarten bekannt sind, die Sie unterstützen. Auf Webseiten stellt das WebKit die APIs bereit, damit Ihre Webseite prüfen kann, ob derjenige Nutzer ein für Apple Pay fähiges Gerät hat und ob dieses eingerichtet ist.

Wenn das Gerät Apple Pay fähig ist, sollten Sie die Schaltfläche Mit Apple Pay kaufen innerhalb von Apps mit Hilfe der APIs aus dem PassKit sowie innerhalb von Safari mit den APIs aus dem WebKit anzeigen.


Die Zahlungsseite anzeigen

Wenn Ihr Nutzer Waren oder Dienstleistungen zum Kauf auswählt und Apple Pay als Zahlungsmethode wählt, erzeugen Sie eine Zahlungsanfrage und bitten das PassKit in Apps oder das Webkit auf Ihrer Webseite darum, dem Benutzer die Zahlungsseiten anzuzeigen. Die Zahlungsseite muss sofort ohne Zwischenbildschirme oder Popups folgen, wenn der Benutzer auf Apple Pay getippt hat, außer zur Bestätigung der nötigen Produktdetails wie Größe oder Menge.

Ihr App gibt den Inhalt der Zahlungsseite an, aber sie steuert nicht die Interaktion des Nutzers mit dieser Seite. Sie müssen entscheiden, ob Sie dem Benutzer weitere Informationen wie aktuelle Liefer- und Rechnungsangaben, Liefermethode und andere Positionen anzeigen. Sie sollten nur die für die Verarbeitung der Transaktion erforderlichen Informationen abfragen.

 

Zahlungen verarbeiten

Nach der Autorisierung durch den Benutzer mittels Touch ID (und in China auch Bank PIN-Code) erhält Ihre App ein Zahlungs-Token von PassKit. Das Zahlungs-Token enthält eingekapselt die nötigen Informationen zum Abschluss der Zahlungstransaktion wie die gerätespezifische Kontonummer, den Betrag und ein eindeutiges Einmal-Kryptogramm. Das verschlüsselte Zahlungspaket wird von Computop entschlüsselt, wo dann auch die gesamte Verarbeitung der Transaktion erfolgt.

Auf dieser Seite


Einrichtung für Apple Pay, Schritt für Schritt


Wenn sich der Händler für Apple Pay entschieden hat, sind einige Schritte zu erledigen:

  1. Überprüfen, ob der Acquirer des Händlers Apple Pay unterstützt
    1. Nicht alle Acquirer unterstützen Apple Pay für In-App- und Web-Zahlungen
    2. Computop kann Informationen zu den unterstützenden Acquirern geben

  2. Anlegen einer Merchant ID, einer eindeutigen Kennung, die einen Händler gegenüber Apple Pay ausweist
    1. Öffnen Sie Ihr Apple-Entwicklerkonto und besuchen den Bereich Zertifikate, Kennungen & Profile im Apple Mitgliederzentrum. Navigieren Sie zu Merchant IDs und klicken auf Hinzufügen.
    2. Legen Sie Ihre Merchant ID fest. Ihre eingegebene Kennung sollte eine Kennung vom Typ Reverse-DNS sein mit dem Wort "merchant" als Präfix. Bitte beachten Sie, dass keine Umlaute oder Sonderzeichen enthalten sein dürfen.


    3. Senden Sie Ihre Apple Merchant ID an Computop.
  3. Erzeugen Sie ein Zertifikat zur Zahlungsverarbeitung (Payment Processing Certificate), das zur sicheren Übertragung der Zahlungsdaten verwendet wird. Die Server von Apple Pay nutzen den öffentlichen Schlüssel dieses Zertifikats zur Zahlungsverarbeitung, um die Zahlungsdaten zu entschlüsseln
    1. Computop erzeugt den Zertifikatantrag (Certificate Signing Request, CSR).
      1. Mit Ihrer Apple Merchant ID erzeugt Computop Helpdesk den Apple Pay CSR und stellt Ihnen diese Angaben zur Verfügung.
      2. CSR wird von Apple benötigt, um das Zertifikat zur Signierung des Payment Token zu generieren
    2. Laden Sie den CSR bei Apple hoch
      1. Im Mitgliederzentrum wählen Sie Zertifikate, Kennungen & Profile. Unter Kennungen wählen Sie Merchant IDs. Wählen Sie die Merchant ID aus der Liste aus und klicken auf Bearbeiten.
      2. Klicken Sie auf Datei wählen, wählen den von Computop erhaltenen CSR aus und klicken auf Generieren.
      3. Laden Sie das Zertifikat per Klick auf Download herunter und klicken dann auf Fertig




     

  4. Aktivieren von Apple Pay für Ihre App in Xcode
    1. Öffnen Sie die Ebene Fähigkeiten (Capabilities)
    2. Wählen Sie den Schalter in der Zeile Apple Pay und wählen dann die Merchant IDs, die die App verwenden soll.
  5. (NUR WEB) Erzeugen des Händleridentitätszertifikats (Merchant Identity Certificate). Ein TLS-Zertifikat (Transport Layer Security, TLS) dient zur Authentisierung Ihrer Händler-Sitzungen bei den Servern von Apple Pay.

    Um Ihre Domain zu registrieren, zu bestätigen und Ihr Händleridentitätszertifikat zu erzeugen, führen Sie folgende Schritte aus:

    1. Im Mitgliederzentrum wählen Sie Zertifikate, Kennungen und Profile.
    2. Unter Kennungen wählen Sie Merchant IDs.
    3. Wählen Sie die Merchant ID aus der Liste aus und klicken auf Bearbeiten.
    4. Im Bereich Apple Pay im Web klicken Sie auf die Schaltfläche Domain hinzufügen.
    5. Geben Sie Ihren vollständigen qualifizierten Domainnamen ein und klicken auf Weiter.
    6. Die Seite erzeugt eine Datei und stellt sie zum Download zur Verfügung. Laden Sie diese Datei herunter und hosten sie am angegebenen Ort.
    7. Sobald die Datei auf Ihrem Server verfügbar ist, klicken Sie auf die Schaltfläche Überprüfen. Wenn die Überprüfung erfolgreich ist, kehrt die Seite zur Einstellungsseite der iOS Merchant ID zurück und zeigt eine grüne Statuskennung Verifiziert.
    8. Im Bereich Apple Pay im Web klicken Sie auf die Schaltfläche Zertifikat erzeugen. Folgen Sie den Anweisungen, um Ihr Händleridentitätszertifikat zu erzeugen und herunterzuladen. Verwenden Sie dieses Zertifikat zur Anforderung einer Händler-Sitzung während der Zahlungsvalidierung. Weitere Informationen finden Sie unter Merchant Validation in ApplePaySession.
  6. Apple Pay in Ihre App oder den Web-Shop integrieren
    1. Folgen Sie den Richtlinien: https://developer.apple.com/apple-pay
    2. Wichtig: Beim Erzeugen von PKPaymentRequest, request.merchantCapabilities = PKMerchantCapability3DS. Computop unterstützt nur Zahlarten mit 3-D Secure.


Paygate-Schnittstelle

Definitionen

Datenformate:

FormatBeschreibung

a

alphabetisch

as

alphabetisch mit Sonderzeichen

n

numerisch

an

alphanumerisch

ans

alphanumerisch mit Sonderzeichen

ns

numerisch mit Sonderzeichen

bool

Bool’scher Ausdruck (true oder false)

3

feste Länge mit 3 Stellen/Zeichen

..3

variable Länge mit maximal 3 Stellen/Zeichen

enum

Aufzählung erlaubter Werte

dttm

ISODateTime (JJJJ-MM-TTThh:mm:ss)


Abkürzungen:

AbkürzungBeschreibungKommentar

CND

Bedingung (condition)


M

Pflicht (mandatory)

Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein

O

optional

Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich

C

bedingt (conditional)

Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist


Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.


Aufruf der Schnittstelle

Bei einer Kreditkartenzahlung über Apple Pay werden zwei Transaktionen angelegt. In der Apple-Pay-Transaktion werden zunächst die benötigten Kreditkartendaten ermittelt und dann automatisch die eigentliche Kreditkarten-Transaktion ausgeführt. Diese erfolgt über eine Server-zu-Server-Verbindung und unterstützt dabei alle Möglichkeiten der üblichen Kreditkartentransaktionen. Im Unterschied dazu übergeben Sie jedoch nicht die Ihnen unbekannten Kreditkartendaten, sondern den von Apple Pay generierten PKPaymentToken, der die benötigten Kreditkartendaten in verschlüsselter Form enthält.

Um eine Kreditkartenzahlung über Apple Pay abzuwickeln, verwenden Sie bitte folgende URL:

 

Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:

Die Tabelle beschreibt nur die Basisparameter. Es können auch alle Kreditkartenparameter (ohne Kreditkartendaten) einbezogen werden. Hierzu finden Sie weitere Informationen im Dokument Kreditkarten. Stellen Sie bei der Verarbeitung wiederkehrender Zahlungen oder gespeicherter Zugangsdaten für Dateitransaktionen sicher, dass Sie alle nötigen Informationen im "COF Mandate Integration Guide" beachten. Wenn spezifische Parameter für die Kreditkartenzahlung Pflicht sind, dann sind diese Parameter für Apple Pay ebenfalls Pflicht.

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyRESTFormatCNDDescriptionBeschreibung

MerchantID

BasicAuth.Username

ans..30

M

MerchantID, assigned by Computop. Additionally this parameter has to be passed in plain language too.

HändlerID, die von Computop vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.

KeyRESTFormatCNDDescriptionBeschreibung
TransID"transactionId": "..."

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key

REST

Format

CND

Description

Beschreibung

RefNr

"referenceNumber": "..."

ns..30

C

Unique reference number. Mandatory in case that this parameter is mandatory for merchant's card processing.Eindeutige Referenznummer. Pflicht, wenn dieser Parameter für die Kartentransaktion des Händlers Pflicht ist.

KeyRESTFormatCNDDescriptionBeschreibung
Amount"amount": { "value": ...}

n..10

M

Amount in the smallest currency unit (e.g. EUR Cent). Please contact the Computop Helpdesk, if you want to capture amounts <100 (smallest currency unit).

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den Computop Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

KeyRESTFormatCNDDescriptionBeschreibung
Currency"amount": { "currency": "..."}

a3

M

Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: A1 Währungstabelle

KeyRESTFormatCNDDescriptionBeschreibung

MAC

---

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

KeyRESTFormatCNDDescriptionBeschreibung
UserData"metadata[userData]": "..."

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

Key

REST

Format

CND

Description

Beschreibung

RTF


a1

O

Establishment of Credential on File Agreement (Cardholder agrees that his card data can be stored for further transactions).Einrichtung der Vereinbarung für hinterlegte Zugangsdaten (Karteninhaber stimmt zu, dass seine Kartendaten für weitere Transaktionen gespeichert werden dürfen).

KeyRESTFormatCNDDescriptionBeschreibung
Capture

"capture": {"auto": "Yes"}

"capture": {"manual": "Yes"}

"capture": ...


an..6

OM

Determines the type and time of capture.

Capture ModeDescription
AUTOCapturing immediately after authorisation (default value).
MANUALCapturing made by the merchant. Capture is normally initiated at time of delivery.
<Number>Delay in hours until the capture (whole number; 1 to 696).

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).

BuchungsartBeschreibung
AUTOBuchung sofort nach Autorisierung (Standardwert).
MANUALBuchung erfolgt durch den Händler - in der Regel die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.
<Zahl>Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

Key

REST

Format

CND

Description

Beschreibung

OrderDesc

"order": {"description": "..."}

ans..64

M

Description of purchased goods, unit prices etc.Beschreibung der gekauften Waren, Einzelpreise etc.

KeyRESTFormatCNDDescriptionBeschreibung
URLNotify"urls": {"notify": "..."}

ans..256

M

Complete URL which Paygate calls up in order to notify the shop about the payment result. The URL may be called up only via port 443. It may not contain parameters: Use the UserData parameter instead.

(Info) Common notes:

  • We recommend to use parameter "response=encrypt" to get an encrypted response by Paygate
  • However, fraudster may just copy the encrypted DATA-element which are sent to URLFailure and send the DATA to URLSuccess/URLNotify. Therefore ensure to check the "code"-value which indicates success/failure of the action. Only a result of "code=00000000" should be considered successful.

Vollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData.

(Info) Allgemeine Hinweise:

  • Wir empfehlen, den Parameter "response=encrypt" zu verwenden, um eine verschlüsselte Antwort von Paygate zu erhalten
  • Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den "code"-Wert des DATA-Elements. Nur eine Antwort mit "code=00000000" sollte als erfolgreich angesehen werden.

Key

REST

Format

CND

Description

Beschreibung

MerchantIDExt

"payment": {"applePay": { "merchantIdentifierOfPublicKey": "..." }}

ans..128

C

Merchant Identifier of Public Key

Mandatory if more then one Merchant Identifiers are stored with Computop

Merchant Identifier des Public Keys

Pflicht, wenn mehr als ein Merchant Identifier bei Computop hinterlegt ist.

TokenExt

"payment": {"applePay": { "token": "..." }}

ans..6000

M

Apple Pay PKPaymentToken as JSON string in the Base64 format

Example for TokenExt
{
 "paymentData": {
  "data": "GiZiyzsI6r6lnPYUeceR6itk2PDyBozl2Xy77c5u2X8Ze7l5EasyyH4Q6BoAevrvBfe0FnUNARBEXRySLwqqnpUHO6Du/amZEECRXxlrH91wFqH4oXry2CTDRu7TaIlmnR+s3ien5JI8iWo9hoEW7hyJOE7QGaS6rfR1CtQ4DWJEUq/tFnW98tj3kwKU6iOAAvE467boopMDGBS1fK5HzGXs4hH/6r+LPRfSOKBi1L5VWAexs9Bzw3ByyG69i52doRuFb1xOcMOJbmPg40hap13IjBW6dnj1phbsqP2i/JxvWPV3EcuqpuIoVZr5w53w//pPsl54kmeXNddIjVD5dIhhOKZ8AznD4eL2dbzkp6bic8xScBf3G8hrKXTRTL7V+KT2S+TQliHN0SNXrFu6B6o=",
  "signature": "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",
  "header": {
      "publicKeyHash": "OgiD2qBTWYf/a+LDshFeQcPq6tOmePu0epHpP4ZkNicc=",
      "ephemeralPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEc/HxA3lJZrC+B0ITom0Iji+gFdn7ivGtpI+fl2u8n8XByPgBaVK2b44qUvsGigoNd0OFLNXo0Q07R2B54eIdS3A==",
      "transactionId": "156632b2aadf355d4958d9051a42bf62e07aea5716e72083aa64247944f6e3e14d"
  },
  "version": "EC_v1"
 },
 "paymentMethod": {
  "displayName": "MasterCard 0063",
  "network": "MasterCard",
  "type": "debit"
 },
 "transactionIdentifier": "156632B2AAD12F355D4958D9051A42BF62E07AE5716E720AA6424794F6E3E14567D"
}

Apple Pay PKPaymentToken als JSON-String im Base64-Format

Beispiel für TokenExt
{
 "paymentData": {
  "data": "GiZiyzsI6r6lnPYUeceR6itk2PDyBozl2Xy77c5u2X8Ze7l5EasyyH4Q6BoAevrvBfe0FnUNARBEXRySLwqqnpUHO6Du/amZEECRXxlrH91wFqH4oXry2CTDRu7TaIlmnR+s3ien5JI8iWo9hoEW7hyJOE7QGaS6rfR1CtQ4DWJEUq/tFnW98tj3kwKU6iOAAvE467boopMDGBS1fK5HzGXs4hH/6r+LPRfSOKBi1L5VWAexs9Bzw3ByyG69i52doRuFb1xOcMOJbmPg40hap13IjBW6dnj1phbsqP2i/JxvWPV3EcuqpuIoVZr5w53w//pPsl54kmeXNddIjVD5dIhhOKZ8AznD4eL2dbzkp6bic8xScBf3G8hrKXTRTL7V+KT2S+TQliHN0SNXrFu6B6o=",
  "signature": "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",
  "header": {
      "publicKeyHash": "OgiD2qBTWYf/a+LDshFeQcPq6tOmePu0epHpP4ZkNicc=",
      "ephemeralPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEc/HxA3lJZrC+B0ITom0Iji+gFdn7ivGtpI+fl2u8n8XByPgBaVK2b44qUvsGigoNd0OFLNXo0Q07R2B54eIdS3A==",
      "transactionId": "156632b2aadf355d4958d9051a42bf62e07aea5716e72083aa64247944f6e3e14d"
  },
  "version": "EC_v1"
 },
 "paymentMethod": {
  "displayName": "MasterCard 0063",
  "network": "MasterCard",
  "type": "debit"
 },
 "transactionIdentifier": "156632B2AAD12F355D4958D9051A42BF62E07AE5716E720AA6424794F6E3E14567D"
}

Channel

"channel": {"type": "..."}

a..10

C

Channel over which the order is processed.

Allowed values are WEBSITE and MOBILE_APP.

The channel parameter is mandatory for RedSys. Please provide it if your processor is RedSys. For other processors, it is not obligatory to provide this information.

Kanal, über den die Bestellung abgewickelt wird.

Erlaubt sind die Werte WEBSITE und MOBILE_APP.

Der Parameter Channel ist für RedSys obligatorisch. Bitte geben Sie ihn an, wenn Ihr Prozessor RedSys ist. Für andere Prozessoren ist die Angabe dieser Information nicht obligatorisch.

Parameter für Apple Pay


Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:

(info) es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

(info) die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

KeyRESTFormatCNDDescriptionBeschreibung

mid

"merchantId": "..."

ans..30

M

MerchantID, assigned by Computop

HändlerID, die von Computop vergeben wird

Key

REST

Format

CND

Description

Beschreibung

PayID

"paymentId": "..."

an32

M

ID assigned by Paygate for the payment, e.g. for referencing in batch files

This ID refers to the credit card transaction unless an error occurs already at the Apple Pay transaction.

Vom Paygate vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien.

Diese ID bezieht sich auf die Kreditkarten-Transaktion, es sei denn, es kommt bereits bei der Apple-Pay-Transaktion zu einem Fehler.

KeyRESTFormatCNDDescriptionBeschreibung
XID"xId": "..."

an32

M

ID for all single transactions (authorisation, capture, credit note) for one payment assigned by Paygate

Vom Paygate vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden

KeyRESTFormatCNDDescriptionBeschreibung
TransID"transactionId": "..."

ans..64

MTransactionID provided by you which should be unique for each paymentIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

KeyRESTFormatCNDDescriptionBeschreibung
refnr"referenceNumber": "..."

ns..30

O

Merchant’s unique reference number

Eindeutige Referenznummer des Händlers

KeyRESTFormatCNDDescriptionBeschreibung
UserData"metadata[userData]": "..."

ans..1024

O

If specified at request, Paygate forwards the parameter with the payment result to the shop.

Wenn beim Aufruf angegeben, übergibt das Paygate die Parameter mit dem Zahlungsergebnis an den Shop.

KeyRESTFormatCNDDescriptionBeschreibung
Status

"status": "OK"

"status": "FAILED"

a..50

M

OK (URLSuccess) or FAILED (URLFailure)

OK (URLSuccess) oder FAILED (URLFailure)

KeyRESTFormatCNDDescriptionBeschreibung
Description"description": "..."

ans..1024

M
Further details in the event that payment is rejected. Please do not use the Description but the Code parameter for the transaction status analysis!
Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description, sondern Code für die Auswertung des Transaktionsstatus!

KeyRESTFormatCNDDescriptionBeschreibung
Code"code": ...

an8

M

Error code according to Paygate Response Codes (A4 Error codes)

Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

KeyRESTFormatCNDDescriptionBeschreibung

MAC

---

an64

M
Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here:
Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier:

Key

REST

Format

CND

Description

Beschreibung
schemeReferenceID

"payment": {"schemeReferenceId": "..."}

ans..64CCard scheme specific transaction ID required for subsequent credential-on-file payments, delayed authorizations and resubmssions.Kartensystemspezifische Transaktions-ID, die für nachfolgende Zahlungen mit hinterlegten Daten, verzögerte Autorisierungen und Wiedereinreichungen erforderlich ist.

Ergebnis-Parameter für Apple Pay



Buchung / Gutschrift /Storno

Buchungen, Gutschriften und Stornos beziehen sich nicht auf die Transaktion bei Apple Pay, sondern direkt auf die Kreditkarten-Transaktion. Hierzu finden Sie weitere Informationen im Dokument Kreditkarten.

Batch-Nutzung der Schnittstelle

Buchungen, Gutschriften und Stornos über Batch beziehen sich nicht auf die Transaktion bei Apple Pay, sondern direkt auf die Kreditkarten-Transaktion. Hierzu finden Sie weitere Informationen im Dokument Kreditkarten.