Bizum
Bizum是在西班牙广泛使用的移动支付解决方案,旨在支持用户与企业之间通过手机号码实现即时转账。 对商户而言,Bizum 提供了一种快速、安全且易用的收款方式,可同时覆盖线上场景与实体门店:它能直接集成到企业的官网、应用程序(APP)或销售点系统(POS 系统)中,消费者只需输入手机号码或扫描二维码,即可完成支付。 交易实时结算,且支付需通过消费者的手机银行应用授权完成,这既保障了高度安全性,也符合《修订支付服务指令》(PSD2)的监管要求。 由于西班牙多数主流银行均支持 Bizum 服务,且其用户规模已超过 2500 万,因此能为商户带来三大核心价值:触达更广泛的客群、降低购物车弃购率,以及不存在拒付风险。
API URL:https://mapi.yabandpay.com/Payments
Method:POST
POST data type:Json
参数 | 类型 | 描述 | 是否必填 |
---|---|---|---|
user | String | 收银员账号的UID | 必填 |
sign | String | 签名 | 必填 |
method | String | v3.CreatePayments | 必填 |
time | Long | 时间戳 | 必填 |
- 参数
Parameter | Type | Description | 是否必填 |
---|---|---|---|
pay_method | String | online | 必填 |
sub_pay_method | String | Bizum | 必填 |
order_id | String | 商户的订单ID | 必填 |
amount | String | 金额数字。例如 € 24.99 应该写成24.99,欧元金额>=1 | 必填 |
currency | String | EUR | 必填 |
description | String | 订单描述 | 必填 |
demo | String | 自定义字段 | 选填 |
timeout | String | 过期时间单位分钟(0-1440) | 必填 |
redirect_url | String | 支付完成后跳转地址 | 选填 |
notify_url | String | 支付完成后异步通知地址 | 必填 |
签名示例:
拼接为URL方式并排序后的字符串
"amount=1¤cy=EUR&demo=test&description=YabandPay test&method=v3.CreatePayments¬ify_url=https://www.yabandpay.com/notify&order_id=20240726785412369&pay_method=online&redirect_url=https://www.yabandpay.com&sub_pay_method=Bizum&time=1646388458&timeout=0&user=016683"
得到的 stringA 使用 secret_key做签名
得到的签名如下:
"44af984b4376b38b6c0fd00f704c8d55ed3b5ecb19c91a10f8a823a85db61a2b"
提交示例:
{
"user": "016683",
"sign": "44af984b4376b38b6c0fd00f704c8d55ed3b5ecb19c91a10f8a823a85db61a2b",
"method": "v3.CreatePayments",
"time": 1646388458,
"data": {
"description": "YabandPay test",
"timeout":"0",
"pay_method": "online",
"sub_pay_method": "Bizum",
"order_id": "20240726785412369",
"amount": "1",
"currency": "EUR",
"redirect_url": "https://www.yabandpay.com",
"notify_url": "https://www.yabandpay.com/notify",
"demo": "test"
}
}
返回示例:
{
"status": true,
"code": "200",
"data": {
"order_id": "20240726785412369",
"trade_id": "6ff1026e-e4e9-f6c9-d275-3323594064e0",
"amount": "1.00",
"currency": "EUR",
"url": "https://pay.yabandpay.com/pay_method/Yml6dW0=/NmZmMTAyNmUtZTRlOS1mNmM5LWQyNzUtMzMyMzU5NDA2NGUw",
"state": "processing"
},
"message": ""
}
更多信息:
返回结果:
若调用成功,则返回
"status": true
若调用失败,则返回
"status": false
我们强烈建议同时使用订单查询和异步通知来同步和更新支付状态,以确保支付信息的实时准确性。
返回代码:
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 |