Ü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" kann vom Paygate erkannt werden, um welche Zahlungsmethode es sich handelt, und dann wird der Prozess an das entsprechende Schema weitergeleitet.

Logo	8621616
Info	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.
Typ	Zahlungen per eWallet

Diagramm zum Prozessablauf

eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6IkFkbWluIiwib3V0cHV0VHlwZSI6ImJsb2NrIiwibGFzdE1vZGlmaWVyTmFtZSI6IkFkbWluIiwibGFuZ3VhZ2UiOiJlbiIsInVpQ29uZmlnIjoie1wiY3VzdG9tUHJlc2V0Q29sb3JzXCI6W1wiMTQxOTMyXCIsXCIwMDVhOTZcIixcIjAwOWVmZlwiLFwiZTQwMDAwXCIsXCJhNWY3MjlcIixcImZmYjcwMFwiXSxcImRlZmF1bHRDdXN0b21MaWJyYXJpZXNcIjpbXCJBMVwiXSxcInZlcnNpb25cIjpcIjEuMFwifSIsImRpYWdyYW1EaXNwbGF5TmFtZSI6IiIsInNGaWxlSWQiOiIiLCJhdHRJZCI6IjYxODMzMzg5IiwiZGlhZ3JhbU5hbWUiOiJVbmlmaWVkIEJhcmNvZGUgcGF5bWVudCIsImFzcGVjdCI6IiIsImxpbmtzIjoiYXV0byIsImNlb05hbWUiOiJVbmlmaWVkIEJhcmNvZGUgcGF5bWVudCIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6MjYyNDc0MjAsImVkaXRhYmxlIjpmYWxzZSwiY2VvSWQiOjI2MjQ3NDIwLCJwYWdlSWQiOiIiLCJsYm94Ijp0cnVlLCJzZXJ2ZXJDb25maWciOnsiZW1haWxwcmV2aWV3IjoiMSJ9LCJvZHJpdmVJZCI6IiIsInJldmlzaW9uIjowLCJtYWNyb0lkIjoiNmFjYTgxMDItYWY2ZC00NTc5LTk5MjItYzI1NGIxNzVkMDVlIiwicHJldmlld05hbWUiOiJVbmlmaWVkIEJhcmNvZGUgcGF5bWVudC5wbmciLCJsaWNlbnNlU3RhdHVzIjoiT0siLCJzZXJ2aWNlIjoiIiwiaXNUZW1wbGF0ZSI6IiIsIndpZHRoIjoiMTEwOSIsInNpbXBsZVZpZXdlciI6ZmFsc2UsImxhc3RNb2RpZmllZCI6Ikp1bCAyNiwgMjAyMiwgMzoyMDo0NyBQTSIsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9

Auf dieser Seite

Paygate-Schnittstelle

Definitionen

Datenformate

Format	Beschreibung
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ürzung	Beschreibung	Kommentar
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

Um eine Zahlung mit Unified Barcode payment über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

https://www.computop-paygate.com/barcode.aspx

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:

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

Key	Format	CND	Description	Beschreibung
MerchantID	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.

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ans..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format	CND	Description	Beschreibung
Amount	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.

Key	Format	CND	Description	Beschreibung
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

Key	Format	CND	Description	Beschreibung
MAC	an64	M	Hash Message Authentication Code (HMAC) with SHA-256 algorithm. Details can be found here: HMAC Authentication (Request) HMAC Authentication (Notify)	Hash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Name of the transaction which is displayed in the transactions list	Name der Transaktion, der in der Transaktionsliste angezeigt wird
OrderDesc2	ans..768	O	Transaction notice	Transaktionshinweis

Key	Format	CND	Description	Beschreibung
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	Format	CND	Description	Beschreibung
BuyerIDCode	ans..32	MC	Code generated by the Alipay-App. It is designed for the identification of a user.	Von der Alipay-App erzeugter Code. Er dient zur Identifikation des Nutzers.
TimeOut	n..14	OC	Only for WeChat: Time limit for a transaction. Unit: minutes. At least 1 minutes. Optional parameter of WeChat Pay: will be regarded when it’s a payment of WeChat Pay.	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.
GoodsCategory	an..32	OC	Only for WeChat: Product category. Meaning at WeChat Pay: Intended purpose on discount coupon. Optional parameter of WeChat Pay: will be regarded when it’s a payment of WeChat Pay.	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.
Limit	bool	OC	Only for WeChat: If true, credit cards won't be accepted in the payment, otherwise credit cards will be accepted. Optional parameter of WeChat Pay: will be regarded when it’s a payment of WeChat Pay.	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

The following table describes the result parameters with which the Computop Paygate responds to your system

pls. be prepared to receive additional parameters at any time and do not check the order of parameters

the key (e.g. mid, RefNr) should not be checked case-sentive

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

Key	Format	CND	Description	Beschreibung
mid	ans..30	M	MerchantID, assigned by Computop	HändlerID, die von Computop vergeben wird

Key	Format	CND	Description	Beschreibung
PayID	an32	M	ID assigned by Paygate for the payment, e.g. for referencing in batch files as well as for capture or credit request.	Vom Paygate vergebene ID für die Zahlung; z.B. zur Referenzierung in Batch-Dateien sowie im Capture- oder Credit-Request.

Key	Format	CND	Description	Beschreibung
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

Key	Format	CND	Description	Beschreibung
TransID	ans..64	M	TransactionID provided by you which should be unique for each payment	Ihre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss

Key	Format	CND	Description	Beschreibung
refnr	ans..30	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers

Key	Format		CND	Description	Beschreibung
Status	a..50		M	OK, FAILED or AUTHORIZE_REQUEST (If no final status from Alipay exists. Customers may need to confirm the payment in the app with their password.)	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.)

Key	Format	CND	Description	Beschreibung
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!

Key	Format	CND	Description	Beschreibung
Code	an8	M	Error code according to Paygate Response Codes (A4 Error codes)	Fehlercode gemäß Paygate Antwort-Codes (A4 Fehlercodes)

Key	Format	CND	Description	Beschreibung
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	Format	CND	Description	Beschreibung
CodeExt	ans..40	OC	Only for WeChat: WeChat error code. Not included when it’s a payment of Alipay.	Nur für WeChat: Fehlercode von WeChat. Bei einer Zahlung mit Alipay nicht enthalten.
ErrorText	ans..256	O	Error text from the downstream system, only when its response is discussed with Computop Helpdesk.	Fehlertext vom nachgelagerten System, nur wenn mit dem Computop Helpdesk abgesprochen.
TID	ans..64	OC	Only for Alipay: TransactionID generated by Alipay system. Not included when it’s payment of WeChat Pay.	Nur für Alipay: Vom Alipay-System erzeugte TransactionID. Bei einer Zahlung mit WeChat Pay 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.

Space shortcuts

Page tree