统一下单
本章主要介绍统一下单接口，商户可以通过爱智 Web-SDK 调用该接口，在翼辉支付平台生成预支付交易单，返回正确的预支付交易会话标识后，由 Web-SDK 通过手机的爱智 App 发起支付。
请求参数
| 字段名 | 类型 | 是否必填 | 示例值 | 说明 |
|---|
| amount_currency | String(10) | 是 | CNY | 支付金额币种，目前仅支持人民币：CNY，CNY 符合 ISO 4217 标准的三位字母代码 |
| amount_total | String(9) | 是 | 21.00 | 订单支付总金额，单位为元，保留小数点后两位，最大值为 1000.00，最小值为 0.01 |
| app_no | String(32) | 是 | APP1000000 | 翼辉支付平台审核通过的支付应用号 |
| description | String(100) | 是 | 支付类应用 | 商品详细描述 |
| extra | String(100) | 否 | 分店 | 附加数据，在查询和通知支付结果的 API 中原样返回，该字段主要用于商户携带订单的自定义数据 |
| mch_trade_no | String(50) | 是 | mp202104021606341385640107521832 | 商户订单号，最小长度为 24，最大长度为 50 |
| notify_url | String(256) | 否 | https://your.domain.com/path/to/pay/notify | 接收翼辉支付异步通知的回调地址，通知 URL 必须为直接可访问的 URL，请求方式为 POST，不允许 URL 传参，且必须是 HTTPS 地址 |
| time_expire | String(32) | 否 | 2024-06-24T18:00:28+08:00 | 订单过期时间，最短值为 90 秒，最长值为 1 小时，默认值也为 1 小时。遵循 rfc3339 标准格式，格式为 YYYY-MM-DDTHH:mm:ss+TIMEZONE，各字段含义如下：- YYYY-MM-DD：年月日
- T：出现在字符串中，表示 time 元素的开头
- HH:mm:ss：时分秒
- TIMEZONE：时区（+08:00 表示东八区时间，领先 UTC 8 小时，即北京时间）
|
| aco_pay_sdk | String(12) | 否 | 2.0.0 | 翼辉支付 Java SDK 的版本号 |
| version | String(3) | 否 | 1.0 | 调用的接口版本，固定值 1.0 |
请求示例
{
"amount_currency": "CNY",
"amount_total": "21.00",
"app_no": "APP1000000",
"description": "支付类应用",
"extra": "分店",
"mch_trade_no": "mp202104021606341385640107521832",
"notify_url": "https://your.domain.com/path/to/pay/notify",
"time_expire": "2024-06-24T18:00:28+08:00",
"aco_pay_sdk": "2.0.0",
"version": "1.0"
}
响应参数
| 字段名 | 类型 | 示例值 | 说明 |
|---|
| status | int | 200 | 返回状态码 |
| message | String(100) | SUCCESS | 返回信息，取值为 SUCCESS 表示调用成功，其余均为调用失败，详情请参见 错误码 |
| fieldErrors | String(50) | 商户订单号重复 | 异常信息，当 message 不为 SUCCESS 时，返回具体错误原因 |
| data | object | "data": {} | 具体业务的返回信息 |
响应示例
正确响应示例
{
"status": 200,
"message": "SUCCESS",
"fieldErrors": null,
"data": {
"channel_param": {
"package": "Sign=WXPay",
"appid": "wxcb8fd7bdb3b3b737",
"sign": "05F8183C0B8BF7D22D3FD13E3C6B431A",
"partnerid": "1600755972",
"prepayid": "wx2310422357342707078c2a454f87050000",
"noncestr": "1epJWos1KmLaoO3PrzUWDBFchT89n7Va",
"timestamp": "1619145743"
},
"channel": "WECHAT_PAY",
"transaction_no": "AP202112151202412537829842926708447350",
"mch_trade_no": "mp202104231038052597374768886181"
}
}
错误响应示例
{
"status": 1001,
"message": "INVALID_PARAMETER",
"fieldErrors": "商户订单号重复!",
"data": {
"mch_no": "MCH1000000",
"sign_type": "SHA256withRSA",
"sign": "Zmg9MTdUSYvKeIZ9piviFbj2p88jR3UNSPdnWJ4Ei+zuJN3RG1g8GaH4x2kOnp6iisGcjbCumNS2/08vcjm/aeQolYyyZtO2QSmTa8zZV54YRj9zukoLxl9QqxDOIg0J8/csPy/nZtQTiqSD3czHxAYcnK33eCTQY2qyY0WLW7UWTq8OeD0pEd7oGXvOD6ckraNRkbvkWj/K541drHA59LkmPjxMohEllINUBbkohvNo/mGXc5aBp46Hwqfe5DpVJm/8GBPZpDVh068Fz2G8ln4BOi7uFzUWxxmU9MXYf2VqQO+pSiGS682zn08vS5fEDj6VXu32wLZORsK43MxK9g==",
"nonce": "7lN3Eufi3kHHP5T8zH8ucqMX5ny1COud"
}
}
陕公网安备61019002002605号