API REFERENCE

Twint

YabandPay 文档·更新于 2026年10月26日

Twint 支持通过设置 pay_method 为 online、sub_pay_method 为 Twint 发起在线支付订单。

参数	类型	描述	是否必填
user	String	收银员账号的UID	必填
sign	String	签名	必填
method	String	v3.CreatePayments	必填
time	Long	时间戳	必填

参数

Parameter	Type	Description	是否必填
pay_method	String	online	必填
sub_pay_method	String	Twint	必填
order_id	String	商户的订单ID	必填
amount	String	金额数字。例如 EUR 24.99 应写成 24.99	必填
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=Twint&time=1646388458&timeout=0&user=YOUR_CASHIER_UID"

得到的 stringA 使用 secret_key 做签名

得到的签名如下：

"YOUR_SIGNATURE"

提交示例：

{
  "user": "YOUR_CASHIER_UID",
  "sign": "YOUR_SIGNATURE",
  "method": "v3.CreatePayments",
  "time": 1646388458,
  "data": {
    "description": "YabandPay test",
    "timeout": "0",
    "pay_method": "online",
    "sub_pay_method": "Twint",
    "order_id": "YOUR_ORDER_ID",
    "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": "YOUR_ORDER_ID",
    "trade_id": "c21f5489-6ea5-469d-b176-bdf2fd0f61a8",
    "amount": "1.00",
    "currency": "EUR",
    "url": "https://pay.yabandpay.com/pay_method/dHdpbnQ=/YzIxZjU0ODktNmVhNS00NjlkLWIxNzYtYmRmMmZkMGY2MWE4",
    "state": "processing"
  },
  "message": ""
}

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

Twint

Twint

请求参数9

介绍

签名示例：

提交示例：

返回示例：

更多信息：

返回结果：

返回代码：