支付

第一步

创建支付订单

POST https://service.xxx.com/platformapi/chainup/open/opay/createThirdOrder

需要将参数表格中的数据包装成json字符串利用rsa 进行参数加密和签名作为body中的data和sign

Headers

Name	Type	Description
Content-Type *	String	application/json

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

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	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"}]

名称

类型

是否必需

例子

描述

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

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

名称

类型

是否必需

例子

描述

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

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

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	订单状态(1 待支付； 2 支付失败；3 支付成功； 0 已关闭)
payAmount	String	YES	200	订单金额
returnUrl	String	YES	https://www.google.com	同步通知页面(下单接口传入)

名称

类型

是否必需

例子

描述

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

Name

Type

Description

Content-Type *

String

application/json

Request Body

Name	Type	Description
appKey*	String	商家唯一app_id
orderNum*	String	平台方订单编号
token	String	授权的token

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	NO	2ae04ed9165624419bad68e9e0f3f29fbd	授权的token

名称

类型

是否必需

例子

描述

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

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

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	订单类型（1=支付订单；11=划转订单），不传查询所有订单
day	String	YES	2099-01-01	统计的日期，格式：yyyy-MM-dd，不符合格式参数异常；不传查询当日订单
pageNum	String	YES	1	查询第几页，同分页逻辑；不传查所有
pageSize	String	YES	200	每页大小，同分页逻辑；不传查2000（最大为2000，数据超过2000请分页查询）

名称

类型

是否必需

例子

描述

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

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

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	订单编号

名称

类型

是否必需

例子

描述

orderNum

String

YES

10000001

订单编号

PreviousOAuth授权 Next赠币

Last updated 9 months ago