Onerway
POST

创建支付链接

该接口用于创建支付链接,买家可打开该链接进入 Onerway 托管收银台完成支付。

请求

merchantNo
Onerway 分配的商户号;获取方式参见接入准备。
示例:
linkName
支付链接展示名称,用于在列表查询和商户运营中识别链接。
amount
指定货币的支付金额;零小数货币使用整数。格式要求详见币种与金额校验。
示例:
currency
支付币种,ISO 4217 三位字母货币代码,需与 amount 匹配。
示例:
defaultCountry
支付链接收银台页面使用的默认国家或地区代码,建议使用 ISO 3166-1 alpha-2 两位字母国家代码。
示例:
itemName
商品或服务名称,展示给买家。
description
商品或服务描述,展示给买家。
collectEmail
支付链接收银台页面是否采集买家邮箱。
示例:
collectName
支付链接收银台页面是否采集买家姓名。
示例:
sign
请求签名字符串;生成方式详见请求签名。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/v1/txn/paymentLink/add' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "amount": 99.99,
  "collectEmail": true,
  "collectName": true,
  "currency": "USD",
  "defaultCountry": "US",
  "description": "Demo product description",
  "itemName": "Demo product",
  "linkName": "Demo payment link",
  "merchantNo": "replace_with_merchant_no",
  "sign": "{{SIGN}}"
}'

响应

respCode
响应码;20000 表示请求处理成功,其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读说明。
业务数据对象,包含创建成功后的支付链接信息。

响应示例

示例代码暂不可用。

该接口暂未记录错误响应。