Efecty现金充值API接入教程商家连锁门店详细解析
2026-02-24 3
详情
报告
跨境服务
文章
Efecty现金充值API接入教程商家连锁门店详细解析
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的现金支付网络，支持消费者通过线下门店为线上交易付款。
- 接入 Efecty 现金充值 API 可让跨境卖家在拉美市场（尤其是哥伦比亚）拓展无银行卡用户的客群。
- 适合面向拉美市场的独立站或电商平台卖家，尤其针对中低价商品、预付费服务类目。
- 需与支持 Efecty 的支付网关（如 PayU Latam、Mercado Pago）集成，而非直接对接 Efecty 官方。
- 生成的支付凭证包含条形码和有效期限，用户须在规定时间内到指定门店完成现金支付。
- 资金结算周期通常为 T+3 到 T+7，具体以支付服务商合同为准。
Efecty现金充值API接入教程商家连锁门店详细解析 是什么
Efecty 是哥伦比亚领先的非银行支付网络，提供覆盖全国的现金收缴服务。它允许消费者在线下单后，凭生成的支付单据在合作实体门店（如超市、药店、便利店）用现金完成付款。
现金充值API 指的是由第三方支付平台提供的程序接口，用于将 Efecty 支付方式嵌入电商系统。卖家无法直接调用 Efecty 的底层API，而是通过集成支持 Efecty 的支付服务商（如 PayU、Dlocal、Mercado Pago）的API来实现功能。
关键词解释
- API 接入：应用程序编程接口，用于不同系统间数据交互。例如订单信息传给支付网关，返回付款二维码或票据编号。
- 现金充值：指用户通过线下现金缴纳完成线上订单支付的行为，常见于银行账户普及率低的市场。
- 商家连锁门店：Efecty 合作的实体网点，包括 Alkosto、Éxito、Farmatodo 等大型零售连锁，覆盖超 20,000 个地点（数据来源：PayU Latam 公开资料）。
- 支付网关：中介平台，连接电商平台与多种本地支付方式（含 Efecty），负责交易路由、风控与结算。
它能解决哪些问题
- 痛点：哥伦比亚信用卡渗透率不足30% → 提供现金支付选项可触达更广消费群体。
- 痛点：跨境支付拒付率高 → 现金支付即付即结，降低欺诈和退款风险。
- 痛点：本地化支付体验差 → 支持本地习惯的支付方式提升转化率（据部分卖家反馈，启用后加购转化提升15%-25%）。
- 痛点：物流前需确认收款 → Efecty 支付成功后状态实时回传，便于自动释放订单。
- 痛点：缺乏对账工具 → 正规支付网关提供交易流水、状态查询、回调通知等接口，便于财务核销。
- 痛点：小金额订单难收款 → 适用于5万-30万COP（约13-80美元）区间订单，符合拉美小额高频消费特征。
怎么用/怎么开通/怎么选择
步骤 1：确认业务适配性
- 目标市场是否包含哥伦比亚？
- 客单价是否集中在5万-50万COP？
- 使用独立站或自建系统，还是依赖平台（如 Mercado Libre）？
步骤 2：选择支持 Efecty 的支付服务商
常见选项：
- PayU Latam（已被 Rapyd 收购）—— 覆盖全面，文档完善，支持多语言接入。
- Dlocal —— 上市公司，专注新兴市场，API 统一性强。
- Mercado Pago —— 若主要在 Mercado Libre 卖货，天然集成。
- Transbank Global 或 Conekta（区域型，需核实哥伦比亚支持情况）。
步骤 3：注册并开通商户账户
- 访问所选支付网关官网，提交企业注册申请。
- 准备材料通常包括：
- 营业执照（中国公司或当地注册主体）
- 法人身份证/护照
- 银行账户证明（用于结算）
- 网站/APP 信息（域名、隐私政策链接）
- 预估月交易量 - 审核周期一般为3-7个工作日。
步骤 4：获取 API 凭证与沙箱环境
- 登录商户后台，启用 Efecty 支付渠道。
- 下载 API 文档，获取：
- Merchant ID / Api Key
- Sandbox 测试账号与密钥
- Webhook 回调地址配置入口
步骤 5：技术对接（API 接入核心流程）
- 在用户结算页选择“Pago en efectivo”或“Pagar en Efecty”。
- 前端调用支付网关创建订单接口（POST /payments），参数包含：
- 订单号
- 金额（COP）
- 支付方式代码（如 PAYU_METHOD_CODE: EFECTY）
- 用户邮箱/手机号（用于发送凭证） - 服务端接收响应，提取：
- reference（支付参考号）
- barcode（条形码数字串）
- expiration_date（截止时间，通常24-72小时）
- payment_link（可打印页面URL） - 展示支付凭证页面给用户，并通过邮件/SMS 发送详情。
- 配置 Webhook 监听支付成功事件（status=APPROVED），触发发货流程。
步骤 6：测试与上线
- 使用沙箱环境模拟 Efecty 支付全流程。
- 验证回调通知是否正常接收与处理。
- 检查订单状态同步逻辑。
- 联系支付服务商技术支持确认生产环境切换条件。
费用/成本通常受哪些因素影响
- 商户所属行业类目（高风险类目费率更高）
- 月均交易笔数与总金额
- 是否使用统一结算货币（USD/COP）
- 是否需要多币种支持
- 是否有反欺诈模块启用
- 是否要求T+1快速结算
- 技术支持等级（标准/专属客户经理）
- 是否涉及跨境清算通道（如从COP换汇至CNY）
- 是否存在争议处理或拒付纠纷
- 合同谈判能力（大卖家可议价）
为了拿到准确报价，你通常需要准备以下信息：
- 公司注册地与运营主体
- 主营电商平台或独立站
- 预计首月交易量级（笔数+GMV）
- 主要销售国家与币种
- 历史拒付率（如有）
- 技术对接方式（API/插件/托管页面）
常见坑与避坑清单
- 误以为可直连 Efecty：Efecty 不向普通商户开放API，必须通过支付网关接入。
- 忽略支付有效期：未提醒用户在24-72小时内完成支付，导致订单失效。
- 未配置 Webhook 回调：依赖手动查单，延误发货。
- 条形码显示异常：前端未正确渲染 Code128 格式条码，门店无法扫描。
- 未提供西班牙语说明：用户看不懂支付指引，放弃付款。
- 结算账户不匹配：COP 结算需本地银行账户，或接受第三方换汇服务。
- 未做沙箱测试：上线后出现签名错误、参数缺失等问题。
- 忽视合规要求：未在隐私政策中声明与支付网关的数据共享。
- 高估覆盖率：偏远地区门店可能不支持 Efecty，需提前告知用户查询网点。
- 未监控失败率：定期分析支付取消原因（超时/用户放弃），优化流程。
FAQ（常见问题）
- Efecty现金充值API接入靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚央行认可的支付机构，其合作网关（如 PayU、Dlocal）均持有相应金融牌照，交易受当地法规监管，合规性高。 - Efecty现金充值API接入适合哪些卖家/平台/地区/类目？
适合：
- 主打哥伦比亚市场的独立站或平台卖家
- 客单价在5万-50万COP的商品（如手机配件、服饰、家居）
- 无法使用信用卡的目标人群
不适合：
- 高单价、低频次商品（如大家电）
- 实时交付类服务（因支付有延迟） - Efecty现金充值API怎么开通/注册/接入/购买？需要哪些资料？
需通过支付网关（如 PayU/Dlocal）注册商户账户，提供营业执照、法人证件、银行信息、网站资料等。接入采用API方式，由技术人员完成开发与测试。 - Efecty现金充值API费用怎么计算？影响因素有哪些？
费用由支付网关收取，包含交易手续费（按比例）、固定费、结算费等。影响因素包括交易量、类目、结算速度、币种转换需求等，具体以合同为准。 - Efecty现金充值API常见失败原因是什么？如何排查？
常见原因：
- 用户未在有效期内支付
- 条形码生成错误
- API 签名验证失败
- 商户账户权限未开启 Efecty 渠道
排查方法：
- 查看支付网关后台交易日志
- 检查请求参数完整性
- 使用沙箱复现问题 - 使用/接入后遇到问题第一步做什么？
首先查看支付网关提供的交易详情页和错误码；其次检查Webhook是否收到通知；最后联系该服务商的技术支持团队，提供reference ID与时间戳。 - Efecty现金充值API和替代方案相比优缺点是什么？
对比 Baloto（类似现金支付）：
优点：Efecty 门店密度更高，操作更简便
缺点：部分 Baloto 支持更长支付期限
对比信用卡支付：
优点：降低拒付风险，覆盖无卡人群
缺点：到账慢，无法即时发货 - 新手最容易忽略的点是什么？
一是未设置自动订单关闭机制（超时未付）；二是未向用户发送清晰的支付指引（含门店查询链接）；三是未进行多语言适配（特别是西语）；四是忽视对账文件自动化导入。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业