接口介绍
根据APPID和设备编号获取设备支付Key,获得的设备Key用户调用支付相关接口。
参数简介
公共参数
| 参数名 | 参数类型 | 参数介绍 | 是否必填 |
|---|
| command | String(32) | 接口名,固定为:open.api.device.key | 是 |
| app_id | String(32) | 应用ID | 是 |
| device_no | String(32) | 设备唯一标识 | 是 |
| version | String(16) | 调用的接口版本,固定为:1.0 | 是 |
| sign_type | String(32) | 签名类型, 固定为:MD5 | 否 |
| request_id | String(64) | 请求报文ID,唯一定位一次报文请求,由发起方生成,应答方原样返回,uuid生成,全局唯一 | 是 |
| request_time | String(32) | 请求发起时间,格式:yyyyMMddHHmmss,请求发起时间,应答方原样返回 | 是 |
| sign | String(32) | 签名,详见MD5签名 | 是 |
参数简介
返回值说明
公共返回值
| 参数名 | 所属结构 | 返回值类型 | 返回值说明 | 特殊备注 |
|---|
| success | result | boolean | 标识这次请求是否成功 | 请不要用这个值来判断收银是否成功,订单的结果以返回的order_status为准。 |
| error_code | result | String(64) | 错误码 |
|
| error_msg | result | String(16) | 错误码的详细说明 |
|
| app_id | data | String(32) | 应用ID |
|
| device_no | data | String(64) | 设备唯一标识 |
|
| request_id | data | String(64) | 请求报文ID |
|
| request_time | data | String(32) | 请求发起时间,格式:yyyyMMddHHmmss |
|
| response_time | data | String(32) | 请求返回时间,格式:yyyyMMddHHmmss |
|
| sign | sign | String | 签名值 | 具体参照: 接口验签规则 |
数据返回值
| 参数名 | 所属结构 | 返回值类型 | 返回值说明 | 特殊备注 |
|---|
| device_key | data | String(64) | 设备支付Key |
|
| request_domain | data | String(64) | 采宝的订单号,最长64位 |
|
| merchant_name | data | String(256) | 商户名称 |
|
| store_name | data | String(256) | 门店名称 |
|
| operator_name | data | String(256) | 收银员名称 |
|
返回值示例
{
"result": {
"success": true
}
,"data":{
"app_id":"BOPU",
"device_no":"1234566",
"request_id":"123456789123456",
"request_time":"20181224170247",
"response_time":"20181224170302",
"device_key": "abc123",
"request_domain": "http://openapi.caibaopay.com/gatewayOpen.htm",
"merchant_name":"我是商户名",
"store_name":"我是门店名",
"operator_name":"我是收银员名"
}
,"sign":"NH/qBDrbyn3ZQYe535dO74sZuw7JeZo6ht8hWRyEASeshIc2KE11bxhG5Qd4QdvlodZYBRunaclEOMM19ZCUWmu5lFGprMR5KjcXSlZ7ErPTn82V5y8j7DuuAH/3UnxV/E6ZWlu788ooQ3xTncNNDs3WivSKwOgJsnDLZbVrFaxUzK+RnMr2p5myLY4Qo4D9AV9afPbJJTBszpAybcu0GBPeilBe4TZX/iLgSYb1SRryhnwlf94cgTREWa8u/0tBV8XJmzlAxmmCZHJtjDJqSJ8aAktdj2Y3QrzunQ3a4I07D+UaXU+csQAxJsCILQi8ye2ke4N+xQPvjdDo+cb8yw=="
}Js Demo
http://openapi.qiantupay.net/test/api/device/deviceKey.htm