易企汇产品介绍&开发指南
目录
第一部分 产品介绍
1.1 业务定位与适用场景
💡 一句话理解：易企汇 = 收单 + 资金账户 + 境外供应商付汇，三件事一站式打通。
1.2 业务模式：1210 保税进口 / 9610 直购进口
1.3 产品优势
准入简化
分发能力（SWIFT 分发）
汇率策略
1.4 适用商品类目
第二部分 接入流程总览
2.1 整体业务流程
1.
2.
3.
4.
5.
6.
7.
2.2 付汇业务时序图
商户 全球付汇
│ │
│── 付款人认证申请 ──────>│
│<── 申请响应 ───────────│
│<── 申请结果异步通知 ───│
│ │
│── 收款人认证申请 ──────>│
│<── 申请响应 ───────────│
│<── 申请结果异步通知 ───│
│ │
│── 贸易材料提交 ────────>│
│<── 提交响应 ───────────│
│<── 提交结果异步通知 ───│
│ │
│── 付汇申请 ───────────>│
│ （如上送实时汇率，连连校验汇率有效性）
│ （连连校验收款人信息）
│<── 申请响应 ───────────│
│ │
│── 付汇申请结果查询 ────>│
│<── 查询响应 ───────────│
│<── 付汇申请结果通知 ───│第三部分 接入准备
3.1 准入与对接模式
3.2 关键节点说明
付款人认证
| 用户类型 | 审核方式 | 审核时长 | 结果获取方式 |
|---|---|---|---|
| 个人用户 | 机器审核 | 秒审 | 异步通知 / 主动查询 |
| 企业用户 | 人工审核 | 约 1 个工作日 | 异步通知 / 主动查询 |
⚠️ 注意： user_id调用成功后会与该用户实名信息绑定，后续该user_id无法更换为其他用户信息；且无需针对每笔订单都做付款人认证，已认证用户无需重复认证。
收款人认证申请
贸易材料提交
付汇申请
第四部分 API 接口详解
4.1 接口总览
| 序号 | 接口名称 | 所属模块 | 主要用途 |
|---|---|---|---|
| 1 | 付款人认证申请 | 付款人 | 买家实名认证（个人秒审 / 企业约 1 工作日） |
| 2 | 收款人认证申请 | 收款人 | 创建境外供应商收款账户 |
| 3 | 贸易材料提交 | 贸易材料 | 逐笔提交订单贸易材料 |
| 4 | 付汇申请 | 付汇 | 人民币资金付汇 + 兑换成外币 |
| 5 | 付款人认证结果查询 | 付款人 | 主动查询付款人审核结果（异步通知兜底） |
| 6 | 收款人认证结果查询 | 收款人 | 主动查询收款人审核结果（异步通知兜底） |
| 7 | 贸易材料审核结果查询 | 贸易材料 | 主动查询贸易材料审核结果（异步通知兜底） |
| 8 | 付汇申请结果查询 | 付汇 | 主动查询付汇状态（异步通知兜底） |
| 9 | 海关推单接口 | 配套 | 收单后向海关总署推送支付信息 |
| 10 | 担保确认 | 配套 | 确认收货后增加卖家人民币账户余额 |
📌 所有「申请类」接口均建议通过「异步通知 + 主动查询」双通道获取结果；申请接口同步返回的是「受理结果」，非「最终业务结果」。
4.2 付款人认证申请
| 项目 | 内容 |
|---|---|
| 接口名称 | 付款人认证申请（payer/apply） |
| 请求方法 | POST |
| 请求 URL（正式环境） | https://openapi.lianlianpay.com/mch/v1/global-payout/payer/apply |
| Content-Type | application/json;charset=utf-8 |
| 签名算法 | RSA（Signature-Type 默认 RSA） |
Header 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Signature-Data | string | 是 | 签名结果 |
| Signature-Type | string | 是 | 签名算法，默认 RSA |
| Content-Type | string | 是 | 默认 application/json;charset=utf-8 |
| mch_id | string | 是 | 商户编号 |
| sp_no | string | 否 | 服务商编号 |
| timestamp | string | 是 | 时间戳，如 20221109111509 |
Body 参数
| 参数名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|
| mch_id | string | 是 | 18 | 商户编号（18 位数字） |
| sub_mch_id | string | 否 | 18 | 子商户号（平台商模式下必传） |
| txn_seqno | string | 是 | 64 | 申请唯一编号（商户侧全局唯一） |
| payer_id | string | 是 | 64 | 商户侧付款人 ID |
| payer_name | string | 是 | 64 | 付款人名称 |
| payer_type | enum | 是 | 16 | PERSON（个人）/ COMPANY（企业） |
| id_type | enum | 是 | 32 | ID_CARD（身份证）/ UNIFIED_CREDIT_CODE（统一社会信用代码） |
| id_no | string | 是 | 32 | 证件号码 |
| phone | string | 是 | 32 | 手机号 |
| country_code | string | 是 | 2 | 国家/地区编码（ISO 3166-2） |
| notify_url | string | 否 | 256 | 异步通知地址 |
返回参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ret_code | string | 是 | 响应码 |
| ret_msg | string | 是 | 响应信息 |
| mch_id | string | 是 | 商户号 |
| txn_seqno | string | 是 | 商户系统唯一交易流水号 |
| platform_txno | string | 是 | 平台订单号 |
| payer_id | string | 是 | 商户侧付款人 ID |
| platform_payer_id | string | 否 | 平台付款人 ID |
| txn_status | enum | 是 | PROCESSING（处理中）/ FAIL（失败）/ SUCCESS（成功） |
| fail_reason | string | 是 | 失败原因（FAIL 时返回） |
⚠️ 若 ret_code返回9999+ "系统错误"，通常是连连易企汇权限未开启，请联系连连技术支持处理。
4.3 收款人认证申请
| 项目 | 内容 |
|---|---|
| 接口名称 | 收款人认证申请（beneficiary/apply） |
| 请求方法 | POST |
| 请求 URL（正式环境） | https://openapi.lianlianpay.com/v1/global-payout/beneficiary/apply |
| Content-Type | application/json |
Body 参数
| 参数名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|
| mch_id | string | 是 | 18 | 商户编号 |
| sub_mch_id | string | 否 | - | 平台商模式下必传 |
| txn_seqno | string | 是 | 64 | 申请唯一编号 |
| beneficiary_id | string | 是 | 64 | 商户侧收款人 ID（仅数字或英文） |
| beneficiary_type | enum | 是 | 16 | PERSON（个人）/ COMPANY（企业） |
| beneficiary_name | string | 是 | 64 | 收款人名称（仅英文） |
| string | 是 | - | 收款人邮箱（需连连 RSA 公钥加密） | |
| country_code | string | 是 | 2 | 收款人国家/地区编码（ISO 3166-2） |
| city | string | 是 | 32 | 收款人所在城市 |
| state | string | 是 | 32 | 收款人所在州/县/地区 |
| line | string | 是 | 256 | 详细地址（英文） |
| postcode | string | 是 | 16 | 邮政编码 |
| account_name | string | 是 | 128 | 收款人账户名称 |
| account_no | string | 是 | - | 收款人账户号（需连连 RSA 公钥加密） |
| account_currency | string | 是 | 3 | 收款人账户币种 |
| bank_country_code | string | 是 | 2 | 银行所在国家/地区编码 |
| payment_method | enum | 是 | 16 | SWIFT / LOCAL |
| local_clearing_system | enum | 否 | 16 | 本地清算系统（payment_method=LOCAL 时必传）：RTGS |
| bank_routing | array | 否 | - | 路由列表（使用本地清算时必传） |
| bank_routing.routing_type | string | 是 | 16 | 路由类型 |
| bank_routing.routing_number | string | 是 | 32 | 路由号 |
| swift_code | string | 是 | 16 | SWIFT 编码 |
| notify_url | string | 否 | 256 | 异步通知地址 |
返回参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ret_code | string | 是 | 响应码 |
| ret_msg | string | 是 | 响应信息 |
| mch_id | string | 否 | 商户号 |
| txn_seqno | string | 否 | 商户系统唯一交易流水号 |
| platform_txno | string | 否 | 平台订单号 |
| beneficiary_id | string | 否 | 商户侧收款人 ID |
| platform_beneficiary_id | string | 否 | 平台收款人 ID |
| txn_status | enum | 否 | PROCESSING / FAIL / SUCCESS |
| fail_reason | string | 否 | 失败原因 |
📌 beneficiary_id是商户在平台侧的收款人 ID，后续可基于该 ID 查询收款人信息；与「贸易材料提交」「付汇申请」接口的beneficiary_id必须保持一致。
4.4 贸易材料提交
| 项目 | 内容 |
|---|---|
| 接口名称 | 贸易材料申请（transaction-document/apply） |
| 请求方法 | POST |
| 请求 URL（正式环境） | https://openapi.lianlianpay.com/v1/global-payout/transaction-document/apply |
| Content-Type | application/json |
Body 参数
| 参数名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|
| mch_id | string | 是 | 18 | 商户编号 |
| sub_mch_id | string | 否 | - | 平台商模式下必传 |
| txn_seqno | string | 是 | 64 | 申报请求流水号（全局唯一） |
| trade_document_id | string | 是 | 64 | 商户侧唯一的贸易材料 ID |
| payer_id | string | 是 | 64 | 付款人 ID（必须已通过付款人认证） |
| beneficiary_id | string | 是 | 64 | 收款人 ID（必须与收款人认证中的 beneficiary_id 一致） |
| business_type | enum | 是 | 32 | ECOMMERCE（电子商务） |
| counterparty_name | string | 是 | 64 | 交易对手方姓名（即收款人名称） |
| counterparty_country_code | string | 是 | 2 | 对手方国家/地区编码 |
| trade_name | string | 是 | 128 | 交易名称（多个用逗号分隔） |
| trade_count | integer | 是 | - | 交易商品数量 |
| trade_amount | string | 是 | 12 | 交易金额（>0，精确到分，例：49.10） |
| trade_currency | string | 是 | 3 | 目前仅支持 CNY |
| trade_time | string | 是 | 14 | yyyyMMddHHmmss |
| contract_no | string | 是 | 64 | 合同编号 / 账单编号 |
| trade_detail | object | 是 | - | 交易详情（logistic_info + mip_order_info） |
| notify_url | string | 否 | 256 | 审核结果通知地址 |
trade_detail 子参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| logistic_info | object | 是 | 物流信息 |
| logistic_info.logistics_company | string | - | 物流公司 |
| logistic_info.logistics_order_no | string | - | 物流订单号 |
| mip_order_info | object | 是 | 聚数订单信息（聚数收单时必填） |
| mip_order_info.platform_txno | string | - | 聚数平台交易号 |
| mip_order_info.mch_txno | string | - | 聚数商户交易号 |
返回参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ret_code | string | 是 | 返回码（0000 = 受理成功） |
| ret_msg | string | 是 | 返回码描述 |
| mch_id | string | 否 | 商户编号 |
| txn_seqno | string | 否 | 商户贸易材料申报请求流水号 |
| platform_txno | string | 否 | 平台订单号 |
| txn_status | enum | 否 | PROCESSING / FAIL |
| fail_reason | string | 否 | 失败原因 |
⚠️ 若接口报错「付款人账号不存在」：贸易材料的 payer_id必须是已经通过付款人认证的 ID；mip_order_info中的订单号是聚数平台订单号，并非商户订单号。
4.5 付汇申请
| 项目 | 内容 |
|---|---|
| 接口名称 | 付汇申请（payout-apply） |
| 请求方法 | POST |
| 请求 URL（正式环境） | https://openapi.lianlianpay.com/v1/global-payout/payout-apply |
| Content-Type | application/json |
Body 参数
| 参数名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|
| mch_id | string | 是 | 18 | 商户编号 |
| sub_mch_id | string | 否 | - | 平台商模式下必传 |
| txn_seqno | string | 是 | 64 | 付汇申请唯一交易流水号 |
| beneficiary_id | string | 是 | 64 | 商户系统内已申报成功的收款人 ID |
| pay_currency | enum | 是 | - | 付款币种：当前仅支持 CNY |
| send_currency | string | 是 | 3 | 到账币种（3 位标准格式） |
| pay_amount | string | 是 | 12 | 付款金额（>0，精确到分，例：1.01） |
| payer_info | object | 否 | - | 付款方信息（不传则默认从平台自有账户扣款） |
| rate_id | string | 否 | 32 | 锁汇 ID（来自锁汇接口，必须在汇率有效期内） |
| memo | string | 是 | 256 | 附言（仅支持 , . -） |
| notify_url | string | 是 | 256 | 异步通知地址（终态通知） |
| business_type | enum | 是 | 32 | ECOMMERCE |
payer_info 子参数（二级账户出资时必传）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 平台下二级账户外部用户号 |
| password | string | 是 | 支付密码 |
| random_key | string | 是 | 密码随机因子 key |
| pap_agree_no | string | 是 | 委托协议号（ACCP 委托提现协议号，RSA 公钥加密传输） |
返回参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ret_code | string | 是 | 返回码 |
| ret_msg | string | 是 | 返回码描述 |
| mch_id | string | 否 | 商户编号 |
| txn_seqno | string | 否 | 付汇申请唯一交易流水号 |
| platform_txno | string | 否 | 平台订单号（受理成功时返回） |
| txn_status | enum | 否 | PROCESSING（处理中） |
付汇关键说明
4.6 配套接口：海关推单 / 担保确认
| 接口 | 接口名 | 作用 | 关键要求 |
|---|---|---|---|
| 海关推单 | 海关推单接口 | 收单后向海关总署推送支付信息 | 必须调用，海关进行三单对碰 |
| 担保确认 | 担保确认 | 用户确认收货后增加卖家人民币账户余额 | 必须调用，余额增加后才有可付汇资金 |
第五部分 接口对接链接汇总
5.1 易企汇核心 API 链接（连连开放平台）
5.2 内部产品文档（飞书 / 聚数）
https://lianlian.feishu.cn/docx/CWOfdrWafoHv9BxjoXwc80RrnDK
https://lianlian.feishu.cn/docx/RI0xdLSm8oSon0xDt3ec4wtlntg
第六部分 商户进件与产品配置（操作手册）
💡 一期仅支持惠商通普通商户订购易企汇；新商户订购易企汇必须同步订购惠商通应用；仅已订购惠商通应用的商户可增购易企汇。
6.1 新商户进件流程
6.2 产品增购与配置参数
| 产品属性 | 枚举值 | 说明 |
|---|---|---|
| 付汇额度规则（选「按交易逐笔调拨」） | 按额度申请 | 适用于独立商户模式（商户需单独在 LGAS 准入开户）；优先发起付汇额度申请，将付汇资金调拨至 LGAS 后再发起付汇 |
| 付汇额度规则（推荐） | 按交易逐笔调拨 | 适用于大商户模式（银通在 LGAS 准入开户，商户无需单独在 LGAS 准入）；无需发起付汇额度申请，直接发起付汇，系统完成资金调拨和付汇两个动作 |
| 付汇业务场景 | 电商 | 电商进口货贸场景付汇；一期仅支持电商业务 |
| 是否聚数收单（选是） | 是 | 配置为是，要求商户为聚数收单商户，贸易材料上传的支付单号为聚数收单号 |
| 是否聚数收单 | 否 | 配置为否，则不校验贸易材料的支付单号为聚数收单号 |
| 是否 POBO（选否） | 是 | 配置为是，则付汇回单付款人露出商户名称（涉及调单问题，谨慎配置） |
| 是否 POBO（推荐） | 否 | 配置为否，则付汇回单付款人露出「连连国际」，建议默认配置为「否」 |
6.3 渠道商户配置（聚数）
独立商户模式（暂由产品配置）
wallet_payout_alone；所属渠道：跨境 LGAS。大商户模式
6.4 惠商通验证方式与免密免验
6.5 ACCP 用户等级权限配置（一次性配置）
6.6 管理站交易数据查看
第七部分 常见问题 FAQ
Q1【付款人认证】商户调用付款人认证接口返回 ret_code=9999 / "系统错误" 怎么办？
Q2【付款人认证】user_id 调用成功后还能更换为其他用户吗？
user_id 调用成功后会与该用户实名信息绑定，后续该 user_id 无法更换为其他用户信息。Q3【付款人认证】每笔订单都需要做付款人认证吗？
Q4【付款人认证】付款人认证应该在哪个时间节点调用？
Q5【收款人认证申请】beneficiary_id 怎么填写？
beneficiary_id 代表收款人在平台侧的 ID，后续可通过该 ID 进行查询收款人信息。Q6【贸易材料提交】mip_order_info 字段中的订单号是什么？
Q7【贸易材料提交】接口报错「付款人账号不存在」怎么办？
payer_id 必须是已通过付款人认证的 ID，通过 payer_id 与付款人认证关联。Q8【贸易材料提交】贸易材料中的 beneficiary_id 怎么填？
beneficiary_id 保持一致。