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   作者:闵丹阳