Efecty现金收款API接入教程商家Marketplace平台费率说明

Efecty现金收款API接入教程商家Marketplace平台费率说明

要点速读（TL;DR）

• Efecty 是哥伦比亚主流的现金支付方式，支持买家在线下单后线下网点付款。
• 通过 API 接入 可实现与 Marketplace 或独立站系统的自动订单同步和状态更新。
• 主要适用于面向 哥伦比亚消费者 的跨境商家，尤其无卡用户群体。
• 接入需完成商户资质认证、技术对接、测试验证三阶段流程。
• 平台通常收取交易手续费，费率受结算周期、交易量、风控等级等因素影响。
• 常见坑包括：回调地址配置错误、未处理超时订单、KYC材料不全导致审核失败。

Efecty现金收款API接入教程商家Marketplace平台费率说明 是什么

Efecty 是哥伦比亚本地广泛使用的现金支付网络，覆盖超过 14,000 个实体网点（如超市、药店、便利店），允许消费者在线选择商品后，凭生成的支付码在指定地点以现金完成付款。

API 接入 指通过标准化接口将 Efecty 支付能力集成到电商平台或自建系统中，实现订单创建、支付状态查询、回调通知等自动化操作。

商家 Marketplace 平台 指已整合 Efecty 支付选项的第三方电商平台（如 Mercado Libre、Linio 等），或支持多卖家入驻并提供本地化支付解决方案的聚合平台。

费率说明 指使用该服务所产生的费用结构，通常包含交易手续费、结算服务费、退款处理费等，具体由平台或支付服务商制定。

它能解决哪些问题

• 痛点： 哥伦比亚信用卡渗透率低（不足30%），大量消费者依赖现金支付。
  价值： 覆盖更广客群，提升转化率。
• 痛点： 手动确认现金付款耗时且易出错。
  价值： API 自动回传支付状态，减少人工干预。
• 痛点： 买家担心在线支付安全问题。
  价值： 提供熟悉的本地现金支付方式，增强信任感。
• 痛点： 订单状态不同步导致发货延迟或误发。
  价值： 实现支付-订单-物流链路闭环管理。
• 痛点： 缺乏对未付款订单的有效追踪机制。
  价值： 支持设置有效期限与自动取消规则。
• 痛点： 国际卖家难以直接接入本地支付渠道。
  价值： 通过 Marketplace 或支付网关间接接入，降低门槛。

怎么用/怎么开通/怎么选择

一、确认接入路径

1. 判断是否已在支持 Efecty 的 Marketplace 入驻（如 Mercado Libre Colombia）；
2. 若为独立站或自有平台，需通过支付服务商（如 PayU Latam、Dlocal、Paddle）开通 Efecty 接口；
3. 联系服务商获取接入文档与沙箱环境信息。

二、准备商户资料

• 公司营业执照（中英文公证件或西语翻译件）；
• 法人身份证件及联系方式；
• 银行账户信息（用于资金结算，建议拉美本地账户）；
• 网站/APP URL 及主营业务描述；
• 预计月交易笔数与金额范围。

三、技术对接步骤

1. 注册商户账号并完成 KYC 审核；
2. 获取 API Key、Merchant ID、Secret Token 等认证参数；
3. 阅读官方 API 文档，了解接口规范（如创建支付单、查询状态、接收 webhook）；
4. 在系统中开发 Efecty 支付模块，调用 /create-payment 接口生成支付码和条形码；
5. 配置 Webhook 回调地址 接收支付成功/失败通知；
6. 在沙箱环境中进行全流程测试（模拟支付、状态变更、退款）；
7. 提交测试报告，申请上线生产环境。

四、上线后运维

• 监控支付成功率与回调延迟情况；
• 定期核对结算账单与实际到账金额；
• 设置异常订单人工处理流程。

费用/成本通常受哪些因素影响

• 交易金额区间（阶梯式费率）；
• 月均交易笔数或总流水规模；
• 是否使用增值服务（如反欺诈识别、多币种结算）；
• 结算频率（T+7、T+15 或 T+30）；
• 退款率水平（高退可能触发风控加价）；
• 是否为 Marketplace 内部通道（平台补贴则费率更低）；
• 签约主体所在地（离岸公司 vs 哥伦比亚本地注册企业）；
• 支付服务商定价策略（不同供应商报价差异较大）；
• 是否有长期合约或独家合作条款；
• 货币兑换成本（USD→COP 汇损）。

为了拿到准确报价/成本，你通常需要准备以下信息：
- 预计每月交易量级（笔数与总额）
- 主要销售类目
- 目标市场国家（仅哥伦比亚 or 多国）
- 是否已有本地实体或银行账户
- 使用场景（Marketplace 插件 or 自主开发系统）

常见坑与避坑清单

1. 未启用 HTTPS 导致 Webhook 回调失败 —— 确保服务器支持 SSL 加密。
2. 忽略支付有效期 —— Efecty 支付码通常仅 1-3 天有效，需提醒买家及时付款。
3. 回调未做签名验证 —— 存在伪造支付成功的安全风险。
4. 未处理异步通知丢失 —— 应结合定时轮询 API 查询订单状态。
5. KYC 材料翻译不合规 —— 使用专业机构出具的西班牙语公证文件。
6. 误发未付款订单 —— 必须等待明确的“PAID”状态后再发货。
7. 忽视对账差异 —— 注意手续费扣除方式（前置扣费 or 结算净额）。
8. 使用过时 API 版本 —— 关注服务商发布的版本更新公告。
9. 未设置防重提交机制 —— 避免同一订单重复生成支付请求。
10. 未测试部分退款流程 —— Efecty 对退款有严格时限与凭证要求。

FAQ（常见问题）

1. Efecty现金收款API接入靠谱吗/正规吗/是否合规？
   Efecty 是哥伦比亚央行认可的支付网络，合法运营多年。通过官方授权渠道（如 PayU）接入即合规，但需确保自身业务符合当地税务与外汇监管要求。
2. Efecty现金收款API接入适合哪些卖家/平台/地区/类目？
   适用于面向哥伦比亚市场的中国跨境卖家，特别是电子消费品、家居用品、服装鞋包等中低价商品类目。常见于 Mercado Libre、Linio 等拉美本土电商平台，或通过 Dlocal/PayU 接入独立站。
3. Efecty现金收款API怎么开通/注册/接入/购买？需要哪些资料？
   可通过 Marketplace 后台激活，或向支付服务商提交企业营业执照、法人证件、银行账户、业务介绍等材料。需完成实名认证和技术联调测试方可上线。
4. Efecty现金收款API费用怎么计算？影响因素有哪些？
   费用通常按每笔交易收取固定比例+固定金额，具体取决于交易量、结算周期、商户风险评级和服务商合同条款。无统一标准，需单独谈判获取报价单。
5. Efecty现金收款API常见失败原因是什么？如何排查？
   常见原因包括：API 认证失败（Key 错误）、回调地址不可达、订单金额超限、KYC 审核未通过、系统维护等。建议检查日志、联系技术支持并保留请求记录。
6. 使用/接入后遇到问题第一步做什么？
   首先确认问题类型：支付页面无法加载 → 检查前端集成；支付成功但状态未更新 → 查看 Webhook 是否收到且正确处理；资金未到账 → 核对结算周期与账单明细。优先查阅服务商文档并截图反馈。
7. Efecty现金收款API和替代方案相比优缺点是什么？
   对比 PSE（在线转账）、Tarjeta de Crédito（信用卡）：
   优点：覆盖无卡人群，提升转化；
   缺点：到账慢（需等现金缴付）、存在弃付率、需额外技术支持。适合追求覆盖率而非即时到账的场景。
8. 新手最容易忽略的点是什么？
   一是忽视支付码有效期导致订单自动关闭；二是未建立自动对账机制造成财务误差；三是以为接入即完成，忽略后续监控与优化工作。

相关关键词推荐

• PayU Latam 接入指南
• Dlocal 支持支付方式
• Mercado Libre Colombia 入驻条件
• 拉美本地支付解决方案
• 哥伦比亚现金支付普及率
• 跨境收款 API 对接流程
• Webhook 回调配置教程
• 海外电商本地化支付
• 拉丁美洲电商支付趋势
• 跨境电商 KYC 材料清单
• 独立站集成 Efecty 方法
• 跨境支付手续费对比
• 多币种结算账户开设
• 拉美市场消费者行为分析
• 电商平台支付插件开发
• 支付网关选择标准
• 订单状态同步机制设计
• 跨境电商业务合规要点
• 新兴市场支付适配策略
• 高风险国家收款风控措施