代付下单

path: /openapi/wd/create

method: POST

content-type: application/json

接口参数

属性	类型	必填/签名	描述	示例
Timestamp	long	是	当前时间戳 精度：秒（10位 UTC）。参考 Unix时间戳	1652361339
AccessKey	string	是	商户 AccessKey 在商户后台获取	BlVnlKWz...
PayChannelId	string	是	支付通道 ID 商户通道支付编码，具体请咨询运营获取	alipay_qr
Payee	string	是	收款人姓名 例如：张三	张三
PayeeNo	string	是	收款人账号 银行卡：填卡号 支付宝：填账号/二维码链接/图片地址	622202...
PayeeAddress	string	是	收款地/银行信息 银行卡：填银行名称（如：招商银行） 支付宝：固定填 支付宝	支付宝
OrderNo	string	是	商户订单号 需保证系统内唯一	PR202604...
Amount	string	是	金额 单位：元，最多两位小数。示例：100, 100.1, 100.01	100.01
CallbackUrl	string	是	异步回调地址 若不需要回调请传 -。不可传 localhost 或百度地址	https://api.com/cb
Ext	string	条件	扩展字段 非空则参与签名。回调时原样回传	test_data
ClientIp	string	条件	客户下单 IP 非空则参与签名	127.0.0.1
ClientId	string	条件	客户会员 ID 非空则参与签名	user_9527
Sign	string	不参与	签名串 详见 签名规则页	31199ff6...

支付宝对接特别说明

• Payee: 收款人姓名。
• PayeeNo: 支付宝账号或二维码图片地址。
• PayeeAddress: 必须填写为 支付宝。
• 具体支付编码: 请务必联系运营确认后再进行调试。

关于条件签名

标记为 条件 的字段（Ext, ClientIp, ClientId）：

1. 如果不传或传递空字符串，不参与签名计算。
2. 如果传递了非空字符串，则必须参与签名计算。

参数示例

{
  "PayChannelId": "1",
  "OrderNo": "846982b5195e449d97f7731acd37dc66",
  "Amount": "100",
  "Payee": "张三",
  "PayeeNo": "551609123123",
  "PayeeAddress": "xxx银行",
  "Ext": "-",
  "CallbackUrl": "https://google.com",
  "AccessKey": "9x84VwL53kfYn6299GlkcR6o",
  "Timestamp": 1652605049,
  "Sign": ".."
}

接口响应

请注意，接口响应超时未返回时，必须调用代付查询接口确认订单真实状态!

未经确认，直接处理支付成功或者失败，导致金额损失，概不负责

响应参数

成功判定

当接口返回 Code == 0 时，表示下单/提交成功。

属性	类型	必填	描述	示例
Code	int	是	接口响应状态码 0 表示成功	0
Message	string	是	响应描述信息	success
Data	object	否	业务数据主体
└─ OrderNo	string	是	平台订单号	DEV2064...
└─ MerchantOrderNo	string	是	商户订单号	846982b...
└─ OrderStatus	int	是	订单状态 参考订单状态表	1
└─ Amount	float	是	订单金额 单位：元	100.0

{
  "Data": {
	"MerchantOrderNo": "846982b5195e449d97f7731acd37dc66",
	"OrderNo": "DEV2022051516573356425587", //平台订单号
	"OrderStatus": 1,
	"Amount": 100.0
  },
  "Code": 0,
  "Message": ""
}

代付订单状态表

状态流转提示

中间状态：状态 1 到 3 属于处理过程中的状态，请勿作为业务入账依据。

结算状态：状态 4 为成功的最终业务状态，状态 16 为失败的。

撤消状态：状态 5 为平账，表示撤回了成功订单，该状态不会发起回调，仅查询订单会返回