支付

第一步

创建支付订单

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中数据

200: OK

{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体
{
  "orderNum":"xxxx",  //订单编号		
}

以下为参与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中数据

200: OK

{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息 客户端收到请求后返回success，代表已收到请求	
    "data": "",
    "sign": ""
}

以下为参与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

200: OK

{
    "totalAccount": [ //商户支持的所有账户list	
      {
        "accountName": "nostrud qui", //账户名称(下拉菜单中显示)	
        "accountType": -88610101, //账户类型(id)需要回传给后端的相当于id字段	
        "accountBalance": 24283812.991745576 //支付用户该账户的余额
      },
      {
        "accountName": "consequat tempor nulla ullamco",
        "accountType": 57824482,
        "accountBalance": -38228228.129181474
      }
    ],
    "googleStatus": -93156512.86876366, //是否开启google验证；0-未开启,1-开启
    "appOrderId": "non aute ut", //商家订单id
    "sign": "est aliqua non eu", //签名
    "orderNum": "magna laborum dolore proident", //订单编号
    "orderStatus": "voluptate do eu Lorem", //订单状态(1 待支付； 2 支付失败；3 支付成功； 0 已关闭)
    "userId": 8957369, //用户id	
    "isOpenMobileCheck": "do consequat", //是否开启手机短信效验；0-未开启,1-开启
    "orderAmount": "aute enim ut", //订单金额
    "payCoinSymbol": "nulla", //支付币种	
    "ctime": "id ad conse",
    "appKey": "in aute",
    "showPrecision": "voluptate occaecat reprehenderit" //显示的精度
}

参数:

名称	类型	是否必需	例子	描述
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中数据

200: OK

{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体
{
    "count": 1000, //当日记录总数；  
    "list": [
      {
        "merchantUserId": 23000, //商家收款用户id；
        "appOrderId": "100000019", //商家端订单id；
        "payCoinSymbol": "btc", //支付使用币种； 
        "orderAmount": 10, //订单操作数量；
        "orderType": 1, //订单类型(1、支付订单;11、划转(退款)订单)  
        "userId": 230000, //付款用户id；付款用户id；  
        "openId": "2ae04ed9165624419bad68e9e0f3f29fbd", //付款用户openid；  
        "createTime": "11200321123", //下单时间，到毫秒； 
        "payTime": "320012321" //实际支付完成时间，到毫秒；  
      },
      {
        "merchantUserId": 23000, //商家收款用户id；
        "appOrderId": "100000019", //商家端订单id；
        "payCoinSymbol": "btc", //支付使用币种； 
        "orderAmount": 10, //订单操作数量；
        "orderType": 1, //订单类型(1、支付订单;11、划转(退款)订单)  
        "userId": 230000, //付款用户id；付款用户id；  
        "openId": "2ae04ed9165624419bad68e9e0f3f29fbd", //付款用户openid；  
        "createTime": "11200321123", //下单时间，到毫秒； 
        "payTime": "320012321" //实际支付完成时间，到毫秒； 
      }
    ]
}

以下为参与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中数据

200: OK

{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

以下为参与rsa加密的参数:

名称	类型	是否必需	例子	描述
orderNum	String	YES	10000001	订单编号