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 |
| activity_no | 银行联合收单活动模板id | String | 线下联系商务/运营获取 | Y | |
| notify_url | 回调地址 | String | 接受申请单状态变更的通知地址 | N |
1.4请求示例
{
"accessid": "cpostest",
"agent_no": "FW200097",
"merch_no": "833226358120003",
"activity_no": "as2154542136654",
"notify_url": "www.baidu.com",
}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 |
| apply_no | 申请单id | String | 申请单id | 10391199335118xxxx | Y |
2.4请求示例
{
"accessid": "cpostest",
"agent_no": "FW200097",
"merch_no": "833226358120003"
"id": "as2154542136654",
}2.5返回信息
| 参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
|---|---|---|---|---|---|
| return_code | 返回状态码 | string | 10000:查询成功,其他:失败 | 10000:成功,其他对应code | |
| apply_status | 申请单状态 | string | 00:审核通过 01:待审核 02:已取消 03:审核拒绝 |
||
| apply_mark | 审核拒绝原因 | 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 |
| apply_no | 申请单号 | String(32) | 海科商户编号 | 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 |
| apply_no | 申请单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 |
5.申请单状态变更回调通知
4.1接口说明
本接口适用于报名申请单发生变更时,对外进行变更通知
4.2请求URL
报名申请接口中的notify_url
4.3请求参数(Y-必传,N-非必传)
| 参数 | 参数名称 | 类型 | 参数说明 | 样例 | 必填 |
|---|---|---|---|---|---|
| apply_no | 申请单id | String | 申请单id | 10391199335118xxxx | Y |
| state | 申请单状态 | String | 申请单状态 | 00:审核通过; 01:待审核; 02:已取消; 03:审核拒绝;04:费率活动执行失败;06:已终止 | Y |
| mark | 回调的相关文字信息 | String | 回调文字描述 | 审核拒绝,原因:xxxx | N |
| detail_list | 审核通过时返回额度包信息 | List | 审核通过时返回额度包信息 | N |
4.4回调请求示例
{"detail_list":[{"active_time":"2024-05-31","amount":"19.96","expire_time":"2099-12-31","id":"cb0938e6-c1d3-11ef-b5bd-7cd30aeb15ae","merch_no":"833102158124941","period_type":"LONG_PERIOD","status":"ENABLE"}],"apply_no":"1101936170054455297","sign":"78D77788BB0D596CC307496503304540","state":"00"}文档更新时间: 2026-04-20 14:04 作者:闵丹阳