支付

第一步

创建支付订单

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

{
    "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

金额

orderSceneType

String

1000011

订单的场景类型，数字枚举

payCoinSymbol

String

YES

BTC

支付币种，大写如BTCappKey

returnPage

String

YES

https://www.google.com

前台跳转商家的页面

notifyPage

String

YES

https://www.google.com

后台通知商家的地址

token

String

2ae04ed9165624419bad68e9e0f3f29fbd

授权的token

goods

String

商品描述信息，可不传，传入必须为合法的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

2ae04ed9165624419bad68e9e0f3f29fbd

付款用户的唯一id

userId

String

2023203

付款用户 uid

token

String

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

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

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

名称

类型

是否必需

例子

描述

outOrderId

String

YES

1000000009

商家端订单号

orderNum

String

YES

10000000002

开放平台订单编号

orderStatus

String

YES

订单状态(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


{
    "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

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

{
    "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=支付订单；11=划转订单），不传查询所有订单

day

String

YES

2099-01-01

统计的日期，格式：yyyy-MM-dd，不符合格式参数异常；不传查询当日订单

pageNum

String

YES

查询第几页，同分页逻辑；不传查所有

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

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

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

名称

类型

是否必需

例子

描述

orderNum

String

YES

10000001

订单编号

PreviousOAuth授权 Next赠币

Last updated 1 year ago