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&currency=EUR&demo=test&description=YabandPay test&method=v3.CreatePayments&notify_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": ""
}

更多信息:

返回结果:
  1. 若调用成功,则返回"status": true

  2. 若调用失败,则返回"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

results matching ""

    No results matching ""