# 企业对公收款认证API

# 业务介绍

企业对公收款认证API是通过企业的对公账户及企业的打款动作来核验企业信息的真实性，可搭配其他企业身份认证方式使用，以提高企业认证的安全性及可信度。

打款金额在0.01~1元之间

# 获取 Token

根据传入的信息生成认证token

# 一、请求说明

请求地址：http://api.spiderid.cn/api/router/rest，https://api.spiderid.cn/api/router/rest
服务接口名称(即公共参数method的值)： entauth.receivepay.getToken
请求方式：GET，POST

单个idNumber每天仅可调用一次该接口,次日0点重置

# 二、请求参数

名称	类型	是否必须	描述
entName	String	是	企业名称
idNumber	String	是	注册号/统一社会信用代码(注册号支持15位，统一社会信用代码支持18位)
entBankNumber	String	是	企业对公银行账号
purpose	String	否	打款附言(如果填写,打款时将填写该附言，验证收款结果时也需传入此附言)

请求示例：

https://api.spiderid.cn/api/router/rest?
entName=XXX
&idNumber=XXX
&entBankNumber=XXX
&purpose=XXX
&<[公共请求参数]>

# 三、响应参数

data 结果信息	类型	描述
incorrect	Integer	返回码(详情见字段解释)
token	String	认证Token
message	String	对返回码的描述
paymentAccountName	String	打款方户名
paymentBankName	String	打款方开户行名称
paymentBank	String	打款方银行
paymentUnionNo	String	打款方联行号
paymentEntName	String	打款方公司名称
paymentAccount	String	打款方银行账号
receivingPaymentEntName	String	收款方公司名称
receivingPaymentEntIdNumber	String	收款方公司注册号/统一社会信用代码
receivingPaymentAccount	String	收款方银行账号
purpose	String	打款时附言

字段解释
incorrect 返回码介绍

字段	状态介绍
100	成功

# 四、成功示例

JSON示例

{
    "code": 0,
    "requestId":"f1006...",
    "message": "success",
    "data": {
        "incorrect": 100,
        "message": "成功",
        "token": "f1006...",
        "paymentAccountName": "打款户名",
        "paymentBank": "**银行",
        "paymentBankName": "**银行",
        "paymentEntName": "**公司",
        "paymentAccount": "3116**3140",
        "paymentUnionNo": "**123",
        "receivingPaymentAccount": "3116**3140",
        "receivingPaymentEntIdNumber": "**123",
        "receivingPaymentUnionNo": "**123",
        "purpose": "企业认证"
    }
}

# 验证收款认证结果

收到认证款项后，通过此接口进行认证结果的验证，验证成功，则认证流程结束；若可验证次数为0，将无法继续验证

请求地址：http://api.spiderid.cn/api/router/rest，https://api.spiderid.cn/api/router/rest
服务接口名称(即公共参数method的值)： entauth.receivepay.verify
请求方式：GET，POST

# 二、请求参数

名称	类型	是否必须	描述
token	String	是	认证token
amount	String	是	收款金额
purpose	String	否	打款附言（若申请认证时填写了附言，验证时也必须传入相同附言）

请求示例：

https://api.spiderid.cn/api/router/rest?
token=XXX
&amount=XXX
&purpose=XXX
&<[公共请求参数]>

# 三、响应参数

data 结果信息	类型	描述
incorrect	Integer	返回码(详情见字段解释)
message	String	对返回码的描述
paymentTime	String	打款日期
amount	String	打款金额
purpose	String	打款附言
times	Integer	剩余验证次数

字段解释
incorrect 返回码介绍

字段	状态介绍
100	成功
101	认证中
102	认证失败，打款附言或金额不一致
103	认证超时
104	验证次数已用完，无法继续验证
105	认证记录不存在

# 四、成功示例

JSON示例

{
    "code": 0,
    "requestId":"f1006...",
    "message": "success",
    "data": {
        "incorrect":100,
        "message":"成功",
        "paymentTime": "2021-10-13 10:31:58",
        "amount":"0.32",
        "times": 2
    }
}

# 五、失败示例

JSON示例

{
    "code": 0,
    "requestId":"f1006...",
    "message": "success",
    "data": {
        "incorrect":102,
        "message":"认证失败"
    }
}

# SDK 请求示例

# 获取token

        //提供的url
        String url = "http://api.spiderid.cn/api/router/rest";
        //您的appKey
        String appkey = "XXX";
        //您的appSecret
        String secretKey = "XXX";
        //1.原客户端
        ApiClient apiClient = new DefaultApiClient(url, appkey, secretKey);
        //2.调用出错，自动重试客户端
        EntAuthReceivePayGetTokenRequest req = new EntAuthReceivePayGetTokenRequest();

        //企业名称
        req.setEntName("xxx公司");

        //注册号/统一社会信用代码
        req.setIdNumber("123456");

        //企业对公账号
        req.setEntBankNumber("123...");
        
        //打款附言（选填）
        req.setPurpose("");

        try {
            EntAuthReceivePayGetTokenResponse response = apiClient.execute(req);
            //后续业务处理

        } catch (ApiException e) {
            e.printStackTrace();
        }
    }

# 验证收款认证结果

        //提供的url
        String url = "http://api.spiderid.cn/api/router/rest";
        //您的appKey
        String appkey = "XXX";
        //您的appSecret
        String secretKey = "XXX";
        //1.原客户端
        ApiClient apiClient = new DefaultApiClient(url, appkey, secretKey);
        //2.调用出错，自动重试客户端
        EntAuthReceivepayVerifyRequest req = new EntAuthReceivepayVerifyRequest();
        
        //认证token
        req.setToken("xxx");
        
        //打款金额
        req.setAmount("***");

        //打款附言（选填,若申请认证时填写了附言，验证时也必须传入附言）
        req.setPurpose("");

        try {
             EntAuthReceivepayVerifyResponse response = apiClient.execute(req);
            //后续业务处理

        } catch (ApiException e) {
            e.printStackTrace();
        }

← 企业对公打款认证API 企业证书 EV1 →