支付宝碰一碰设备管理 - 收款啦云 MIS-订单支付

请求参数

Body 参数application/json

reqHeader

object (ReqHeader)

通用请求头

必需

transTime

string

必需

请求时间 N14 Y YYYYMMDDhhmmss

transCode

string

可选

交易代码 N6 N 业务交易码，应答原样返回

transSequence

string

可选

交易流水 ANS6…40 N 请求流水号，应答原样返回

reqId

string

必需

请求Id ANS32 Y 商户号、机构号等

certificateId

string

可选

证书id ANS6…40 N 证书Id，多证书情况下需要

easyPayCertificateId

string

可选

易生证书id ANS6…40 N 易生证书Id，多证书情况下需要，为空时使用默认证书

signType

string

签名类型

可选

reqSign

string

请求签名

必需

reqBody

object (IotDeviceManageVO)

请求内容实体

必需

sequenceNo

string

必需

对应terminal_id
设备序列号

<= 32 字符

sceneCode

string

必需

场景值： IOT_DEVICE_RECORDS_G2(可用绑定) IOT_DEVICE_RECORDS_DELETE(解绑) IOT_DEVICE_RECORDS_QUERY（绑定查询）
设备档案管理场景

sceneParams

string

可选

仅G2升级G3时需传值： G2TOG3_UPDATE（可用绑定升级为间联三绑定时传）
设备档案管理场景参数

smid

string

可选

G2绑定只用传smid,绑定时，smid不能为空
支付宝子商户号

pid

string

可选

商户二次验证获取的pid，G3绑定必传
商户pid

shopId

string

可选

shopId
店铺Id

shopName

string

可选

绑定时，店铺名称不能为空
店铺名称

termMerCode

string

可选

对应external_id，商户编号，由ISV定义，需要保证在ISV下唯一,绑定时，终端商户号不能为空
终端商户号

>= 15 字符<= 15 字符

termTermCode

string

可选

对应terminal_bind_info，isv内部唯一标识商户、商户门店等字段信息；可作为ISV自主对接的扩展字段使用,绑定时，终端终端号不能为空
终端终端号

>= 8 字符<= 8 字符

示例

{
    "reqHeader": {
        "transTime": "string",
        "transCode": "string",
        "transSequence": "string",
        "reqId": "string",
        "certificateId": "string",
        "easyPayCertificateId": "string"
    },
    "signType": "string",
    "reqSign": "string",
    "reqBody": {
        "sequenceNo": "string",
        "sceneCode": "string",
        "sceneParams": "string",
        "smid": "string",
        "pid": "string",
        "shopId": "string",
        "shopName": "string",
        "termMerCode": "stringstringstr",
        "termTermCode": "stringst"
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://phoenix.eycard.cn/sklOrder/iotDevice/device/manage' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reqHeader": {
        "transTime": "string",
        "transCode": "string",
        "transSequence": "string",
        "reqId": "string",
        "certificateId": "string",
        "easyPayCertificateId": "string"
    },
    "signType": "string",
    "reqSign": "string",
    "reqBody": {
        "sequenceNo": "string",
        "sceneCode": "string",
        "sceneParams": "string",
        "smid": "string",
        "pid": "string",
        "shopId": "string",
        "shopName": "string",
        "termMerCode": "stringstringstr",
        "termTermCode": "stringst"
    }
}'

返回响应

🟢200成功

application/json

Body

rspHeader

object (RspHeader)

返回头

可选

rspCode

string

可选

应答码 ANS5 Y 00000-成功，其他失败

rspInfo

string

可选

应答消息 ANS128 Y 错误信息

transCode

string

可选

交易代码 N6 N 同请求

transSequence

string

可选

交易流水 ANS6…40 N 同请求

easyPayCertificateId

string

可选

易生证书id ANS6…40 N 易生证书Id，多证书情况下需要，为空时使用默认证书

rspBody

object (IotDeviceManageOutput)

返回内容实体

可选

sequenceNo

string

必需

对应terminal_id
设备序列号

<= 32 字符

supplierId

string

必需

设备供应商ID：supplierId，如意生态版AMX设备请填写“201901111100635561”
设备供应商ID

deviceGrade

string

可选

可用绑定：G2 三绑定：G3
绑定级别可用绑定：G2 三绑定：G3

shopId

string

店铺id

可选

pid

string

店铺id

可选

smid

string

支付宝子商户号

可选

shopName

string

店铺名称

可选

externalId

string

可选

商户编号，由ISV定义，需要保证在ISV下唯一，POSP系统内终端商户号

terminalBindInfo

string

可选

isv内部唯一标识商户、商户门店等字段信息；可作为ISV自主对接的扩展字段使用,POSP系统内终端终端号

rspSign

string

签名信息

可选

signType

string

签名类型

可选

time

string

响应时间-目前

可选

示例

{
  "rspHeader": {
    "rspCode": "",
    "rspInfo": "",
    "transCode": "",
    "transSequence": "",
    "easyPayCertificateId": ""
  },
  "rspBody": {
    "sequenceNo": "",
    "supplierId": "",
    "sceneCode": "",
    "sceneParams": "",
    "shopId": "",
    "shopName": "",
    "recordsType": "",
    "recordsValue": "",
    "termMerCode": "",
    "termTermCode": "",
    "terminalBindInfo": "",
    "merCode": "",
    "termCode": "",
    "termName": "",
    "state": "",
    "type": "",
    "channelCode": ""
  },
  "rspSign": "",
  "signType": "",
  "time": ""
}