支付前获取支付参数一些参数
更新时间:2021-10-18
支付前获取支付参数一些参数
一、背景说明:
1、正常情况下,车机端小程序调用车机端宿主,宿主调用车机端支付SDK,支付SDK调用车联网中台,车联网中台调用收银台。
2、但是因为车联网已有的小程序有直接调用收银台的需求,因为商家入驻是车联网PM入驻(公私钥车联网配置),如果需要直接调用收银台,请求时那就要有私钥加密参数,收银台用公钥验证签名,这样设计但不能对开发者暴露私钥,所以得车联网中台帮忙构造直接调用收银台的参数。
二、共同说明api说明
Api共同接口说明V2 注意:如果外部人员看不到,需要导出上连接文档
三、接口地址
iovpay/v2/opf/getopfsignedparams
四、Headers
无
五、请求参数
参数名 | 类型 | 是否必填 | 最大长度 | 描述 | 实例值 |
---|---|---|---|---|---|
type | String | 是 | 固定值pay | ||
timestamp | Int | 是 | 10 | 发送请求的时间戳,精确到秒 | 1514917884 |
sign | String | 是 | - | 商户请求参数的签名串,详见签名 详见签名与验签 | |
version | String | 否 | 版本 1.0 | ||
fr_cloud | String | 否 | 适配非百度开发者途虎。具体值由车联网分配 | ||
order_amount | int | 否 | 商品价格,单位为分,建议和下单价格保持一致。当fr_cloud 等于空的时候,此字段必须传 1块钱就是100 | ||
order_name | String | 否 | 商品名称,建议和下单名称一样。当fr_cloud 等于空的时候,此字段必须传 | ||
out_trade_no | String | 是 | 64 | 开发者的订单id | 1069227442364 |
opf_appid | Int | 否 | - | 和dealId同一个值 | 123456 |
六、返回结果
整体是json字符串
接口返回固定为下面的结构
名称 | 类型 | 是否必须 | 最大长度 | 描述 | 实例 |
---|---|---|---|---|---|
errno | int | 是 | 返回码 | 0 | |
errmsg | string | 是 | 返回信息 | ||
data | object | 是 | 返回数据 | {} | |
date | string | 否 | 时间 | 2020-09-09 19:38:38 | |
baidurd | string | 否 | 百度用户后续定位问题字符串 | ||
百度内部人员才需要关注 |
errno 返回0表示成功,其他值为失败
data 的值只有成功的时候才会有可能返回,值可为空
baidurd 部分模块没有返回,属于正常
当errno为0时,data里字段如下:
参数名 | 类型 | 是否必填 | 最大长度 | 描述 | 实例值 |
---|---|---|---|---|---|
dealId | String | 是 | - | 开放平台展示的dealId,值和opf_appid 一样 | - |
appKey | String | 是 | - | 开放平台展示的appKey | - |
totalAmount | String | 是 | - | 订单单价,单位为分 | |
tpOrderId | String | 是 | - | 开发者自己的订单id,和入参out_trade_no同一个值 | |
dealTitle | String | 是 | - | 商品名称,和下单的时候商品名称一致 | |
signFieldsRange | int | 是 | 固定值1,收银台需要的参数 |
bizInfo | 参数值是一个json字符串,json_decode 之后参数内容如下 | ||||
---|---|---|---|---|---|
dealId | String | 是 | - | 开放平台展示的dealId,值和opf_appid 一样 | - |
appKey | String | 是 | - | 开放平台展示的appKey | - |
totalAmount | String | 是 | - | 订单单价,单位为分 | |
tpOrderId | String | 是 | - | 开发者自己的订单id,和入参out_trade_no同一个值 | |
rsaSign | String | 是 | - | 为空字符串 | |
---------end-----bizInfo 参数内容结束----------- | |||||
rsaSign | String | 是 | - | 以上所有参数通过私钥RSA加密得出的字符串 |