Page tree

Search

Skip to end of metadata
Go to start of metadata


Integration Guide

Version 6.9

Stand 10.06.2020


Inhaltsverzeichnis


Dokumenthistorie

Datum

Name

Änderung

10.06.2020

Peter Posse

Erstfassung

 


Über Unified Barcode payment

Allgemeine Informationen über General information about Unified Barcode payment

Seitdem Alipay Spot Payment sowie Quick Pay von WeChat Pay in das Paygate integriert sind, gibt es 2 Schnittstellen für Barcode-Zahlungen. Um eine Zahlung auszulösen, muss der Händler den Kunden vorab fragen, welche Zahlungsmethode verwendet werden soll, Alipay oder WeChat Pay.

Um den Prozess auf der Händlerseite zu vereinfachen und dem Händler einen bequemen Ablauf von Barcode-Zahlungen mit dem Paygate anzubieten, kann eine einheitliche Schnittstelle für beide Barcode-Zahlungsarten verwendet werden. Basierend auf dem "Barcode" kamm vom Paygate erkannt werden, um welche Zahlungsmethode es sich handelt, und dann wird der Prozess an das entsprechende Schema weitergeleitet.




Diagramm zum Prozessablauf

Prozessablauf für Unifed Barcode payment


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ürzungBeschreibung

CND

Bedingung (condition)

M

Pflicht (mandatory)

O

optional

C

bedingt (conditional)


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


Aufruf der Schnittstelle

Um eine Zahlung mit Unified Barcode payment über eine Server-zu-Server-Verbindung auszuführen, 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:

Parameter

Format

CND

Beschreibung

MerchantID

ans..30

M

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

TransID

ans..64

M

TransaktionsID, die für jede Zahlung eindeutig sein muss

RefNr

ans..30

O

eindeutige Referenznummer

Amountn..10M

Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).

Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.

Currencya3MWährung, drei Zeichen DIN / ISO 4217
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus

OrderDesc

ans..256

M

Name der Transaktion, der in der Transaktionsliste angezeigt wird

OrderDesc2ans..256OTransaktionshinweis

UserData

ans..1024

O

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

BuyerIDCodeans..32MCVon der Alipay-App erzeugter Code. Er dient zur Identifikation des Nutzers.
TimeOutn..14OC

Nur für WeChat: Zeitlimit für eine Transaktion. Einheit: Minuten. Mindestens 1 Minute.

Optionaler Parameter von WeChat Pay: wird berücksichtigt, wenn es eine Zahlung mit WeChat Pay ist.
GoodsCategoryan..32OC

Nur für WeChat: Product category. Meaning at WeChat Pay: Intended purpose on discount coupon.

Optionaler Parameter vonWeChat Pay: wird berücksichtigt, wenn es eine Zahlung mit WeChat Pay ist.
LimitboolOC

Nur für WeChat: If true, credit cards won't be accepted in the payment, otherwise credit cards will be accepted.

Optionaler Parameter von WeChat Pay: wird berücksichtigt, wenn es eine Zahlung mit WeChat Pay ist.

Parameter für Zahlungen mit Unified Barcode payment

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

Parameter

Format

CND

Description

MID

ans..30

M

HändlerID, die von Computop vergeben wird

PayID

an32

M

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

XID

an32

M

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

TransID

ans..64

M

Transaktionsnummer des Händlers

RefNr

ns..30

O

Eindeutige Referenznummer

Status

a..50

M

OK, FAILED oder AUTHORIZE_REQUEST (Falls kein finaler Status von Alipay existiert. Kunden müssen die Zahlung eventuell in der App mit ihrem Kennwort bestätigen.)

Description

ans..1024

M

Nähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!

Code

n8

M

Fehlercode gemäß Excel-Datei Paygate Antwort Codes (Teil des Software Clients auf https://www.computop.com/de/downloads/)

UserData

ans..1024

O

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

CodeExt

ans..40

OC

Nur für WeChat: Fehlercode von WeChat. Bei einer Zahlung mit Alipay nicht enthalten.

ErrorText

ans..256

O

Fehlertext vom nachgelagerten System, nur wenn mit dem Computop Support abgesprochen (in MAT konfiguriert).

TID

ans..64

OC

Only for Alipay: TransactionID generated by Alipay system. Bei einer Zahlung mit WeChat Pay Alipay nicht enthalten.

Ergebnis-Parameter für Zahlungen mit Unified Barcode payment


Gutschrift / Storno

Gutschriften mit Referenz sowie Stornierungen hängen vom gewählten Zahlungssystem Alipay oder WeChat Pay ab. Zur Verarbeitung solcher nachfolgenden Transaktionen sehen Sie bitte in den jeweiligen Handbüchern für Alipay oder WeChat Pay nach.