1.报名申请
1.1接口说明
- 本接口适用于服务商下参加银行联合收单活动
- 开通流程:
1.服务商联系对应BD经理申请开通银行联合收单活动
2.BD经理向海科运营申请配置活动规则和模板,获得银行联合收单活动模板id
3.服务商获得活动模板id后,在商户完成入网后,为需要参与活动的商户进行活动报名
1.2请求URL
http://47.95.131.62:8080/api/v1/merchant/acquire/apply
1.3请求参数(Y-必传,N-非必传)
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
---|---|---|---|---|---|
agent_no | 服务商编号 | String(16) | 海科服务商编号 | ISV/FW+xxxx | Y |
merch_no | 海科商户编号 | String(32) | 海科商户编号 | 833+xxxx | Y |
银行联合收单活动模板id | String | 线下联系商务/运营获取 | Y |
1.4请求示例
{
"accessid": "cpostest",
"agent_no": "FW200097",
"merch_no": "833226358120003"
"id": "as2154542136654",
}
1.5返回信息
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
---|---|---|---|---|---|
return_code | 返回状态码 | string | 10000:成功,其他:失败 | 10000:成功,其他对应code | |
apply_no | 申请单ID | string | 成功返回 | ||
return_msg | 返回信息 | string | 返回信息 1、商户类型有误 2、商户存在正在执行活动 3、商户存在待审核报名申请单 4、商户结算卡无法识别 5、商户结算卡不满足活动要求 6、商户经营地址省市区不满足活动要求 7、活动已下架 8、活动已过期 |
2.申请单状态查询
2.1接口说明
本接口适用于服务商查询申请单的审核状态
2.2请求URL
http://47.95.131.62:8080/api/v1/merchant/acquire/getApplyStatus
2.3请求参数(Y-必传,N-非必传)
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
---|---|---|---|---|---|
agent_no | 服务商编号 | String(16) | 海科服务商编号 | ISV/FW+xxxx | Y |
merch_no | 海科商户编号 | String(32) | 海科商户编号 | 833+xxxx | Y |
申请单id | String | 申请单id | 10391199335118xxxx | Y |
2.4请求示例
{
"accessid": "cpostest",
"agent_no": "FW200097",
"merch_no": "833226358120003"
"id": "as2154542136654",
}
2.5返回信息
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
---|---|---|---|---|---|
return_code | 申请单状态 | string | 1、待审核 2、审核拒绝 3、审核通过 4、已取消 |
1-待审核 | |
审核拒绝原因 | string | 当状态为2-审核拒绝时返回该字段,表示拒绝原因 |
3.商户报名活动终止
3.1接口说明
本接口适用于服务商终止商户当前正在执行的银行联合收单活动
3.2请求URL
http://47.95.131.62:8080/api/v1/merchant/acquire/terminal
3.3请求参数(Y-必传,N-非必传)
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
---|---|---|---|---|---|
agent_no | 服务商编号 | String(16) | 海科服务商编号 | ISV/FW+xxxx | Y |
merch_no | 海科商户编号 | String(32) | 海科商户编号 | 833+xxxx | Y |
3.4请求示例
{
"accessid": "cpostest",
"agent_no": "FW200097",
"merch_no": "833226358120003",
}
3.5返回信息
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
---|---|---|---|---|---|
return_code | 返回状态码 | string | 10000:成功,其他:失败 | 10000 | Y |
return_msg | 返回信息 | string |
4.申请单撤销
4.1接口说明
本接口适用于服务商撤销商户待审核状态的报名申请单
4.2请求URL
http://47.95.131.62:8080/api/v1/merchant/acquire/cancel
4.3请求参数(Y-必传,N-非必传)
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
---|---|---|---|---|---|
agent_no | 服务商编号 | String(16) | 海科服务商编号 | ISV/FW+xxxx | Y |
merch_no | 海科商户编号 | String(32) | 海科商户编号 | 833+xxxx | Y |
申请单id | String | 申请单id | 10391199335118xxxx | Y |
4.4请求示例
{
"accessid": "cpostest",
"agent_no": "FW200097",
"merch_no": "833226358120003",
}
4.5返回信息
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
---|---|---|---|---|---|
return_code | 返回状态码 | string | 10000:成功,其他:失败 | 10000 | Y |
return_msg | 返回信息 | string |
文档更新时间: 2025-03-07 13:51 作者:闵丹阳