3.2.1 富友新增终端

联调环境

POST

/openapi/merchant/fuiou/term

终端处理API

1，该接口目前仅支持富友渠道调用

请求参数

Body 参数application/json

appId

string

应用APPID

必需

商户应用APPID

subSn

string | null

子商户编码

可选

非必传项，目前仅代理商/服务商可传，普通商户和平台商户请勿传入

timestamp

string

时间戳

必需

请求时间戳单位秒，要求timestamp与当前时间间隔在60秒以内

requestId

string

请求id

必需

请求唯一标识，无其他意义，必须每一次请求不允许重复，用于定位问题

signType

string

签名方式

必需

固定值：RSA2

bizContent

object

请求参数

必需

由于工具限制，该字段必须转为JSON 格式字符串，请注意

mchChannelCode

string

子通道code

必需

商户后台应用通道内通道编号

tmSerialNo

string

终端序列号

必需

请联系商务提供

tmContactPs

string

终端联系人

必需

tmContactPh

string

联系人电话

必需

tmProvCd

string

终端布放所在省份

必需

tmCityCd

string

终端布放所在市

必需

tmCountyCd

string

终端布放所在区县

必需

tmInstArea

string

终端布放地址

必需

tmBindInd

string

是否绑定电话

必需

0未绑定 1已绑定

tmPhoneNo

string

终端绑定电话号码

可选

未绑定电话必传

sign

string

签名

必需

参照签名方法

示例

{
  "appId": "APP_8428691003",
  "subSn": "null",
  "timestamp": "1736147022",
  "requestId": "ebf71394-facb-4e26-8a98-985d6cd54c74",
  "signType": "RSA2",
  "bizContent": {
    "mchChannelCode": "17dbddbe-8547-485f-b023-77377aed9a88",
    "tmSerialNo": "7eeb5340-b727-4b86-9043-bcf98df650a9",
    "tmContactPs": "薄安琪",
    "tmContactPh": "081-56176655",
    "tmProvCd": "10000",
    "tmCityCd": "10000",
    "tmCountyCd": "10000",
    "tmInstArea": "松侬96号",
    "tmBindInd": "0",
    "tmPhoneNo": "0102-99389884"
  },
  "sign": "H6oAMOljItjCsEC72RmZ/s9VFg/BFZbv3oPtUKjoM7w3jeNgCLOrFASD0o3Qbesnd9xkCbT62IJt/sNBvs47ja02X2QGBYg5+aXIZ6zn6Uu+HegqdMYBTtjrY3t2sBHVr+QK5mZo59Ic7baVEz4NTBkS/BPbtlrwIvbcqq9quSZ5vCyBt/nkXUNy0JgxtzCofwT8I4pKWUQcWovI+AIt/a0wW8VOcoKA+vif4DmiNK0BitypOYpr4aFDZodj8DYdBRXQFA12KRCk1q3HERvQSLE33FAg+xF+LOKy2zLucqdjgzBSwne0CVOhjKDXU9EdQO1bH+fRam9A83HT0sUJsw=="
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.qywh8.com/openapi/merchant/fuiou/term' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "APP_8428691003",
    "subSn": "null",
    "timestamp": "1736147022",
    "requestId": "ebf71394-facb-4e26-8a98-985d6cd54c74",
    "signType": "RSA2",
    "bizContent": {
        "mchChannelCode": "17dbddbe-8547-485f-b023-77377aed9a88",
        "tmSerialNo": "7eeb5340-b727-4b86-9043-bcf98df650a9",
        "tmContactPs": "薄安琪",
        "tmContactPh": "081-56176655",
        "tmProvCd": "10000",
        "tmCityCd": "10000",
        "tmCountyCd": "10000",
        "tmInstArea": "松侬96号",
        "tmBindInd": "0",
        "tmPhoneNo": "0102-99389884"
    },
    "sign": "H6oAMOljItjCsEC72RmZ/s9VFg/BFZbv3oPtUKjoM7w3jeNgCLOrFASD0o3Qbesnd9xkCbT62IJt/sNBvs47ja02X2QGBYg5+aXIZ6zn6Uu+HegqdMYBTtjrY3t2sBHVr+QK5mZo59Ic7baVEz4NTBkS/BPbtlrwIvbcqq9quSZ5vCyBt/nkXUNy0JgxtzCofwT8I4pKWUQcWovI+AIt/a0wW8VOcoKA+vif4DmiNK0BitypOYpr4aFDZodj8DYdBRXQFA12KRCk1q3HERvQSLE33FAg+xF+LOKy2zLucqdjgzBSwne0CVOhjKDXU9EdQO1bH+fRam9A83HT0sUJsw=="
}'

返回响应

🟢200OK

application/json

Body

code

integer

请求状态

必需

返回200=成功，其他状态均为失败

msg

string

返回信息

可选

appId

string

应用APPID

可选

string

商户编码

可选

sign

string

签名

可选

timestamp

string

时间戳

可选

signType

string

签名方式目前仅支持RSA2

可选

示例

{
  "code": 0,
  "msg": "string",
  "appId": "string",
  "sn": "string",
  "sign": "string",
  "timestamp": "string",
  "signType": "string"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

3.1.3 商户审核异步通知