Efecty现金收款接口文档跨境卖家APP应用费率说明
2026-02-24 3
详情
报告
跨境服务
文章
Efecty现金收款接口文档跨境卖家APP应用费率说明
要点速读（TL;DR）
- Efecty 是拉美地区主流的现金支付方式，尤其在哥伦比亚广泛用于无银行卡用户线下付款。
- 跨境卖家可通过集成 Efecty 收款接口文档 实现订单系统与本地支付网络对接，支持买家生成付款码后在便利店完成现金支付。
- 接入需通过支持拉美市场的第三方支付网关（如Paddle、dLocal、Checkout.com等），目前 Efecty 不直接面向中小卖家开放独立API注册。
- 资金结算周期通常为T+3至T+7工作日，币种为当地货币（如COP），换汇与提现由收单机构或收款平台处理。
- 费率结构包含交易手续费、汇率加价、失败订单处理费等，具体以合作支付服务商合同为准。
- 使用 APP 应用内集成 Efecty 需遵循当地合规要求，包括KYC验证、消费者告知义务及税务发票匹配。
Efecty现金收款接口文档跨境卖家APP应用费率说明 是什么
Efecty 是总部位于哥伦比亚的现金支付网络，允许消费者在线下单后获取条码，在超过15,000个零售网点（如Droguería Simi、Alkosto、Éxito）以现金完成支付。该服务主要覆盖哥伦比亚，部分扩展至秘鲁和厄瓜多尔市场。
现金收款接口文档 指 Efecty 或其授权支付网关提供的API技术文档，包含以下核心内容：
- 支付链接生成接口：输入订单金额、商户ID、回调URL后返回可打印/展示的付款条码或二维码。
- 状态查询接口：用于轮询订单是否已由买家完成现金缴纳。
- 异步通知（Webhook）：支付成功后向卖家服务器推送确认消息。
- 退款接口：部分支持原路退回至Efecty账户，但现金退款需用户凭身份证件线下领取，流程复杂。
跨境卖家APP应用 指中国跨境电商企业在自有移动端App中嵌入Efecty支付选项，通常通过SDK或H5页面跳转实现，确保本地用户体验流畅。
费率说明 并非统一公开报价，而是由中间支付服务商（如dLocal、PagaTodo、Mercado Pago）在与Efecty合作基础上打包提供给跨境平台的综合成本结构，包含手续费、汇率差价、风控服务费等。
它能解决哪些问题
- 痛点：拉美大量人群无信用卡或银行账户 → 价值：Efecty覆盖超60%哥伦比亚成年人口，提升转化率。
- 痛点：线上支付信任度低 → 价值：现金支付让买家感觉更安全，降低弃单率。
- 痛点：国际卡拒付率高 → 价值：本地化支付减少发卡行风控拦截。
- 痛点：物流前无法确认实付款 → 价值：接口实时回传支付状态，自动化发货流程。
- 痛点：多国本地支付方式碎片化 → 价值：通过一个支付网关集成Efecty等多种现金支付渠道。
- 痛点：资金回笼慢 → 价值：相比传统TT电汇，Efecty结算更快（通常一周内）。
- 痛点：APP内购体验割裂 → 价值：H5或轻量SDK嵌入保持用户留在应用内完成支付。
怎么用/怎么开通/怎么选择
步骤 1：评估目标市场是否适用
p>确认主营站点是否包含哥伦比亚，且目标客群偏向中低收入、偏好现金交易。据世界银行数据，哥伦比亚约48%成年人无银行账户，是Efecty的核心使用群体。步骤 2：选择支持Efecty的支付服务商
p>目前Efecty不直接对跨境中小卖家开放独立接入，必须通过已与其建立合作关系的全球或区域支付网关。常见选项包括：- dLocal（纳斯达克上市，支持Efecty、Oxxo、Boleto等）
- Mercado Pago（拉美最大电子钱包，整合多种现金支付）
- Checkout.com（企业级网关，支持定制化接入）
- PagaTodo（专注拉美，提供Efecty API封装）
步骤 3：注册并申请开通Efecty通道
p>向选定服务商提交：- 公司营业执照（中英文公证件）
- 网站/App截图及商品类目说明
- 预计月交易量与客单价
- 反洗钱合规政策文件（AML/KYC流程描述）
- 法人身份证明与银行账户信息
步骤 4：对接Efecty接口文档
p>从支付服务商处获取Efecty现金收款接口文档，关键动作包括：- 配置HTTPS回调地址接收支付结果
- 调用“创建支付”API生成付款码（含订单号、金额、过期时间）
- 在App或H5页面展示条码供用户扫码
- 设置定时任务轮询订单状态（建议每15分钟一次）
- 处理Webhook通知并更新订单状态
步骤 5：测试与上线
p>使用服务商提供的沙箱环境进行全流程测试，包括：- 生成测试付款码
- 模拟支付成功/失败/超时场景
- 验证回调与数据库同步
步骤 6：运营与对账
p>每日下载服务商提供的结算报表，核对：- 成功订单数与金额
- 手续费扣除明细
- 汇率换算基准价
- 退款与争议记录
费用/成本通常受哪些因素影响
- 月交易流水总额（越高议价空间越大）
- 单笔订单平均金额（大额可能享受阶梯费率）
- 所在行业风险等级（虚拟商品、高单价品类费率更高）
- 是否使用服务商的自动换汇与提现服务
- 结算币种选择（COP本地结算 vs USD跨境结算）
- 退款率与争议率（过高可能导致附加费）
- 是否启用高级风控模块（如机器学习防欺诈）
- 技术支持等级（标准支持 vs 专属客户经理）
- 合同签约期限（长期合约常有折扣）
- 是否捆绑其他支付方式（如PSE网银转账）
为了拿到准确报价/成本，你通常需要准备以下信息：
- 过去3个月GMV与订单量
- 目标国家分布（仅哥伦比亚？还是多国）
- 期望的结算频率（T+1/T+3/T+7）
- 拟接入的支付方式清单（是否同时要Oxxo、Boleto等）
- 技术团队对接能力说明（能否自主开发API）
- 历史拒付率数据（如有）
常见坑与避坑清单
- 误以为Efecty可全球通用：实际仅限哥伦比亚为主，其他拉美国家接受度极低，切勿盲目上架。
- 忽略付款有效期：Efecty条码通常24-72小时失效，需明确提示买家及时支付，否则订单自动取消。
- 未设置状态轮询：依赖Webhook易丢失通知，必须主动查询订单状态防止漏发。
- 汇率锁定不清晰：部分服务商在结算时才换汇，若期间波动大将影响利润，建议选择固定汇率产品。
- 退款流程设计不当：现金支付退款不能原路返回，需人工处理并通知买家线下领取，务必提前告知。
- 未做本地化文案：App内支付按钮应写“Pagar en Efecty”而非直译“Pay with Cash”，避免用户困惑。
- 过度依赖单一渠道：建议同时接入PSE（哥伦比亚网银）和Tarjeta de Débito，形成支付组合。
- 忽视税务合规：哥伦比亚要求开具电子发票（DIAN认证），支付成功后须同步触发开票流程。
- 技术文档版本过旧：定期检查服务商发布的API更新日志，避免因接口变更导致故障。
- 未配置异常监控：应设置API调用失败、长时间未支付等告警规则，及时干预。
FAQ（常见问题）
- Efecty现金收款接口文档跨境卖家APP应用费率说明靠谱吗/正规吗/是否合规？
是的，Efecty为哥伦比亚金融监管局（Superintendencia Financiera de Colombia）许可的支付服务机构，与dLocal等主流网关合作后可用于跨境电商合规收款，但需确保最终资金路径符合中国外汇管理规定。 - 适合哪些卖家/平台/地区/类目？
适用于主攻哥伦比亚市场的中国跨境卖家，尤其是销售手机配件、家居用品、时尚服饰等中低价实物商品的独立站或App商家；不推荐虚拟商品、高价值奢侈品或B2B大宗贸易。 - 怎么开通/注册/接入/购买？需要哪些资料？
需通过第三方支付网关（如dLocal）申请，提交企业营业执照、法人身份证、网站/App信息、业务描述及预计交易量等材料，审核通过后获取API权限。 - 费用怎么计算？影响因素有哪些？
费用由支付服务商打包收取，包含交易手续费（通常1.5%-4%）、汇率加价点差、固定通道费等，具体取决于交易量、类目、结算方式等因素，以合同约定为准。 - 常见失败原因是什么？如何排查？
常见原因包括：条码过期、买家未在指定网点支付、系统未收到通知、回调地址不可达。排查方法：检查日志中的订单状态变化、确认Webhook是否正常接收、登录服务商后台查看原始交易记录。 - 使用/接入后遇到问题第一步做什么？
立即登录所使用的支付服务商后台查看交易详情与错误代码，并导出相关请求ID与时间戳，联系其技术支持团队提供完整上下文日志。 - 和替代方案相比优缺点是什么？
对比 PayPal 或国际信用卡：优点是提高哥伦比亚本地转化率；缺点是结算慢、退款难、需额外技术支持。对比其他现金支付（如秘鲁的PagoEfectivo）：Efecty在哥国覆盖率最高，但不具备跨国产能。 - 新手最容易忽略的点是什么？
一是未设置订单超时关闭逻辑，导致库存被长期占用；二是未向买家清晰说明付款流程，造成客服压力激增；三是忽略本地发票要求，引发后续税务纠纷。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业