API REFERENCE
Virement bancaire
Paramètres
| Parameter | Type | Description | Obligatoire |
|---|---|---|---|
| data.request_id | string | 请求id需保持唯一,建议24以上位数字+字母 | ✓ |
| data.pay_method | string | online | ✓ |
| data.sub_pay_method | string | Bank Transfer | ✓ |
| data.order_id | string | 商户的订单ID | ✓ |
| data.amount | string | 金额数字。例如 € 24.99 应该写成24.99,欧元金额>=1 | ✓ |
| data.currency | string | EUR | ✓ |
| data.description | string | 订单描述 | ✓ |
| data.email | string | 用户邮箱 | — |
| data.demo | string | 自定义字段 | — |
| data.timeout | string | 过期时间单位分钟(0-1440) | ✓ |
| data.redirect_url | string | 支付完成后跳转地址 | — |
| data.notify_url | string | 支付完成后异步通知地址 | ✓ |
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ètre | Type | Description | Obligatoire |
|---|---|---|---|
| user | String | Compte caissier UID | Obligatoire |
| sign | String | Signature | Obligatoire |
| method | String | v3.BankTransfer | Obligatoire |
| time | Long | Timestamp | Obligatoire |
- 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¤cy=EUR&demo=test&description=Test&email=info@yabandmedia.com&method=v3.BankTransfer¬ify_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 :
-
Une requête réussie renvoie "status": true.
-
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 :
| Status | Code | Message |
|---|---|---|
| true | 200 | Success |
| false | -1000 | Internal error |
| false | -3001 | Required field is missing |
| false | -403 | The signature Error |
| false | -4011 | Not support the payment method |
