Documentation/Référence API

API REFERENCE

Virement bancaire

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

Virement bancaire

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.

Paramètres

ParameterTypeDescriptionObligatoire
data.request_idstring请求id需保持唯一,建议24以上位数字+字母✓
data.pay_methodstringonline✓
data.sub_pay_methodstringBank Transfer✓
data.order_idstring商户的订单ID✓
data.amountstring金额数字。例如 € 24.99 应该写成24.99,欧元金额>=1✓
data.currencystringEUR✓
data.descriptionstring订单描述✓
data.emailstring用户邮箱—
data.demostring自定义字段—
data.timeoutstring过期时间单位分钟(0-1440)✓
data.redirect_urlstring支付完成后跳转地址—
data.notify_urlstring支付完成后异步通知地址✓

S’applique aux virements bancaires des utilisateurs

Paybybank est un moyen de paiement sécurisé par virement bancaire proposé par YabandPay. Les clients règlent leurs achats en transférant directement les fonds de leur compte bancaire vers le compte désigné de YabandPay.

Cette solution convient aux marchands qui recherchent des coûts réduits et des transactions fiables sans dépendre des réseaux de cartes. Dès réception du virement, YabandPay vérifie automatiquement le paiement et met à jour le statut de la transaction, pour une expérience de paiement fluide pour les marchands comme pour les clients.

Conseil

Paybybank prend uniquement en charge les virements via le réseau SEPA (Espace unique de paiements en euros). Les virements SWIFT ne sont pas acceptés.

ParamètreTypeDescriptionObligatoire
userStringCompte caissier UIDObligatoire
signStringSignatureObligatoire
methodStringv3.BankTransferObligatoire
timeLongTimestampObligatoire
  • Parameters | Paramètre | Type | Description | Obligatoire | |:--- |:--- |:--- |:--- | | request_id | String | ID de requête unique ; une combinaison de chiffres et de lettres d’au moins 24 caractères est recommandée | Obligatoire | | pay_method | String | online | Obligatoire | | sub_pay_method | String | Virement bancaire | Obligatoire | | order_id | String | ID de commande du marchand | Obligatoire | | amount | String | Montant numérique. Par exemple, € 24.99 doit être indiqué comme 24.99 ; le montant minimum en euros est >=1 | Obligatoire | | currency | String | EUR | Obligatoire | | description | String | Description de la commande | Obligatoire | | email | String | Adresse e-mail de l’utilisateur | Facultatif | | demo | String | Champ personnalisé | Facultatif | | timeout | String | Délai d’expiration en minutes (0-1440) | Obligatoire | | redirect_url | String | URL de redirection après le paiement | Facultatif | | notify_url | String | URL de notification asynchrone après le paiement | Obligatoire |

Exemple de signature :

Paramètres triés et concaténés dans une chaîne de requête au format URL

"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"

Signer stringA avec secret_key

La signature obtenue est :

"YOUR_SIGNATURE"

Exemple de requête :

{
    "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"
    }
}

Exemple de réponse :

{
    "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"
}

Informations complémentaires :

Résultat de la réponse :
  1. Une requête réussie renvoie "status": true.

  2. Une requête échouée renvoie "status": false.

Nous recommandons d’utiliser Notifications asynchrones pour mettre à jour le statut de paiement et garantir l’exactitude des informations de paiement en temps réel.

Codes de réponse :
StatusCodeMessage
true200Success
false-1000Internal error
false-3001Required field is missing
false-403The signature Error
false-4011Not support the payment method