接口文档 智能硬件 终端绑定/解绑

终端绑定/解绑

v1

业务描述

针对有通过设备进行交易需求的商户,此接口支持商户对终端进行绑定/解绑。

接口说明

适用对象
服务商商户
请求域名
https://papi.lianfutech.cn
请求方法
/v1/device/bind
请求方式
POST

请求参数

参数名必填类型说明
bindType操作类型
Mint
1-设备绑定;2-设备解绑示例:1
merchantId商户编号
Ostring(64)
惠商系统生成的商户唯一编号。最多支持64个字符示例:M6854955820
deviceSn终端sn/收款码编号
Cstring(64)
最多支持64个字符示例:SN628060010228

请求示例

请求示例点击展开
{
  "merchantId":"M6854955820",
  "bindType":1,
  "deviceSn":"SN628060010228"
}

返回参数

暂无参数

返回示例

返回示例点击展开
//请求成功无业务参数返回,仅有公共参数

SDK 接入

SDK 调用示例点击展开
import com.aggpay.sdk.reqs.merchant.DeviceBindOrUnbindReq;
import com.aggpay.sdk.AggPayClient;
import com.aggpay.sdk.DefaultAggPayClient;
import com.aggpay.sdk.PartnerKey;
import com.aggpay.sdk.vo.RspResult;

public class AggPayTest {

    public static void main(String[] args) {

        //初始化SDK
        AggPayClient aggPayClient = new DefaultAggPayClient(getPartnerKey());
        
        // 创建业务请求对象
        DeviceBindOrUnbindReq deviceBindOrUnbindReq = new DeviceBindOrUnbindReq();
        deviceBindOrUnbindReq.setBindType();
        deviceBindOrUnbindReq.setMerchantId();
        deviceBindOrUnbindReq.setDeviceSn();
        RspResult<String> result = aggPayClient.execute(deviceBindOrUnbindReq);
        
        // 响应结果公共参数,建议首先通过result的code判断响应
        System.out.println(result);
        
        // 响应结果解密后业务参数
        System.out.println(result.getDecryptData());
    }

    public static PartnerKey getPartnerKey() {
        //创建接入密钥配置信息
        PartnerKey partnerKey = new PartnerKey();
        //接入方id
        partnerKey.setPartnerId("");
        //AES密钥
        partnerKey.setDataKey("");
        //接入方RSA私钥
        partnerKey.setClientPri("");
        //服务商RSA公密钥
        partnerKey.setSrvPub("");
        return partnerKey;
    }
}