概要描述:

该接口用于服务商给商户进行收单协议签约。

请求URL:

  • 测试环境：http://47.95.131.62:8080/api/v1/agreement-merchant-sign/sign

    请求参数(O-非必传 ,M-必传)

    参数 参数名称 类型 参数说明 样例 可空
    agent_apply_no 服务商请求流水号 String 服务商请求流水号 M
    agent_no 服务商编号 String 服务商编号 ISV01991023 M
    merch_no 商户编号 String 商户在SaaS平台的编号 88888888 M
    availableSignClientTypes 签署终端类型 String 不传时默认值:1,2,3,4(英文逗号分隔)：
    1-网页(自适配H5/PC样式)、
    2-e签宝支付宝小程序、
    3-e签宝微信小程序、
    4-e签宝APP    		 O
    redirectUrl 签署完成重定向地址 String 签署完成后跳转页面
    （除app和小程序端集成外，地址需符合 https /http 协议地址）     		O

返回参数:

参数 参数名称 类型 参数说明 样例 可空
return_code 返回码 int 10000：成功 其他：失败 1000 M
return_msg 错误消息 String 当return_code不为10000时有值 O
agent_apply_no 服务商申请单编号 String 服务商申请单编号 O
contract_no 合同编号 String 合同编号 O
url 电子签章地址 String 电子签章地址 O
merch_no 商户号 String 商户号 O
status 电签状态 String 电签状态 0：未签约
1：已签约
2：签约失败		 O


重定向域名格式及示例

重定向类型 域名格式 域名示例 特殊说明
Web/H5 http://域名 http://www.esign.cn
http://open.esign.cn		 末尾不允许带/或端口
说明：
域名级风控拦截，因此不需要携带端口
Web/H5 https://域名 https://www.esign.cn
https://open.esign.cn		 末尾不允许带/或端口
说明：
域名级风控拦截，因此不需要携带端口
App/小程序 scheme:// esign://
alipay://
dingtalk://
贵司App定义的Scheme名://


签署完成后会在贵司重定向地址上拼接签署状态等字段

签署方手动签署完成后，签署页在重定向跳转时会在开发者传入的重定向Url中拼接上签署状态相关参数。

样式示例及参数说明

https://www.xxx.cn/?tsignType=SIGN&tsignCode=0&tsignDes=签署成功&signFlowId=285d1117d38c4df8862e77847a9ce3a1

文档更新时间: 2026-10-15 10:03   作者：张亚飞