支付
第一步
创建支付订单
POST
https://service.xxx.com/platformapi/chainup/open/opay/createThirdOrder
需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign
Headers
Name | Type | Description |
---|---|---|
Content-Type * | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
app_id* | String | 商家唯一app_id |
time | String | 请求时间 |
sign | String | 用rsa_third_pri对query中的数据签名 |
data | String | rsa_saas_pub加密query中数据 |
以下为参与rsa加密的参数:
名称 | 类型 | 是否必需 | 例子 | 描述 |
---|---|---|---|---|
appOrderId | String | YES | 11321 | 商家端订单id |
openId | String | YES | 2ae04ed9165624419bad68e9e0f3f29fbd | 付款用户的唯一id |
userId | String | YES | 22033390 | 付款用户uid(与openid必须存在一个) ||同时存在优先取openid |
orderAmount | String | YES | 10 | 金额 |
orderSceneType | String | NO | 1000011 | 订单的场景类型,数字枚举 |
payCoinSymbol | String | YES | BTC | 支付币种,大写如BTCappKey |
returnPage | String | YES | https://www.google.com | 前台跳转商家的页面 |
notifyPage | String | YES | https://www.google.com | 后台通知商家的地址 |
token | String | NO | 2ae04ed9165624419bad68e9e0f3f29fbd | 授权的token |
goods | String | NO | 商品描述信息,可不传,传入必须为合法的json格式,否则订单创建失败 ;json中的子字段为 name : 商品名称 desc:商品描述 例:[{"name":"商品1","desc":"商品信息123balabala"},{"name":"商品2","desc":"商品信息23balabala"},{"name":"商品3","desc":"商品信息33balabala"}] |
第二步
支付页面
GET
https://service.xxx.com/platform/pay.html
最后支付页瓶装完成后为: https://service.xxx.com/platform/pay.html?appKey=xxx&openId=xxx&token=xxx&orderNum=xxx
Query Parameters
Name | Type | Description |
---|---|---|
appKey | String | |
orderNum | String | 平台编号支付人 openId,必须是订单创建人 |
openId | String | 支付人 openId,必须是订单创建人 |
userId | String | 付款用户 uid(与 openid 必须存在一个) |
token* | String | 授权的 token |
参数:
uid 与 openid 二选一必填
名称 | 类型 | 是否必需 | 例子 | 描述 |
---|---|---|---|---|
appKey | String | YES | xxx_xxx | 商家唯一appKey |
orderNum | String | YES | 1000000009 | 平台编号支付人 openId,必须是订单创建人 |
openId | String | NO | 2ae04ed9165624419bad68e9e0f3f29fbd | 付款用户的唯一id |
userId | String | NO | 2023203 | 付款用户 uid |
token | String | NO | 2ae04ed9165624419bad68e9e0f3f29fbd | 授权的token |
第三步
支付结果回调接口
POST
https://service.xxx.com/notifyPage
该接口URL由对接商户提供,第一步创建订单时传出的参数:notifyPage 支付完成后,支付结果会通过notifyPage对应的URL进行通知
需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign
Headers
Name | Type | Description |
---|---|---|
Content-Type* | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
app_id* | String | 商家唯一app_id |
time | String | 请求时间 |
sign | String | 用rsa_third_pri对query中的数据签名 |
data | String | rsa_saas_pub加密query中数据 |
以下为参与rsa加密的参数:
名称 | 类型 | 是否必需 | 例子 | 描述 |
---|---|---|---|---|
outOrderId | String | YES | 1000000009 | 商家端订单号 |
orderNum | String | YES | 10000000002 | 开放平台订单编号 |
orderStatus | String | YES | 1 | 订单状态(1 待支付; 2 支付失败;3 支付成功; 0 已关闭) |
payAmount | String | YES | 200 | 订单金额 |
returnUrl | String | YES | https://www.google.com | 同步通知页面(下单接口传入) |
查询支付订单
查询支付订单
POST
https://service.xxx.com/platformapi/chainup/open/opay/orderDetail
Headers
Name | Type | Description |
---|---|---|
Content-Type * | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
appKey* | String | 商家唯一app_id |
orderNum* | String | 平台方订单编号 |
token | String | 授权的token |
参数:
名称 | 类型 | 是否必需 | 例子 | 描述 |
---|---|---|---|---|
app_id | String | YES | xxx_xxx | 商家唯一appKey |
orderNum | String | YES | 10000000002 | 开放平台订单编号 |
token | String | NO | 2ae04ed9165624419bad68e9e0f3f29fbd | 授权的token |
商家日贴对账单
商家日贴对账单
POST
https://service.xxx.com/platformapi/chainup/open/opay/merchantBillingDay
需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign
Headers
Name | Type | Description |
---|---|---|
Content-Type * | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
sign* | String | 用rsa_third_pri对query中的数据签名 |
app_id* | String | 商家唯一app_id |
time* | String | 请求时间 |
data* | String | rsa_saas_pub加密query中数据 |
以下为参与rsa加密的参数:
名称 | 类型 | 是否必需 | 例子 | 描述 |
---|---|---|---|---|
orderType | String | YES | 1 | 订单类型(1=支付订单;11=划转订单),不传查询所有订单 |
day | String | YES | 2099-01-01 | 统计的日期,格式:yyyy-MM-dd,不符合格式参数异常;不传查询当日订单 |
pageNum | String | YES | 1 | 查询第几页,同分页逻辑;不传查所有 |
pageSize | String | YES | 200 | 每页大小,同分页逻辑;不传查2000(最大为2000,数据超过2000请分页查询) |
取消待支付订单
POST
https://service.xxx.com/opay/cancelOrder
需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign
Headers
Name | Type | Description |
---|---|---|
Content-Type * | String | application/json |
Request Body
Name | Type | Description |
---|---|---|
app_id* | String | 商家唯一app_id |
time* | String | 请求时间 |
sign* | String | 用rsa_third_pri对query中的数据签名 |
data* | String | rsa_saas_pub加密query中数据 |
以下为参与rsa加密的参数:
名称 | 类型 | 是否必需 | 例子 | 描述 |
---|---|---|---|---|
orderNum | String | YES | 10000001 | 订单编号 |
Last updated