版本：1.1.1

SSK-串口数据交互文档-1.1.0

版本号	编辑者	更新时间	更新内容
V1.0.0	陈浩	2024/10/14	创建
V1.1.0	房杨平	2025/07/24	数据使用JSON通信,废弃base参数模块, 适用于收款程序1.1.0或更高版本

功能描述

串口初始化：设置串口参数并打开串口与设备建立连接。
数据接收：通过回调接口接收从设备发送的数据。
数据发送：向外部设备发送数据。

SDK下载

SDK下载地址: sxf-20251210-serial-port-v1.1.1.aar
源码下载地址: serial-sdk-demo-1.1.1.zip

接口介绍

注意：这里所有的接口参数都以JSON的格式,所有的接口请求和响应都应该包含公共参数信息。

公共请求参数信息

参数名	类型	是否必填	描述
`api`	`String`	是	接口
`requestId`	`String`	否	调用方唯一请求流水号

公共响应参数信息

参数名	类型	是否必填	描述
`code`	`String`	是	业务响应码，定义业务处理结果状态（见下方响应码说明）
`msg`	`String`	是	业务响应描述信息，用于说明响应码对应的具体结果
`data`	`Object`	是	数据对象
├─ `requestId`	`String`	否	原样返回请求中的流水号，用于请求-响应匹配校验
├─ `api`	`String`	是	接口
├─ `sn`	`String`	是	终端SN

公共响应结构

{
  "code": "00",
  "msg": "SUCCESS",
  "data": {
    "requestId": "971dda25971dda25971dda25",
    "sn": "SI00005958",
    "api": "/sale",
    "..."
  }
}

响应码定义表

常量名	值	类型	说明
`REQUEST`	`"04"`	String	表示请求已发出（待处理状态）
`CONFIRM`	`"03"`	String	请求确认收到（已接收未处理）
`PROCESSING`	`"02"`	String	请求正在处理中（异步处理）
`FAIL`	`"01"`	String	受理异常（业务失败）
`SUCCESS`	`"00"`	String	正常受理（业务成功）

使用说明

初始化串口

serialService = SerialSDKService.getInstance(context);
serialService.setListener(this);
serialService.create("/dev/ttyS2", 9600);
serialService.open();

示例代码

以下是一个完整的示例代码，展示如何使用此 SDK：

public class MainActivity extends AppCompatActivity implements SerialListener  {
    private SerialSDKService serialService;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

       serialService = SerialSDKService.getInstance(context);
       serialService.setListener(this);
       serialService.create("/dev/ttyS2", 9600);
       serialService.open();

       try {
          JSONObject jsonObject = new JSONObject();
          jsonObject.put("api", "/sale");
          jsonObject.put("orderAmount", amount);
          jsonObject.put("paymentType", "01");
          jsonObject.put("merchantSerialNo", UUID.randomUUID());
          jsonObject.put("externalAdditionalData", "external data");
          String jsonString = jsonObject.toString();
          serialService.sendText(jsonString);
        } catch (JSONException e) {
              throw new RuntimeException(e);
          }
    }

    @Override
    public void onDataReceived(String jsonString) {
        try {
            Log.i(TAG, "onDataReceived result: " + new JSONObject(jsonString));
            JSONObject jsonObject = new JSONObject(jsonString);
            String code = jsonObject.optString("code");
            String msg = jsonObject.optString("msg");
            if(code.equals("00")) {
                JSONObject data = jsonObject.optJSONObject("data");
                if (data != null) {
                    String api = data.optString("api");
                    String requestId = data.optString("requestId");
                    String sn = data.optString("sn");

                    Log.d("JSON", "api = " + api);

                    if (api.equals("/sale") && requestId.equals("requestId")) {
                        Log.i(TAG, "onDataReceived: Processing /sale return data");
                    }
                }
            }else {
                Log.e(TAG, "onDataReceived: " + msg );
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    @Override
    public void onError(int errorCode, String errorMessage) {
        Log.i(TAG, "onError: " + errorCode + " errorMessage:" + errorMessage);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        serialService.close(); 
    }
}

接口列表

签到

接口：`/sign`

请求参数

参数名	类型	是否必填	描述
`api`	`String`	是	接口

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/sign");
serialService.sendText(jsonObject.toString());

JSON

{
  "api":"/sign",
}

响应参数

参数名	类型	描述
`signStatus`	`String`	签到状态 `YES` `NO`
`merchantNo`	`String`	商户号
`defaultAmount`	`String`	预授权金额
`showCardSwipeButton`	`String`	是否显示刷卡按钮 `SHOW` `HIDE`

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/sign",
    "sn":"SI00005958",
    "signStatus":"YES",
    "merchantNo":"4276000064",
    "defaultAmount":"45.00",
    "showButton":"SHOW",
    }
}

查询签到信息

接口：`/query/device/status`

请求参数

参数名	类型	是否必填	描述
`api`	`String`	是	接口

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/query/device/status");
serialService.sendText(jsonObject.toString());

JSON

{
  "api":"/query/device/status",
}

响应参数

参数名	类型	描述
`signStatus`	`String`	签到状态 `YES` `NO`
`merchantNo`	`String`	商户号
`defaultAmount`	`String`	预授权金额
`showCardSwipeButton`	`String`	是否显示刷卡按钮 `SHOW` `HIDE`

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/query/device/status",
    "sn":"SI00005958",
    "signStatus":"YES",
    "merchantNo":"4276000064",
    "defaultAmount":"45.00",
    "showButton":"SHOW",
    }
}

消费

接口: `/sale`

参数说明

字段名	类型	是否必传	字段说明
`api`	`String`	是	接口
`paymentType`	`String`	是	支付类型: `01`-银行卡，`04`-二维码(B 扫 C)，`05`-二维码(C 扫 B) `06`-支付卡
`paymentSubType`	`String`	否	支付子类型: 只有 paymentType=06 必传: `12`-八达通
`merchantSerialNo`	`String`	是	商户交易流水号: 需保证全局唯一性
`orderAmount`	`String`	是	订单金额: 最小值为 0.01，两位小数）
`walletType`	`String`	否	钱包类型: paymentType=05 时选填 :`01`-微信，`02`-支付宝，`03`-云闪付，`04`-PayNow，`05`-PayMe
`externalAdditionalData`	`String`	否	附加信息

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/sale");
jsonObject.put("paymentType", "01");
jsonObject.put("merchantSerialNo", UUID.randomUUID());
jsonObject.put("externalAdditionalData", "external data");
String jsonString = jsonObject.toString();
serialService.sendText(jsonString);

JSON

 {
  "api":"/sale",
  "orderAmount":"10.00",
  "paymentType":"01",
  "merchantSerialNo":"13403a5c-f770-4cdc-aeb2-ac537711e4a6",
  "externalAdditionalData":"external data"
 }

响应参数

字段名	类型	字段说明
`merchantSerialNo`	`String`	商户交易流水号
`orderNo`	`String`	系统生成的唯一订单号
`transactionNo`	`String`	交易流水号（全局唯一）
`currency`	`String`	交易币种（ISO 4217 标准，如：`CNY`）
`totalAmount`	`String`	支付总金额
`orderAmount`	`String`	订单金额
`tipAmount`	`String`	小费金额
`payerFee`	`String`	交易手续费金额
`transactionStatus`	`String`	交易状态，参考附录枚举值
`paymentWay`	`String`	支付方式，参考附录枚举值
`paymentType`	`String`	支付类型，参考附录枚举值
`paymentSubType`	`String`	支付子类型，参考附录枚举值
`cardType`	`String`	卡类型，参考附录枚举值
`cardFlag`	`String`	卡标识，参考附录枚举值
`cardBrand`	`String`	卡组织，参考附录枚举值
`cardNoMask`	`String`	脱敏卡号（如：`6214*****5678`）
`posBatchNo`	`String`	POS 终端批次号
`posSerialNo`	`String`	POS 终端流水号
`retrievalNo`	`String`	检索参考号
`authCode`	`String`	交易授权码（联机交易返回）
`transactionTime`	`String`	交易发起时间
`completionTime`	`String`	交易完成时间

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data": {
    "api":"/sale",
    "sn":"SI00005958",
    "merchantSerialNo":"5507f119-64ef-47d4-b49d-77ec7df4a471",
    "orderNo":"10820250724000011304",
    "transactionNo":"TK7D6A93779100000843849731883008",
    "currency":"HKD",
    "totalAmount":"10.00",
    "orderAmount":"10.00",
    "tipAmount":"0.00",
    "payerFee":"0.00",
    "transactionStatus":"00",
    "paymentWay":"01",
    "paymentType":"01",
    "cardBrand":"01",
    "cardNoMask":"433668******3008",
    "posBatchNo":"250724",
    "posSerialNo":"000011",
    "retrievalNo":"520511288288",
    "authCode":"911950",
    "transactionTime":"2025-07-24T11:38:28.000+00:00",
    "completionTime":"2025-07-24T11:38:29.000+00:00"
    }
  }

消费撤销

接口: `/sale/revoke`

请求参数说明

参数名	类型	是否必填	描述
`api`	`String`	是	接口
`originalTransactionNo`	`String`	是	原预授权交易流水号
`merchantSerialNo`	`String`	是	商户交易流水号（需保证全局唯一性）

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/sale/revoke");
jsonObject.put("merchantSerialNo", UUID.randomUUID());
jsonObject.put("originalTransactionNo", transactionNo);
String jsonString = jsonObject.toString();
serialService.sendText(jsonString);

JSON

{
  "api":"/sale/revoke",
  "merchantSerialNo":"690a2439-1753-43ea-828c-264b78438e28",
  "originalTransactionNo":"TKDC694BEF4500000843721092825088"
}

响应参数说明

字段名	类型	描述
`transactionNo`	`String`	交易流水号，本次撤销交易生成的流水号
`originalTransactionNo`	`String`	需要撤销的原交易流水号
`merchantSerialNo`	`String`	原交易对应的商户流水号
`orderNo`	`String`	订单号
`transactionStatus`	`String`	交易状态，参考附录枚举值
`orderAmount`	`String`	原交易订单金额
`paymentType`	`String`	原交支付类型
`paymentSubType`	`String`	原交支付子类型
`transactionTime`	`String`	交易发起时间

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/sale/revoke",
    "sn":"SI00005958",
    "transactionNo":"TK9AE44D4B5900000843681978023936",
    "originalTransactionNo":"TKC696B779F200000843681799766016",
    "merchantSerialNo":"6b30ab46-8084-4fcc-b31a-364ef46376d1",
    "orderNo":"10820250725000011320",
    "transactionStatus":"00",
    "orderAmount":"10.00",
    "paymentType":"01",
    "paymentSubType":"",
    "transactionTime":"2025-07-25T03:26:18.000+00:00"
  }
}

退款

接口: `/refund`

请求参数说明

参数名	类型	是否必填	描述
`api`	`String`	是	接口
`originalTransactionNo`	`String`	是	原预授权交易流水号
`merchantSerialNo`	`String`	是	商户交易流水号（需保证全局唯一性）
`refundOrderAmount`	`String`	是	退款金额

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/refund");
jsonObject.put("merchantSerialNo", UUID.randomUUID());
jsonObject.put("originalTransactionNo", transactionNo);
jsonObject.put("refundOrderAmount", "1.00");
String jsonString = jsonObject.toString();
serialService.sendText(jsonString);

JSON

{
  "api":"/refund",
  "merchantSerialNo":"690a2439-1753-43ea-828c-264b78438e28",
  "originalTransactionNo":"TKDC694BEF4500000843721092825088",
  "refundOrderAmount":"1.00"
}

响应参数说明

字段名	类型	描述
`transactionNo`	`String`	交易流水号，本次撤销交易生成的流水号
`originalTransactionNo`	`String`	需要撤销的原交易流水号
`merchantSerialNo`	`String`	原交易对应的商户流水号
`orderNo`	`String`	订单号
`transactionStatus`	`String`	交易状态，参考附录枚举值
`orderAmount`	`String`	原交易订单金额
`paymentType`	`String`	原交支付类型
`paymentSubType`	`String`	原交支付子类型
`transactionTime`	`String`	交易发起时间

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/refund",
    "sn":"SI00005958",
    "transactionNo":"TK9AE44D4B5900000843681978023936",
    "originalTransactionNo":"TKC696B779F200000843681799766016",
    "merchantSerialNo":"6b30ab46-8084-4fcc-b31a-364ef46376d1",
    "orderNo":"10820250725000011320",
    "transactionStatus":"00",
    "orderAmount":"10.00",
    "paymentType":"01",
    "paymentSubType":"",
    "transactionTime":"2025-07-25T03:26:18.000+00:00"
  }
}

预授权

接口: `/auth`

请求参数说明

参数名	类型	是否必填	描述
`api`	`String`	是	接口
`merchantSerialNo`	`String`	是	商户交易流水号（需保证全局唯一性）
`orderAmount`	`String`	是	订单金额（最小值为0.01，单位：元，两位小数）
`externalAdditionalData`	`String`	否	附加信息

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/auth");
jsonObject.put("merchantSerialNo", UUID.randomUUID());
jsonObject.put("orderAmount", amount);
jsonObject.put("externalAdditionalData", "external data");
String jsonString = jsonObject.toString();
serialService.sendText(jsonString);

JSON

{
  "api":"/auth",
  "merchantSerialNo":"e29fbf56-5947-4270-8ddb-695b2c815b13",
  "orderAmount":"10.00",
  "externalAdditionalData":"external data"
}

响应参数说明

字段名	类型	字段说明
`merchantSerialNo`	`String`	商户交易流水号
`orderNo`	`String`	系统生成的唯一订单号
`transactionNo`	`String`	交易流水号（全局唯一）
`currency`	`String`	交易币种（ISO 4217 标准，如：`CNY`）
`totalAmount`	`String`	支付总金额
`orderAmount`	`String`	订单金额
`tipAmount`	`String`	小费金额
`payerFee`	`String`	交易手续费金额
`transactionStatus`	`String`	交易状态，参考附录枚举值
`paymentWay`	`String`	支付方式，参考附录枚举值
`paymentType`	`String`	支付类型，参考附录枚举值
`paymentSubType`	`String`	支付子类型，参考附录枚举值
`cardType`	`String`	卡类型，参考附录枚举值
`cardFlag`	`String`	卡标识，参考附录枚举值
`cardBrand`	`String`	卡组织，参考附录枚举值
`cardNoMask`	`String`	脱敏卡号（如：`6214*****5678`）
`posBatchNo`	`String`	POS 终端批次号
`posSerialNo`	`String`	POS 终端流水号
`retrievalNo`	`String`	检索参考号
`authCode`	`String`	交易授权码（联机交易返回）
`transactionTime`	`String`	交易发起时间
`completionTime`	`String`	交易完成时间

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/auth",
    "sn":"SI00005958",
    "merchantSerialNo":"282ab07c-019c-48a9-9836-a0425ac111ad",
    "orderNo":"10820250724000011306",
    "transactionNo":"TK76F797295000000843958316105728",
    "currency":"HKD",
    "totalAmount":"10.00",
    "orderAmount":"10.00",
    "tipAmount":"0.00",
    "payerFee":"0.00",
    "transactionStatus":"00",
    "paymentWay":"01",
    "paymentType":"01",
    "paymentSubType":"03",
    "cardBrand":"01",
    "cardNoMask":"433668******3008",
    "posBatchNo":"250724",
    "posSerialNo":"000013",
    "retrievalNo":"520512288295",
    "authCode":"709787",
    "transactionTime":"2025-07-24T12:19:01.000+00:00",
    "completionTime":"2025-07-24T12:19:02.000+00:00"
    }
  }

预授权撤销

接口: `/auth/revoke`

请求参数说明

参数名	类型	是否必填	描述
`api`	`String`	是	接口
`originalTransactionNo`	`String`	是	原预授权交易流水号
`merchantSerialNo`	`String`	是	商户交易流水号（需保证全局唯一性）

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/auth/revoke");
jsonObject.put("merchantSerialNo", UUID.randomUUID());
jsonObject.put("originalTransactionNo", transactionNo);
String jsonString = jsonObject.toString();
serialService.sendText(jsonString);

JSON

{
  "api":"/auth/revoke",
  "merchantSerialNo":"690a2439-1753-43ea-828c-264b78438e28",
  "originalTransactionNo":"TKDC694BEF4500000843721092825088"
}

响应参数说明

字段名	类型	描述
`transactionNo`	`String`	交易流水号，本次撤销交易生成的流水号
`originalTransactionNo`	`String`	需要撤销的原交易流水号
`merchantSerialNo`	`String`	原交易对应的商户流水号
`orderNo`	`String`	订单号
`transactionStatus`	`String`	交易状态，参考附录枚举值
`orderAmount`	`String`	原交易订单金额
`paymentType`	`String`	原交支付类型
`paymentSubType`	`String`	原交支付子类型
`transactionTime`	`String`	交易发起时间

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/sale/revoke",
    "sn":"SI00005958",
    "transactionNo":"TK9AE44D4B5900000843681978023936",
    "originalTransactionNo":"TKC696B779F200000843681799766016",
    "merchantSerialNo":"6b30ab46-8084-4fcc-b31a-364ef46376d1",
    "orderNo":"10820250725000011320",
    "transactionStatus":"00",
    "orderAmount":"10.00",
    "paymentType":"01",
    "paymentSubType":"",
    "transactionTime":"2025-07-25T03:26:18.000+00:00"
  }
}

交易查询

接口: `/query/transaction`

请求参数说明

参数名	类型	是否必填	描述
`api`	`String`	是	接口
`originalTransactionNo`	`String`	否	原交易流水号
`merchantSerialNo`	`String`	否	原商户交易流水号

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/query/transaction");
jsonObject.put("originalTransactionNo", "e29fbf56-5947-4270-8ddb-695b2c815b13");
String jsonString = jsonObject.toString();
serialService.sendText(jsonString);

JSON

{
  "api":"/query/transaction",
  "originalTransactionNo":"e29fbf56-5947-4270-8ddb-695b2c815b13",
}

响应参数说明

字段名	类型	字段说明
`merchantSerialNo`	`String`	商户交易流水号
`orderNo`	`String`	系统生成的唯一订单号
`transactionNo`	`String`	交易流水号（全局唯一）
`currency`	`String`	交易币种（ISO 4217 标准，如：`CNY`）
`totalAmount`	`String`	支付总金额
`orderAmount`	`String`	订单金额
`tipAmount`	`String`	小费金额
`payerFee`	`String`	交易手续费金额
`transactionStatus`	`String`	交易状态，参考附录枚举值
`paymentWay`	`String`	支付方式，参考附录枚举值
`paymentType`	`String`	支付类型，参考附录枚举值
`paymentSubType`	`String`	支付子类型，参考附录枚举值
`cardType`	`String`	卡类型，参考附录枚举值
`cardFlag`	`String`	卡标识，参考附录枚举值
`cardBrand`	`String`	卡组织，参考附录枚举值
`cardNoMask`	`String`	脱敏卡号（如：`6214*****5678`）
`posBatchNo`	`String`	POS 终端批次号
`posSerialNo`	`String`	POS 终端流水号
`retrievalNo`	`String`	检索参考号
`authCode`	`String`	交易授权码（联机交易返回）
`transactionTime`	`String`	交易发起时间
`completionTime`	`String`	交易完成时间

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/query/transaction",
    "sn":"SI00005958",
    "merchantSerialNo":"282ab07c-019c-48a9-9836-a0425ac111ad",
    "orderNo":"10820250724000011306",
    "transactionNo":"TK76F797295000000843958316105728",
    "currency":"HKD",
    "totalAmount":"10.00",
    "orderAmount":"10.00",
    "tipAmount":"0.00",
    "payerFee":"0.00",
    "transactionStatus":"00",
    "paymentWay":"01",
    "paymentType":"01",
    "paymentSubType":"03",
    "cardBrand":"01",
    "cardNoMask":"433668******3008",
    "posBatchNo":"250724",
    "posSerialNo":"000013",
    "retrievalNo":"520512288295",
    "authCode":"709787",
    "transactionTime":"2025-07-24T12:19:01.000+00:00",
    "completionTime":"2025-07-24T12:19:02.000+00:00"
    }
  }

设置营业

接口：`/open/business`

请求参数

参数名	类型	是否必填	描述
`api`	`String`	是	接口

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/open/business");
serialService.sendText(jsonObject.toString());

JSON

{
  "api":"/open/business",
}

响应参数

参数名	类型	描述
`businessStatus`	`String`	营业状态 `OPEN` `CLOSE`

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/open/business",
    "sn":"3080004570",
    "businessStatus":"OPEN",
    }
}

设置停业

接口：`/stop/business`

请求参数

参数名	类型	是否必填	描述
`api`	`String`	是	接口

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/stop/business");
serialService.sendText(jsonObject.toString());

JSON

{
  "api":"/stop/business",
}

响应参数

参数名	类型	描述
`businessStatus`	`String`	营业状态 `OPEN` `CLOSE`

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/stop/business",
    "sn":"3080004570",
    "businessStatus":"CLOSE",
    }
}

查询营业状态

接口：`/query/business/status`

请求参数

参数名	类型	是否必填	描述
`api`	`String`	是	接口

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/query/business/status");
serialService.sendText(jsonObject.toString());

JSON

{
  "api":"/query/business/status",
}

响应参数

参数名	类型	描述
`businessStatus`	`String`	营业状态 `OPEN` `CLOSE`

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/query/business/status",
    "sn":"3080004570",
    "businessStatus":"OPEN",
    }
}

完成交易

接口：`/finish/transaction`

请求参数

参数名	类型	是否必填	描述
`api`	`String`	是	接口

JAVA代码

 jsonObject.put("api", "/finish/transaction");
 String jsonString = jsonObject.toString();
 serialService.sendText(jsonString);

JSON

{
  "api":"/finish/transaction",
}

响应参数说明

公共返回参数

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/finish/transaction",
    "sn":"3080004570",
    "businessStatus":"OPEN",
    }
}

取消交易

接口：`/cancel/transaction`

请求参数

参数名	类型	是否必填	描述
`api`	`String`	是	接口

JAVA代码

JSONObject jsonObject = new JSONObject();
jsonObject.put("api", "/cancel/transaction");
serialService.sendText(jsonObject.toString());

JSON

{
  "api":"/cancel/transaction",
}

响应参数说明

公共返回参数

示例

{
  "code":"00",
  "msg":"SUCCESS",
  "data":{
    "api":"/cancel/transaction",
    "sn":"3080004570",
    }
}

功能描述​

SDK下载​

接口介绍​

公共请求参数信息​

公共响应参数信息​

公共响应结构​

响应码定义表​

使用说明​

初始化串口​

示例代码​

接口列表​

签到​

接口：/sign​

请求参数​

响应参数​

查询签到信息​

接口：/query/device/status​

请求参数​

响应参数​

消费​

接口: /sale​

参数说明​

响应参数​

消费撤销​

接口: /sale/revoke​

请求参数说明​

响应参数说明​

退款​

接口: /refund​

请求参数说明​

响应参数说明​

预授权​

接口: /auth​

请求参数说明​

响应参数说明​

预授权撤销​

接口: /auth/revoke​

请求参数说明​

响应参数说明​

交易查询​

接口: /query/transaction​

请求参数说明​

响应参数说明​

设置营业​

接口：/open/business​

请求参数​

响应参数​

设置停业​

接口：/stop/business​

请求参数​

响应参数​

查询营业状态​

接口：/query/business/status​

请求参数​

响应参数​

完成交易​

接口：/finish/transaction​

请求参数​

响应参数说明​

取消交易​

接口：/cancel/transaction​

请求参数​

响应参数说明​

功能描述

SDK下载

接口介绍

公共请求参数信息

公共响应参数信息

公共响应结构

响应码定义表

使用说明

初始化串口

示例代码

接口列表

签到

接口：`/sign`

请求参数

响应参数

查询签到信息

接口：`/query/device/status`

请求参数

响应参数

消费

接口: `/sale`

参数说明

响应参数

消费撤销

接口: `/sale/revoke`

请求参数说明

响应参数说明

退款

接口: `/refund`

请求参数说明

响应参数说明

预授权

接口: `/auth`

请求参数说明

响应参数说明

预授权撤销

接口: `/auth/revoke`

请求参数说明

响应参数说明

交易查询

接口: `/query/transaction`

请求参数说明

响应参数说明

设置营业

接口：`/open/business`

请求参数

响应参数

设置停业

接口：`/stop/business`

请求参数

响应参数

查询营业状态

接口：`/query/business/status`

请求参数

响应参数

完成交易

接口：`/finish/transaction`

请求参数

响应参数说明

取消交易

接口：`/cancel/transaction`

请求参数

响应参数说明