受益人补充查询

接口描述：可通过该接口查询商户受益人补充信息（如受益人资料待更新、审核中等状态）

接口说明

适用对象：代理商

请求URL：https://pay.yintongzaixian.com/api/mchApplyment/merchantComplement/query

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

"必填"字段取值"Y"：必填；"N"：非必填；"C"代表条件必填；

请求参数

参数名	中文名	必填	类型	示例值	说明
ifCode	支付接口代码	Y	String	shengpay	支付接口代码，如：shengpay
agentNo	代理商号	C	String	A3929388111	代理商发起时必填
mchNo	商户号	Y	String	A3929388111 (代理商) M3929388111（商户号）	代理商发起固定传入代理商号 若为商户主动发起则传入商户号；
appId	应用APPID	Y	String	686b6f5b46c83837aebd1db2	商户应用ID
reqTime	请求时间	Y	String	1622016572190	请求接口时间,13位时间戳
version	接口版本	Y	String	1.0	接口版本号，固定：1.0
sign	签名	Y	String	C380BEC2BFD727A4B6845133519F3AD6	签名值，详见签名算法
signType	签名类型	Y	String	MD5	签名类型，目前只支持MD5或RSA2方式

响应参数说明：

参数名	中文名	说明
complementLinks	补充链接	用于补充更新受益人信息的页面链接
status	状态	待处理：WAIT 待审核：AUDIT 审核失败：FAIL 成功：SUCCESS 超过限定期限：EXPIRE

请求示例：

{
    "agentNo": "A1755505181",
    "mchNo": "M3929388111",
    "appId": "686b6f5b46c83837aebd1db2",
    "ifCode": "shengpay",
    "sign": "A1144E7281971619FA89DA2153F54CB8",
    "signType": "MD5",
    "reqTime": "1754445551041",
    "version": "1.0"
}

响应结果：

{
    "code": 0,
    "data": {
        "complementLinks": "http://sasstest.shengpay.com/com-pages-web/profits/v1/profits?ticket=BC_102470705570000896005",
        "status": "WAIT"
    },
    "msg": "SUCCESS",
    "sign": "D8D3B2D263C99901B21576D05093AA8D"
}

SDK调用示例（Java）：

JeepayClient jeepayClient = JeepayClient.getInstance(Jeepay.appId, Jeepay.apiKey, Jeepay.getApiBase());
ApplymentMchMerchantComplementQueryRequest request = new ApplymentMchMerchantComplementQueryRequest();
ApplymentMchMerchantComplementQueryReqModel model = new ApplymentMchMerchantComplementQueryReqModel();
model.setAgentNo("你的代理商号"); 
model.setMchNo("你的商户号（M开头）");   // 商户号  
model.setAppId("你的商户应用APPID");       // 应用ID
model.setIfCode("shengpay");                            // 支付接口代码

request.setBizModel(model);
try {
    ApplymentMchMerchantComplementQueryResponse response = jeepayClient.execute(request);
    _log.info("验签结果：{}", response.checkSign(Jeepay.apiKey));
    if(response.isSuccess(Jeepay.apiKey)) {
        _log.info("data：{}", response.getData());
    }else {
        _log.info("请求失败：mchNo={}, msg={}", Jeepay.mchNo, response.getMsg());
    }
} catch (JeepayException e) {
    _log.error(e.getMessage());
}