Efecty现金收款接口文档企业Marketplace平台费率说明

2026-02-24 2

详情

报告

跨境服务

文章

Efecty现金收款接口文档企业Marketplace平台费率说明

要点速读（TL;DR）

Efecty 是哥伦比亚主流的本地现金支付方式，适合无法使用银行卡的消费者线下付款。
接入 Efecty 需通过支持拉美市场的第三方支付网关或平台（如 PPRO、dLocal、Checkout.com）实现企业级收款对接。
企业卖家需提供合规营业执照、税务信息及银行账户完成商户入驻与结算。
接口文档通常由支付服务商提供，包含 API 调用规范、回调机制、订单状态同步等技术细节。
Marketplace 平台若支持 Efecty，其费率结构一般包含交易手续费、货币转换费、退款处理费等，具体以合同约定为准。
使用该服务需关注资金结算周期、拒付风险、本地化用户体验优化等问题。

Efecty现金收款接口文档企业Marketplace平台费率说明是什么

Efecty 是哥伦比亚广泛使用的线下现金支付网络，用户可在便利店、超市、邮局等网点以现金支付线上订单。跨境企业可通过集成 Efecty 收款能力，为哥伦比亚消费者提供本地化支付选项。

现金收款接口文档 指支付服务商提供的技术文档，说明如何通过 API 接入 Efecty 支付流程，包括创建支付单、生成付款码、监听支付结果通知等功能。

企业 Marketplace 平台费率说明 指电商平台或支付服务商针对企业卖家使用 Efecty 所收取的各项费用明细和计算规则，通常体现在商户协议或结算页面中。

关键名词解释

Efecty：哥伦比亚本地支付品牌，属于 Almacenes Éxito 集团，覆盖全国超 2 万家线下网点。
现金收款接口：指允许电商平台或ERP系统调用 Efecty 支付功能的技术通道，需通过 HTTPS 协议进行数据交互。
接口文档：由支付网关提供的开发指南，含请求参数、响应码、签名算法、异步通知 URL 设置等内容。
企业级接入：面向注册公司主体的商户认证流程，需提交法人身份、营业执照、对公账户等材料。
Marketplace 平台费率：平台对每笔通过 Efecty 完成的交易收取的服务费比例或固定金额，可能叠加其他附加费用。

它能解决哪些问题

痛点：哥伦比亚信用卡渗透率低 → 提供现金支付选项，扩大潜在客户群。
痛点：国际卡拒付率高 → 现金预付降低欺诈与拒付风险。
痛点：本地消费者不信任海外支付 → 使用熟悉渠道提升转化率。
痛点：缺乏本地收款账户 → 通过支付网关统一结算至境外银行账户。
痛点：技术团队不了解拉美支付生态 → 借助成熟服务商接口文档快速上线。
痛点：平台未原生支持 Efecty → 自主对接后可拓展至独立站或多平台店铺。
痛点：资金回笼慢 → 明确结算周期与汇率策略，优化现金流管理。
痛点：财务对账复杂 → 获取标准化交易报告用于会计处理。

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

确认业务需求：判断是否主要面向哥伦比亚市场，且目标客群有现金支付习惯。
选择支付服务商：优先考虑已集成 Efecty 的全球支付网关（如 dLocal、PPRO、Paysafe、Checkout.com），查看其企业商户支持能力。
注册企业商户账户：在服务商官网提交公司营业执照、法人身份证、税务登记证、银行开户证明等资料。
申请开通 Efecty 支付方式：在商户后台勾选启用 Efecty，并签署相关服务条款。
获取接口文档：登录服务商开发者中心下载最新版 Efecty API 文档，了解支付流程建模（如 redirect flow 或 iframe embed）。
技术对接与测试：开发人员根据文档实现下单触发、跳转支付页、接收 webhook 回调、更新订单状态等逻辑，在沙箱环境中完成全流程测试。
上线并监控：正式启用后持续监测支付成功率、异常订单、结算延迟等情况。

注：部分 Marketplace 平台（如 Mercado Libre）若已内置 Efecty，则无需自行对接，但需确认平台对企业卖家的费率政策。

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

交易金额大小（阶梯式费率常见）
月均交易 volume（高交易量可协商折扣）
是否涉及货币兑换（COP → USD/EUR 的汇损与加价）
支付网关的品牌与服务能力（dLocal 与 Stripe 费率结构不同）
是否有额外增值服务（如反欺诈检测、多语言客服）
结算频率（T+7 vs T+14 影响资金占用成本）
退款与争议处理费用
API 请求调用频次限制（超出可能收费）
是否使用托管账户（hosted account）模式
合同谈判能力与区域代理政策

为了拿到准确报价/成本，你通常需要准备以下信息：

预计月交易笔数与总金额
销售类目（高风险类目费率更高）
目标国家（仅 Colombia 还是多国）
网站或 App 的流量数据
历史拒付率（如有）
希望使用的结算币种与频率
技术实现方式（API 直连 or 插件嵌入）

常见坑与避坑清单

未核实服务商是否真正支持 Efecty：某些网关宣称“覆盖拉美”，实则未接入具体渠道，务必查看官方支付方式列表。
忽略用户支付时效：Efecty 订单通常有 24-72 小时有效期限，超时未付需系统自动取消并释放库存。
回调验证缺失：未校验 webhook 签名可能导致虚假支付通知被误认，造成发货损失。
未设置本地语言提示：指引不清导致用户不知道去哪付款，影响转化率。
对账困难：结算文件字段不标准，建议要求服务商提供 CSV 或 Excel 格式的详细交易报告。
忽视税务合规：在哥伦比亚收款可能涉及 IVA（增值税），需咨询当地财税顾问。
依赖单一支付通道：建议同时接入 Baloto、PSE 等互补方式，提高整体支付成功率。
忽略移动端适配：多数用户通过手机访问，确保支付跳转链接在移动浏览器正常打开。
未测试异常场景：如用户重复生成订单、中途关闭页面、网点拒收现金等，应有应对机制。
合同未明确 SLA：建议明确故障响应时间、资金延迟赔付责任等条款。

FAQ（常见问题）

Efecty现金收款接口文档企业Marketplace平台费率说明靠谱吗/正规吗/是否合规？
是正规支付方式。Efecty 受哥伦比亚金融监管机构监督，企业通过持牌支付网关接入属合规操作，但需确保自身具备合法经营资质并履行报关纳税义务。
适合哪些卖家/平台/地区/类目？
适用于面向哥伦比亚消费者的跨境电商企业，尤其是独立站、B2C电商平台卖家；适合电子消费品、时尚服饰、家居用品等中低价商品类目；不建议用于虚拟商品或高风险品类。
怎么开通/注册/接入/购买？需要哪些资料？
需通过支付服务商注册企业商户账户，提供：公司营业执照扫描件、法人身份证、银行开户许可证、联系人信息、网站/App 信息、预计交易规模等。部分需视频认证或补充商业计划书。
费用怎么计算？影响因素有哪些？
费用一般由交易手续费（% + 固定费）、货币转换费、结算费构成，具体取决于服务商定价模型、交易量、类目风险等级。最终费率以签约合同为准。
常见失败原因是什么？如何排查？
常见原因包括：用户未在有效期内完成支付、API 参数错误、回调地址不可达、签名验证失败、服务商临时中断服务。排查方法：检查日志、复现流程、联系技术支持提供 transaction ID 查询。
使用/接入后遇到问题第一步做什么？
首先确认问题是前端展示、支付跳转、还是回调通知异常；保留完整请求/响应日志；登录服务商后台查看交易状态；联系其技术支持并提供 trace ID 或 merchant reference。
和替代方案相比优缺点是什么？
对比 PayPal 或信用卡：
优点：覆盖无卡人群、降低拒付率；
缺点：结算慢（T+3 起）、需线下操作、存在过期未付情况。
对比 Baloto：
两者均为现金支付，Efecty 网点更密集，部分地区接受度更高。
新手最容易忽略的点是什么？
一是未设置订单过期自动关闭机制；二是未做充分的沙箱测试；三是忽略本地化支付指引（如生成西班牙语付款说明）；四是未规划好对账流程，导致财务核销困难。