Dokumentation/API-Referenz

API REFERENCE

Banküberweisung

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

Banküberweisung

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

Request parameters11

Required fields first

介绍

request_idRequiredstringdata.request_id请求id需保持唯一,建议24以上位数字+字母
pay_methodRequiredstringdata.pay_methodonline
sub_pay_methodRequiredstringdata.sub_pay_methodBank Transfer
amountRequiredstringdata.amount金额数字。例如 € 24.99 应该写成24.99,欧元金额>=1
currencyRequiredstringdata.currencyEUR
descriptionRequiredstringdata.description订单描述
timeoutRequiredstringdata.timeout过期时间单位分钟(0-1440)
notify_urlRequiredstringdata.notify_url支付完成后异步通知地址
Optional parameters 3
emailOptionalstringdata.email用户邮箱
demoOptionalstringdata.demo自定义字段
redirect_urlOptionalstringdata.redirect_url支付完成后跳转地址

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

Gilt für: Banküberweisungen von Nutzern

Paybybank ist eine sichere, von YabundPay angebotene Zahlungsmethode per Banküberweisung. Kunden bezahlen, indem sie Geld direkt von ihrem Bankkonauf auf das dafür vorgesehene Konauf von YabundPay überweisen.

Diese Lösung eignet sich für Händler, die niedrigere Kosten und zuverlässige Transaktionen wünschen, ohne auf Kartennetzwerke angewiesen zu sein. Sobald die Überweisung eingegangen ist, überprüft YabundPay die Zahlung auaufmatisch und aktualisiert den Transaktionsstatus. So wird Händlern und Kunden ein reibungsloser Zahlungsvorgang ermöglicht.

Tipp

Paybybank unterstützt ausschließlich Überweisungen über das SEPA-Netz (Single Euro Payments Area). SWIFT-Überweisungen werden nicht akzeptiert.

ParameterTypBeschreibungErforderlich
userStringKassiererkonauf UIDErforderlich
signStringSignatureErforderlich
methodStringv3.BankTransferErforderlich
timeLongTimestampErforderlich
  • Parameter
ParameterTypBeschreibungErforderlich
request_idStringEindeutige Anfrage-ID; empfohlen wird eine Kombination aus Ziffern und Buchstaben mit mindestens 24 ZeichenErforderlich
pay_methodStringonlineErforderlich
sub_pay_methodStringBanküberweisungErforderlich
order_idStringHändlerbestellnummerErforderlich
amountStringNumerischer Betrag. Zum Beispiel € 24.99 muss angegeben werden als 24.99; Euro-Betrag >=1Erforderlich
currencyStringEURErforderlich
descriptionStringBestellbeschreibungErforderlich
emailStringE-Mail-Adresse des NutzersOptional
demoStringBenutzerdefiniertes FeldOptional
timeoutStringAblaufzeit in Minuten (0-1440)Erforderlich
redirect_urlStringWeiterleitungs-URL nach der ZahlungOptional
notify_urlStringURL für asynchrone Benachrichtigung nach der ZahlungErforderlich

Signaturbeispiel:

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

"amount=0.1&currency=EUR&demo=test&description=Test&email=info@yabandmedia.com&method=v3.BankTransfer&notify_url=https://www.yabandpay.com/notify&order_id=12455555788&pay_method=online&redirect_url=https://www.yabandpay.com&request_id=001123456789&sub_pay_method=Bank Transfer&time=1653145918&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",
    "method": "v3.BankTransfer",
    "time": "1653145918",
    "sign": "YOUR_SIGNATURE",
    "data": {
        "request_id": "001123456789",
        "order_id" : "YOUR_ORDER_ID",
        "pay_method": "online",
        "sub_pay_method": "Bank Transfer",
        "email": "info@yabandmedia.com",
        "description": "Test", 
        "timeout" : "0",
        "amount": "0.1",
        "currency": "EUR",
        "redirect_url": "https://www.yabandpay.com",
        "notify_url" : "https://www.yabandpay.com/notify",
        "demo": "test"
    }
}

Antwortbeispiel:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "d3a81009-2b3c-9f2c-8e33-45dc932ee757",
        "amount": "0.10",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/prod/bank_transfer/ZDNhODEwMDktMmIzYy05ZjJjLThlMzMtNDVkYzkzMmVlNzU3",
        "state": "processing"
    },
    "message": "",
    "response_id": "202505131817352897785689"
}

Zusätzliche Informationen:

Antwortergebnis:
  1. Eine erfolgreiche Anfrage gibt "status": true.

  2. Eine fehlgeschlagene Anfrage gibt "status": false.

Wir empfehlen die Verwendung von Asynchrone Benachrichtigungen um den Zahlungsstatus zu aktualisieren und Zahlungsinformationen in Echtzeit korrekt zu halten.

Antwortcodes:
StatusCodeMessage
true200Success
false-1000Internal error
false-3001Required field is missing
false-403The signature Error
false-4011Not support the payment method