Efecty现金收款API接入教程商家APP应用费率说明

2026-02-24 1

详情

报告

跨境服务

文章

Efecty现金收款API接入教程商家APP应用费率说明

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，支持消费者在线下单后线下现金付款。
跨境卖家可通过 API 接入 Efecty 收款能力，为拉美用户提供本地化支付方式。
需通过支持拉美市场的第三方支付网关（如Paddle、Dlocal、Checkout.com等）间接集成Efecty，平台不提供直接对接入口。
用户完成支付后，资金结算周期通常为 T+3 到 T+7 工作日，具体以收单方规则为准。
费用结构包含交易手续费、货币转换费、失败交易处理费等，无固定费率表，需与服务商协商合同。
商家APP中展示Efecty选项时，应明确提示用户付款截止时间（通常24-72小时）和操作流程。

Efecty现金收款API接入教程商家APP应用费率说明是什么

Efecty 是哥伦比亚领先的非银行支付网络，允许消费者在电商平台选择“Efecty”作为支付方式后，生成一个条形码或参考号，前往其遍布全国的超15,000个线下网点以现金完成付款。该服务广泛用于电商、账单缴纳和移动充值。

对于中国跨境卖家而言，“Efecty现金收款API接入教程商家APP应用费率说明”指：如何通过技术接口将Efecty支付能力嵌入自有APP或网站，并了解其在商家端的应用逻辑与成本构成。

关键词解释

API接入：应用程序编程接口，用于系统间数据交互。此处指电商平台调用支付网关提供的Efecty接口，生成付款凭证。
现金收款：消费者使用实体现金完成线上订单支付，区别于信用卡或电子钱包。
商家APP：指卖家自有的移动端应用或H5页面，需集成支付选项并引导用户完成流程。
费率说明：描述交易过程中产生的各类费用项目及计算逻辑，通常由支付服务商在合同中列明。

它能解决哪些问题

痛点：拉美市场银行卡渗透率低 → 价值：Efecty覆盖哥伦比亚大量无卡人群，提升转化率。
痛点：国际信用卡拒付率高 → 价值：现金预付模式降低欺诈与拒付风险。
痛点：本地支付方式缺失影响信任 → 价值：显示Efecty图标增强本土可信度。
痛点：物流前无法确认付款状态 → 价值：API可实时回调通知支付成功，触发履约。
痛点：资金回笼慢 → 价值：相比传统电汇，通过合规支付通道结算更高效。
痛点：多平台管理复杂 → 价值：统一API接入多个本地支付方式，减少开发成本。
痛点：用户放弃支付因流程不清 → 价值：APP内清晰指引条码打印/保存/付款时效。
痛点：汇率损失大 → 价值：部分服务商支持COP本地结算，避免双重换汇。

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

由于Efecty不向境外商户直接开放API，必须通过具备拉美收单资质的中间支付服务商实现接入。以下是典型流程：

评估目标市场：确认主要客户来自哥伦比亚或南美西北部国家（如厄瓜多尔部分地区也支持Efecty）。
选择支持Efecty的支付网关：常见服务商包括 Dlocal、Paddle、Mercado Pago Global、Checkout.com、Thredd 等，核实其是否提供Efecty API文档和技术支持。
注册并申请商户账户：提交公司营业执照、法人身份证明、网站/App信息、预计交易量等资料，完成KYC审核。
获取API密钥与沙箱环境：登录服务商后台，启用Efecty支付方式，下载API文档，配置测试环境。
开发对接：
- 调用服务商提供的创建订单接口，传入金额、币种（COP）、商品信息、用户邮箱/手机号；
- 接收返回的reference number和barcode URL；
- 在商家APP中展示条码图像及付款说明，建议增加倒计时提醒。
设置Webhook回调：配置服务器接收支付成功/失败的通知，用于更新订单状态并启动发货流程。
上线前测试：使用沙箱生成模拟付款记录，验证全流程闭环。
正式上线并监控：观察首周交易成功率、用户反馈、结算对账单准确性。

注：Efecty官方不对商户直接提供技术支持，所有问题需通过所选服务商协调处理。

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

月均交易笔数与总交易额（volume-based pricing）
单笔交易金额区间（阶梯费率）
是否使用本地清结算通道（COP vs USD settlement）
是否包含反欺诈风控模块
是否需要多语言客服支持
退款频率与处理机制
是否绑定其他本地支付方式打包计价
货币兑换服务提供商的选择（如涉及USD→COP）
是否存在最低月费或隐性服务费
合同谈判能力与合作年限

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

公司注册地与主体类型（中国大陆/香港/美国等）
预期月交易量（笔数+GMV）
主要销售类目（如电子产品、时尚、健康）
现有技术栈（是否已有支付中间层）
希望支持的国家与支付方式组合
是否要求发票合规与税务支持

常见坑与避坑清单

误以为可直连Efecty：必须通过第三方支付网关，自行开发无效。
忽略付款有效期：未在APP中提示用户24小时内完成支付，导致订单超时关闭引发客诉。
条码展示不清晰：未适配移动端屏幕尺寸，造成扫码失败。
未设置异步通知：依赖用户手动返回页面，漏掉支付成功的订单。
结算周期误解：以为T+1到账，实际可能延迟至T+7，影响现金流规划。
费率隐藏条款：未仔细阅读合同中的“失败交易收费”“账户维护费”等附加项。
KYC材料不全：使用个体工商户注册被拒，需企业主体且能提供外销资质。
未做多服务商对比：单一报价缺乏议价空间，建议至少询价3家。
上线后无监控：未配置异常交易报警，错过系统故障窗口期。
忽视用户教育：未在APP内嵌入图文指引，导致首次使用者流失。

FAQ（常见问题）

Efecty现金收款API接入教程商家APP应用费率说明靠谱吗/正规吗/是否合规？
是的。Efecty是哥伦比亚央行认可的支付服务机构，合规运营多年。通过持牌支付网关接入属于合法跨境收款路径，但需确保自身店铺符合目的国进口与税务要求。
适合哪些卖家/平台/地区/类目？
适用于面向哥伦比亚消费者的中国跨境卖家，尤其适合独立站、APP商城。高频适用类目包括手机配件、小家电、美妆、服饰。不适合B2B大额交易或禁运品。
怎么开通/注册/接入/购买？需要哪些资料？
需通过第三方支付服务商开通。基本资料包括：企业营业执照扫描件、法人身份证/护照、银行开户证明、公司章程、电商平台链接或APP截图、业务描述及预期交易规模。部分服务商要求视频认证。
费用怎么计算？影响因素有哪些？
无公开统一费率。费用一般包含交易手续费（%+固定费）、货币转换费、结算费、退款处理费等。具体取决于交易量、行业风险等级、结算币种和服务商定价策略。
常见失败原因是什么？如何排查？
常见原因：
- 用户未在有效期内付款
- 条码信息错误或无法加载
- 服务商系统临时中断
- Webhook未正确接收回调
- KYC审核未通过导致交易拦截
排查方法：检查API响应日志、确认商户账户状态、测试沙箱流程、联系服务商技术支持。
使用/接入后遇到问题第一步做什么？
立即查看服务商提供的交易详情面板和API日志，确认错误代码；随后联系该服务商的技术支持团队，提供订单ID、timestamp、request ID等关键信息。
和替代方案相比优缺点是什么？
对比PSE（网银转账）：Efecty无需网银，更适合低收入人群，但需线下跑腿；对比Baloto：两者定位相似，覆盖率略有差异，建议同时接入；对比信用卡：Efecty降低拒付风险但延长确认时间；对比Cash on Delivery：避免尾程拒收，提前锁定支付意向。
新手最容易忽略的点是什么？
一是未测试完整用户旅程，只关注API调通而忽略APP端体验；二是忽略结算周期对资金流的影响；三是未签订书面服务协议就投入开发，后期维权困难。