统一下单
通过此接口返回发起H5、PC、APP钱包支付链接，完成钱包支付。
业务请求参数
| 字段名称 | 字段key | 必填 | 格式 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(1,32) | 固定值：order |
| 版本号 | version | M | String(1,8) | 固定值：1.0.0 |
| 应用编号 | appId | M | String(1,32) | 商户后台创建的应用ID |
| 商户订单号 | orderId | M | String(1,40) | 保持全局唯一 |
| 商户订单名称 | orderName | M | String(1,128) | |
| 订单详情 | orderDetail | M | String(1,1000) | |
| 订单金额 | orderAmount | M | Number(1,22) | 取值币种的最小货币单位 |
| 支付币种 | payCurrency | M | String(3) | 固定值：INR 其他币种参见 货币列表 |
| 结算币种 | settleCurrency | M | String(3) | USD 或 HKD 默认结算币种：USD |
| 支付方式 | payMethod | M | String(3) | 固定值：INDIA 其他钱包参见 支付方式 |
| 支付场景 | payScene | M | String(1,10) | 参见 支付场景 |
| 操作系统类型 | osType | C | String(1,10) | 参见 操作系统 当支付场景为非WEB时，必填 |
| 商户后台通知地址 | serverNotifyUrl | M | String(1,256) | 交易结果后台通知地址 |
| 商户前台回调地址 | frontNotifyUrl | O | String(1,256) | 前端页面回调，当支付成功后会向该地址进行跳转 |
| 商户订单超时时间 | orderTimeout | O | Number(4) | 默认3600秒 |
| 终端用户 Id | payerId | M | String(1,32) | 发起付款的终端用户ID |
| 付款人姓名 | payerName | M | String(1,32) | 必须要与付款人信息保持一致 |
| 付款人手机 | payerMobile | M | String(1,24) | 必须要与付款人信息保持一致 |
| 付款人电子邮件 | payerEmail | M | String(1,24) | 必须要与付款人信息保持一致 |
| 付款人国家代码 | payerCountryCode | M | String(2) | 必须要与付款人信息保持一致 |
请求示例报文
json
{
"appId": "000110011816681",
"funcode": "order",
"version": "1.0.0",
"orderId": "6b6967ae-E27c-EAFC-26Eb-AE822fC68953",
"orderName": "test",
"payCurrency": "CNY",
"orderAmount": "1000",
"orderDetail": "test",
"settleCurrency": "USD",
"serverNotifyUrl": "http://127.0.0.1:10800/testNotify",
"osType": "ANDROID",
"payWallet": "ALIPAY_CN",
"payMethod": "APP",
"orderTimeout": "3600",
"frontNotifyUrl": "http://127.0.0.1:10800/frontNotify",
"clientIp": "16.207.220.190"
}接口同步返回
| 字段名称 | 字段key | 必填 | 类型 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(1,40) | 固定值：order |
| 版本号 | version | M | String(1,8) | 固定值：1.0.0 |
| 应用编号 | appId | M | String(1,32) | 商户后台创建的应用ID |
| 商户订单号 | orderId | M | String(1,40) | |
| 平台订单号 | transId | O | String(1,40) | 下单成功时返回 |
| 订单金额 | orderAmount | M | Number(22) | 支付单金额，取值币种的最小货币单位 |
| 支付币种 | payCurrency | M | String(3) | 固定值：INR 其他币种参见 货币列表 |
| 交易状态 | orderStatus | O | String(14) | 下单成功时返回 参见 交易状态 |
| 支付链接 | payUrl | O | String(64) | 下单成功时返回 |
| 商户订单开始时间 | orderStartTime | O | String(64) | 下单成功时返回 |
| 商户订单过期时间 | orderExpireTime | O | String(64) | 下单成功时返回，过期后订单会自动关单 |
| 响应时间 | responseTime | M | String(4) | |
| 响应码 | responseCode | M | String(1,16) | 参见 交易响应码 |
| 响应信息 | responseMsg | M | String(1,200) | 参见 交易响应码 |
| 错误码 | errorCode | O | String(1,16) | 请求失败时返回 参见 交易错误码 |
| 错误信息 | errorMsg | O | String(200) | 请求失败时返回 参见 交易错误码 |
WARNING
- 商户订单号与APPID组成唯一约束。
- payUrl为调用钱包短链接。
- 用户支付成功后通过异步通知、交易查询接口获取支付状态。
返回示例报文
json
{
"appId": "000110011816681",
"funcode": "order",
"orderAmount": "1000",
"orderExpireTime": "20240108103907",
"orderId": "6b6967ae-E27c-EAFC-26Eb-AE822fC68953",
"orderStartTime": "20240108093907",
"orderStatus": "pending",
"payCurrency": "CNY",
"payUrl": "alipayconnect://platformapi/alipayconnectcode.html?code=281666040099gl0t9g3GOzTTyu1kX8Z0bslh&pspName=ALIPAY_CN&loadMode=2",
"responseCode": "success",
"responseMsg": "请求成功",
"responseTime": "20240108093907",
"transId": "2401080939076440202",
"version": "1.0.0"
}