Efecty现金充值API接入教程商家本地电商全面指南

2026-02-24 1

详情

报告

跨境服务

文章

Efecty现金充值API接入教程商家本地电商全面指南

要点速读（TL;DR）

Efecty 是拉美地区主流的现金支付方式，尤其在哥伦比亚广泛用于无银行账户人群。
接入 Efecty 现金充值 API 可帮助跨境商家支持本地化支付，提升南美市场转化率。
需通过第三方支付网关或本地收单机构间接接入，不支持中国卖家直接注册。
API 接入核心步骤：选择支持 Efecty 的支付服务商 → 开通本地收款账户 → 技术对接 → 测试 → 上线。
重点注意合规要求、结算周期、拒付处理机制及用户支付凭证核验流程。
适用于面向哥伦比亚等拉美市场的跨境电商平台或独立站卖家。

Efecty现金充值API接入教程商家本地电商全面指南是什么

Efecty 是哥伦比亚领先的非银行现金支付网络，为无银行卡用户提供账单支付、转账、缴费和电子 commerce 支付服务。其现金充值API允许电商平台将订单生成可在线支付的虚拟账单（PSE 或现金单），用户可在 Efecty 线下网点或合作便利店以现金完成付款。

关键词解释

API 接入：应用程序接口（Application Programming Interface），用于系统间数据交互。此处指电商平台与支付服务商之间的技术对接，实现订单信息传输与支付状态回调。
现金充值：消费者在实体网点用现金完成线上订单支付的行为，属于货到付款替代方案，降低支付门槛。
本地电商支付：针对特定国家/地区主流支付方式进行适配，如巴西 Boleto、墨西哥 Oxxo、哥伦比亚 Efecty，是提升转化的关键。
支付服务商（Payment Service Provider, PSP）：通常为中国跨境卖家提供多币种收单、本地支付方式聚合的技术平台，如 dLocal、Pagsmile、Checkout.com、Rapyd 等，是接入 Efecty 的必要中介。

它能解决哪些问题

痛点：拉美消费者银行渗透率低 → 价值：覆盖无卡人群，哥伦比亚约40%成年人无银行账户，Efecty 提供关键支付入口。
痛点：信用卡拒付率高 → 价值：现金支付不可逆，减少欺诈和争议风险。
痛点：本地支付缺失导致转化率低 → 价值：增强信任感，显示本地支付选项提升下单意愿。
痛点：物流与支付脱节 → 价值：支付即确认订单，避免货到付款带来的拒收成本。
痛点：资金回款慢 → 价值：部分服务商支持T+1结算，优于传统COD模式。
痛点：技术门槛高 → 价值：通过PSP统一接入多种本地支付，降低开发成本。
痛点：合规风险 → 价值：由持牌PSP处理KYC与反洗钱，减轻卖家合规负担。

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

由于 Efecty 不对中国卖家开放直接合作，必须通过具备拉美收单能力的支付服务商间接接入。以下是常见操作流程：

选择支持 Efecty 的支付服务商
筛选标准包括：是否持有哥伦比亚金融牌照、是否支持 Efecty 现金支付、是否有稳定API文档、是否支持人民币结算、风控与客服响应能力。常见服务商：dLocal、Rapyd、Pagsmile、Mercado Pago、Checkout.com。
提交入驻申请
向选定PSP提交企业资料，通常包括：
- 营业执照（中英文公证件）
- 法人身份证/护照
- 公司银行账户信息
- 网站或App信息（域名、类目、月交易额预估）
- KYC问卷填写
审核周期一般为3-7个工作日。
开通本地收款账户
通过审核后，PSP会为商户开设本地虚拟账户（如哥伦比亚比索账户），用于接收 Efecty 支付款项。
获取API文档与测试环境
登录PSP后台，下载 Efecty 支付接入文档，获取测试密钥（Test Keys）和沙箱环境地址。
技术对接
开发人员按以下步骤集成：
- 创建支付请求：发送订单号、金额、币种、支付方式（Efecty）、用户信息至PSP API
- 展示支付凭证：接收返回的支付链接或二维码，展示给用户
- 接收回调通知（Webhook）：监听支付成功/失败状态，更新订单状态
- 实现退款接口（如需）
测试与上线
在沙箱环境中模拟完整支付流程，验证凭证生成、状态同步、对账逻辑。测试通过后申请生产环境密钥，正式上线。

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

交易手续费率（按笔或按比例，通常1.5%-4%）
结算币种与汇率加价（COP→USD→CNY 的换汇成本）
结算周期（T+1、T+3 或周结影响资金占用）
是否包含拒付处理服务
技术支持等级（是否有专属客户经理）
月交易 volume 是否达到阶梯优惠门槛
是否使用PSP提供的防欺诈系统
退款频率与处理费
API调用频次限制或超额费用
合同是否含最低交易额承诺

为了拿到准确报价，你通常需要准备以下信息：
- 目标市场（如仅哥伦比亚 or 多国）
- 预计月交易笔数与金额
- 销售类目（高风险类目费率更高）
- 是否已有技术团队支持API对接
- 结算货币偏好（USD/CNY）
- 是否需要发票或本地合规支持

常见坑与避坑清单

误以为可直接对接 Efecty：Efecty 不对境外商户开放直连，必须通过本地持牌PSP。
忽略用户支付时效：Efecty 账单通常有24-72小时有效期，超时未付需重新生成，应在前端明确提示。
未配置Webhook回调验证：易被伪造支付通知，建议校验签名并主动查询订单状态。
缺乏本地客服支持：用户在网点付款后未到账，需有渠道协助查单，建议选择提供西语客服的PSP。
未做对账自动化：手工核对易出错，应定期导出PSP交易报表与自身订单系统比对。
忽视高风险类目限制：如成人用品、虚拟商品可能被PSP拒接或提高费率，签约前需确认。
未测试线下支付场景：应模拟用户在Efecty柜台出示条形码支付的全流程。
忽略税务合规：在哥伦比亚收款可能涉及增值税申报，需咨询当地财税顾问。
使用过期API版本：PSP可能升级接口，需关注文档更新与停用通知。
未设置支付失败兜底方案：建议引导用户切换其他支付方式，避免流失。

FAQ（常见问题）

Efecty现金充值API接入教程商家本地电商全面指南靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚政府认可的支付网络，与多家银行合作。通过持牌PSP接入符合国际支付规范，但需确保所选服务商具备当地金融监管资质，建议核实其MSB或 equivalent 许可。
适合哪些卖家/平台/地区/类目？
主要适用于：
- 面向哥伦比亚消费者的独立站或平台卖家
- 类目如电子产品、家居、时尚服饰等实物商品
- 平台类型：Shopify、Magento、自研系统等支持API集成的电商系统
- 不适合虚拟商品、金融服务、敏感类目
怎么开通/注册/接入/购买？需要哪些资料？
无法直接购买，需通过PSP开通。所需资料：
- 企业营业执照（中英文）
- 法人身份证明
- 公司银行账户
- 网站/App信息
- 商业计划书（部分PSP要求）
流程：选择PSP → 提交资料 → 审核 → 签约 → 获取API → 技术对接
费用怎么计算？影响因素有哪些？
费用由PSP制定，通常包含：
- 交易手续费（按比列+固定费）
- 汇率转换费
- 结算费
- 退款处理费
影响因素见上文“费用/成本”章节，具体以合同为准。
常见失败原因是什么？如何排查？
常见原因：
- 用户未在有效期内完成支付
- 条形码识别错误
- PSP与Efecty系统短暂中断
- Webhook未正确接收
排查方法：
1. 查看PSP后台订单状态
2. 核实用户提供的支付凭证
3. 检查API回调日志
4. 联系PSP技术支持提供交易ID查证
使用/接入后遇到问题第一步做什么？
立即登录PSP商户后台查看交易详情与错误代码，并保留原始请求/响应日志。优先联系PSP客服提供交易ID、时间、用户信息进行排查，切勿自行修改生产环境配置。
和替代方案相比优缺点是什么？
对比对象：信用卡、PSE（在线银行转账）、Baloto（另一现金支付）
优点：
- 覆盖无卡人群 > Baloto
- 支付不可逆 < 信用卡
- 现金支付接受度高 > PSE
缺点：
- 到账延迟（通常1-2小时）> PSE实时到账
- 需线下操作，用户体验略低于数字钱包
新手最容易忽略的点是什么？
最常忽略：
- 忘记设置支付超时自动取消订单
- 未在前端清晰展示付款地点（如“全国12,000+ Efecty 网点可用”）
- 缺少西语版支付指引
- 未配置异常订单人工审核流程
- 忽视每月对账与差错处理机制