Efecty现金收款接口文档企业跨境电商全面指南

2026-02-24 1

详情

报告

跨境服务

文章

Efecty现金收款接口文档企业跨境电商全面指南

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，支持本地消费者在线下单后线下现金付款。
接入 Efecty 可提升拉美市场，尤其是哥伦比亚买家的转化率。
企业卖家需通过支付网关服务商（如Paddle、dLocal、Rapyd等）集成 Efecty 接口，无法直接对接。
收款周期通常为3-7个工作日，资金结算至第三方支付平台或企业银行账户。
必须提供西班牙语订单信息，并确保用户在指定时间内完成现金支付。
未按时付款自动取消订单，需设置清晰的订单状态同步机制。

Efecty现金收款接口文档企业跨境电商全面指南是什么

Efecty 是哥伦比亚领先的非银行现金支付服务提供商，覆盖超过14,000个实体网点（包括便利店、超市、药店等），允许消费者在线选择商品后到店以现金完成支付。该系统广泛用于水电费、话费充值及电商购物。

现金收款接口文档 指支付服务商提供的 API 技术文档，说明如何将 Efecty 支付方式嵌入电商平台或独立站，实现订单生成、二维码/参考码下发、支付状态回调等功能。

“企业跨境电商”指中国出口电商企业面向海外消费者销售商品，常使用 Shopify、Magento、自建站等平台，并通过集成本地化支付方式提升成交率。

关键词解释

Efecty：哥伦比亚本地现金支付通道，类比越南的 MoMo 或墨西哥的 OXXO。
接口文档：由支付网关提供的技术说明文件，包含请求参数、响应格式、签名算法、回调通知URL设置等。
现金收款：买家不使用银行卡或电子钱包，而是凭支付码在线下网点用现金完成交易。
支付网关：中介服务平台（如 dLocal、Rapyd、Checkout.com），聚合多种本地支付方式，提供统一API接入。

它能解决哪些问题

痛点：哥伦比亚信用卡渗透率低（不足30%），大量消费者依赖现金支付 → 价值：接入 Efecty 扩大可触达客户群。
痛点：国际信用卡拒付率高，风控严格 → 价值：本地现金支付降低拒付与争议风险。
痛点：PayPal 在拉美覆盖率有限且提现复杂 → 价值：提供更接地气的替代支付方案。
痛点：独立站缺乏本地信任感 → 价值：展示 Efecty 图标增强支付可信度。
痛点：手动核销现金付款效率低 → 价值：通过 API 自动同步支付状态，减少人工对账。
痛点：跨境支付结算周期长 → 价值：部分网关支持快速结算（T+3起）。
痛点：税务合规要求本地交易记录 → 价值：正规支付渠道保留完整交易凭证。

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

由于 Efecty 不向中国跨境电商企业开放直接合作，必须通过已签约的支付网关服务商间接接入。以下是常见操作流程：

评估目标市场：确认主要客户来自哥伦比亚或其他接受 Efecty 的国家（目前主要集中于哥国）。
选择支持 Efecty 的支付网关：对比 dLocal、Rapyd、Paddle、Checkout.com、Mercado Pago 等是否在其支付方式列表中包含 Efecty。
注册并申请商户账号：提交企业营业执照、法人身份证、网站域名、产品类目、预计月交易额等资料。
完成KYC审核：多数网关要求视频认证或公证材料，审核周期通常为3-10个工作日。
获取API密钥与接口文档：登录网关后台下载集成文档，重点关注：
- 创建 Efecty 订单的 POST 请求结构
- 返回的 reference code / barcode
- Webhook 回调地址配置
- 支付成功与失败的状态码定义
开发与测试：在沙箱环境中模拟生成订单、接收回调、更新订单状态，确保全流程畅通。
上线并监控：正式启用 Efecty 支付选项，定期检查支付成功率、退款率和结算流水。

提示：部分网关提供 WordPress/WooCommerce/Shopify 插件，可简化集成过程；自建站建议采用 RESTful API 方式对接。

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

支付网关的基础手续费率（按交易金额百分比收取）
是否涉及货币转换（COP→USD→CNY）及中间行费用
每月交易 volume高低决定能否享受阶梯费率
是否有固定月费或每笔附加费
结算频率（T+1 vs T+7）是否加收费用
是否需要多语言客服支持或定制开发服务
是否使用防欺诈模块（如3D Secure、设备指纹）
退款处理是否收费
网关是否收取年费或终止费
企业注册地与实际运营地是否一致（影响风控评级）

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

公司注册国家与主体类型（有限公司/个体户）
电商平台类型（Shopify/自建站/Magento等）
主销国家与币种
过去6个月月均交易笔数与金额
SKU 类型（实物/虚拟/订阅制）
历史拒付率数据（如有）
是否已有其他支付方式
期望的结算周期与币种

常见坑与避坑清单

误以为可直接联系 Efecty 开通：中国企业无法绕过支付网关直接合作，应优先筛选支持 Efecty 的合规平台。
忽略支付时效限制：Efecty 订单通常有24-72小时付款期限，超时自动失效，需在前端明确提示用户。
未设置Webhook回调：导致无法自动确认收款，需人工查单，增加运营负担。
订单信息未使用西班牙语：可能导致消费者在网点无法识别订单，引发投诉。
未做充分沙箱测试：上线后出现支付成功但状态不同步的问题。
忽视KYC材料真实性：使用虚假信息可能导致账户冻结或资金滞留。
未关注结算币种与汇率损失：部分网关默认以美元结算，二次换汇可能产生额外成本。
未配置异常订单处理流程：如支付重复、部分到账等情况缺乏应对机制。
过度依赖单一支付网关：建议至少接入两家以备突发停用风险。
未留存交易日志与凭证：不利于后续争议处理或税务审计。

FAQ（常见问题）

Efecty现金收款接口文档企业跨境电商全面指南靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚政府认可的支付网络，与多家银行和电信运营商合作。通过正规支付网关接入属于合法合规操作，交易记录可用于财务报税。
适合哪些卖家/平台/地区/类目？
适合主攻哥伦比亚市场的B2C跨境电商企业，特别是销售电子产品、时尚服饰、家居用品的独立站或区域化平台卖家。不适合高价值耐用品或B2B大宗交易。
怎么开通/注册/接入/购买？需要哪些资料？
需通过支付网关（如dLocal）注册商户账户，提供企业营业执照、法人身份证明、网站链接、产品描述、银行账户信息、月交易预估等。具体材料以网关要求为准。
费用怎么计算？影响因素有哪些？
费用由支付网关制定，通常包含交易手续费（1.5%-4%）、货币转换费、结算费等。影响因素包括交易量、行业风险等级、结算速度、是否含反欺诈服务等。
常见失败原因是什么？如何排查？
常见原因：用户未在有效期内付款、网络请求超时、回调地址不可达、签名验证失败、订单金额不符。排查方法：检查服务器日志、确认Webhook配置、测试沙箱环境、联系网关技术支持。
使用/接入后遇到问题第一步做什么？
首先查看支付网关后台的交易详情页和错误代码，确认是前端跳转、支付中断还是回调失败；然后检查API调用日志和服务器响应；若无法定位，及时联系网关客服并提供 transaction ID 和 timestamp。
和替代方案相比优缺点是什么？
对比Baloto：同为哥伦比亚现金支付，Efecty 网点更多但有效期更短；对比信用卡：Efecty 覆盖人群广但到账慢；对比PSE（网银转账）：Efecty 无需网银账户但需出门支付。建议组合使用多种本地支付方式。
新手最容易忽略的点是什么？
一是忘记配置自动订单状态同步，造成发货延误；二是未在结账页面清楚标注付款截止时间和操作指引；三是未测试小语种界面下的支付流程完整性。