API REFERENCE
CardCheck
Starten Sie eine Auaufrisierung über 0, damit der Karteninhaber die angegebene Kartennummer bestätigen kann. Für die Prüfung muss der Karteninhaber gültige Angaben machen.
Die Verifizierung kann über die von YabundPay bereitgestellte gehostete Seite erfolgen. Händler können Anfragen sicher annehmen, indem sensible PCI-DSS-Daten im YabundPay-System verarbeitet werden.
Tipp
Obtain the verification result through Bestellabfrage.
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | Kassiererkonauf UID | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.CardCheck | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| pay_method | String | online | Erforderlich |
| sub_pay_method | String | CardCheck | Erforderlich |
| operation | String | 3 | Erforderlich |
| order_id | String | Händlerbestellnummer | Erforderlich |
| description | String | Bestellbeschreibung | Erforderlich |
| form_type | String | Typ der zurückgegebenen URL; Stundardwert ist 01. 01.completed, 02.iframe | Optional |
| demo | String | Benutzerdefiniertes Feld | Optional |
| timeout | String | Ablaufzeit in Minuten (0-1440) | Erforderlich |
| redirect_url | String | Weiterleitungs-URL nach der Zahlung | Optional |
| notify_url | String | URL für asynchrone Benachrichtigung nach der Zahlung | Erforderlich |
| request_id | String | Eindeutige Anfrage-ID; empfohlen wird eine Kombination aus Ziffern und Buchstaben mit mindestens 24 Zeichen | Erforderlich |
Signaturbeispiel:
Nach Parametern sortierte Werte, verkettet zu einer URL-ähnlichen Abfragezeichenfolge
"description=cardcheck test&form_type=01&method=v3.CardCheck¬ify_url=https://www.yabandpay.com/notify&operation=3&order_id=203040950640690239603690&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&request_id=tscqf7ki76o7aem4z1yl1xs72f89fptl&sub_pay_method=CardCheck&time=1720680417&timeout=0&user=YOUR_CASHIER_UID"
Signieren Sie die Zeichenfolge A mit secret_key
Die resultierende Signatur lautet:
"YOUR_SIGNATURE"
Anfragebeispiel:
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.CardCheck",
"time": 1720680417,
"data": {
"description": "cardcheck test",
"form_type": "01",
"timeout": "0",
"pay_method": "online",
"sub_pay_method": "CardCheck",
"operation": "3",
"order_id": "YOUR_ORDER_ID",
"redirect_url": "https://www.yabandpay.com/redirect_url",
"notify_url": "https://www.yabandpay.com/notify",
"request_id": "tscqf7ki76o7aem4z1yl1xs72f89fptl"
}
}
Antwortbeispiel:
{
"status": true,
"code": "200",
"data": {
"order_id": "YOUR_ORDER_ID",
"trade_id": "160899f3-f6d9-a8d8-ab5b-82eacdab9c5b",
"amount": "0.00",
"currency": "EUR",
"url": "https://pay.yabandpay.com/payments/callback/order/MTYwODk5ZjMtZjZkOS1hOGQ4LWFiNWItODJlYWNkYWI5YzVi",
"state": "processing"
},
"message": "",
"response_id": "202407111544200649155078"
}
Zusätzliche Informationen:
Antwortergebnis:
-
Eine erfolgreiche Anfrage gibt "status": true.
-
Eine fehlgeschlagene Anfrage gibt "status": false.
Leiten Sie weiter zur zurückgegebenen url. Nachdem der Nutzer auf dieser Seite die Kartendaten eingegeben hat url und die Zahlung abgeschlossen hat, wird er zurückgeleitet zu redirect_url synchronously. Wir empfehlen dringend, sowohl Bestellabfrage und Asynchrone Benachrichtigungen um den Zahlungsstatus zu synchronisieren und zu aktualisieren und Zahlungsinformationen in Echtzeit korrekt zu halten. a) Wenn the order status state is paid, Zahlung erfolgreich;
Antwortcodes:
| Status | Code | Message |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -2001 | The user not exist |
| false | -3001 | Required field is missing |
| false | -4118 | Incorrect request ID |
