Dokumentation/API-Referenz

API REFERENCE

CardCheck

POSThttps://mapi.yabandpay.com/Payments
Live API
API PLAYGROUND · Live API

CardCheck

POSThttps://mapi.yabandpay.com/Payments
Automatically signed with your credentials

Request parameters10

Required fields first

CardCheck

pay_methodRequiredstringdata.pay_methodonline
sub_pay_methodRequiredstringdata.sub_pay_methodCardCheck
operationRequiredstringdata.operation3
descriptionRequiredstringdata.description订单描述
timeoutRequiredstringdata.timeout过期时间单位分钟(0-1440)
notify_urlRequiredstringdata.notify_url支付完成后异步通知地址
request_idRequiredstringdata.request_id请求id需保持唯一,建议24以上位数字+字母
Optional parameters 3
form_typeOptionalstringdata.form_type返回的url类型,默认01。 01.completed, 02.iframe
demoOptionalstringdata.demo自定义字段
redirect_urlOptionalstringdata.redirect_url支付完成后跳转地址

Credentials stay on this page. Your secret key is never stored or sent to the documentation server.

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.

ParameterTypBeschreibungErforderlich
userStringKassiererkonauf UIDErforderlich
signStringSignatureErforderlich
methodStringv3.CardCheckErforderlich
timeLongTimestampErforderlich
  • Parameter
ParameterTypBeschreibungErforderlich
pay_methodStringonlineErforderlich
sub_pay_methodStringCardCheckErforderlich
operationString3Erforderlich
order_idStringHändlerbestellnummerErforderlich
descriptionStringBestellbeschreibungErforderlich
form_typeStringTyp der zurückgegebenen URL; Stundardwert ist 01. 01.completed, 02.iframeOptional
demoStringBenutzerdefiniertes FeldOptional
timeoutStringAblaufzeit in Minuten (0-1440)Erforderlich
redirect_urlStringWeiterleitungs-URL nach der ZahlungOptional
notify_urlStringURL für asynchrone Benachrichtigung nach der ZahlungErforderlich
request_idStringEindeutige Anfrage-ID; empfohlen wird eine Kombination aus Ziffern und Buchstaben mit mindestens 24 ZeichenErforderlich

Signaturbeispiel:

Nach Parametern sortierte Werte, verkettet zu einer URL-ähnlichen Abfragezeichenfolge

"description=cardcheck test&form_type=01&method=v3.CardCheck&notify_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:
  1. Eine erfolgreiche Anfrage gibt "status": true.

  2. 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:
StatusCodeMessage
true200
false-1000Internal error
false-403The signature Error
false-2001The user not exist
false-3001Required field is missing
false-4118Incorrect request ID