Efecty现金收款接口文档开发者连锁门店费率说明

2026-02-24 1

详情

报告

跨境服务

文章

Efecty现金收款接口文档开发者连锁门店费率说明

要点速读（TL;DR）

Efecty 是哥伦比亚主流的线下现金支付网络，支持消费者在实体门店用现金完成电商交易。
跨境卖家可通过接入 Efecty 收款接口，为哥伦比亚买家提供本地化支付方式，提升转化率。
需开发者对接 API 接口文档 实现订单创建、状态查询等自动化流程。
连锁门店覆盖广，但每笔交易收取服务费，费率结构通常由收单机构或支付网关决定。
适用平台：独立站、拉美本地电商平台；主要面向哥伦比亚市场。
合规要求高，需核实商户资质、KYC材料及资金结算路径。

Efecty现金收款接口文档开发者连锁门店费率说明是什么

Efecty 是哥伦比亚领先的非银行支付网络，允许用户通过其遍布全国的连锁零售门店以现金支付账单或在线购物款项。对于跨境电商卖家而言，Efecty 现金收款是一种本地化支付解决方案，帮助无法使用信用卡或电子钱包的消费者完成交易。

关键名词解释：

现金收款接口：指 Efecty 提供的 API 接口，用于生成可在线下门店支付的票据（如条形码、参考号），并同步支付状态回传至卖家系统。
开发者：负责技术对接的技术人员或团队，需阅读和实现 Efecty 接口文档 中定义的请求格式、认证方式、回调机制等。
连锁门店：Efecty 合作的便利店、超市、药店等实体网点，消费者可在这些地点出示参考码并支付现金。
费率说明：指使用该服务所产生的手续费结构，包括固定费用、百分比费用或两者结合，通常由支付服务商或收单方设定。

它能解决哪些问题

痛点：哥伦比亚信用卡渗透率低 → 价值： 提供现金支付选项，扩大潜在客户群。
痛点：国际卡拒付率高 → 价值： 本地现金交易，降低支付失败与争议风险。
痛点：独立站转化率低 → 价值： 增加本地信任感强的支付方式，提高下单完成率。
痛点：缺乏本地收单能力 → 价值： 借助第三方支付网关集成 Efecty，快速上线本地支付。
痛点：订单状态人工核对效率低 → 价值： 通过 API 自动回调更新支付状态，减少客服介入。
痛点：资金回笼周期长 → 价值： 明确结算周期（T+1/T+2），便于现金流管理。
痛点：跨境支付合规复杂 → 价值： 通过持牌支付机构处理本地清分，降低合规压力。
痛点：技术对接成本高 → 价值： 使用标准化接口文档，缩短开发周期。

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

由于 Efecty 不直接向境外中小卖家开放接口，通常需通过以下路径实现接入：

选择支持 Efecty 的支付网关：如 PagoFacil、PayU Latam、Mercado Pago、Dlocal 或其他专注拉美的收单机构。
注册商户账户：提交公司营业执照、法人身份证明、网站信息、业务模式说明等 KYC 材料。
申请开通 Efecty 支付方式：在支付网关后台提出功能开通请求，签署相关协议。
获取 API 文档：从支付网关下载包含 Efecty 接入规范的技术文档，包括：
- 订单创建接口（POST /payments）
- 回调通知（Webhook）配置
- 查询支付状态接口
- 错误代码对照表
技术对接与测试：开发者根据文档完成接口调用开发，并在沙箱环境中验证全流程。
上线与监控：切换至生产环境，启用 Efecty 支付入口，并设置异常订单报警机制。

注：Efecty 官方不对外提供独立开发者接入通道，所有交易均需经由持牌支付服务提供商处理。具体流程以所选支付网关的实际页面为准。

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

商户所属行业类目（高风险类目费率更高）
月交易 volume（交易量越大，议价空间可能越高）
是否为新注册商户（初期可能有优惠或试用期）
使用的支付网关或收单机构（不同服务商定价策略不同）
结算币种（COP vs USD）及汇率加点
是否有退款或争议处理需求
是否需要额外技术支持或定制开发
合同中约定的最低结算金额或月费条款
是否包含反欺诈风控模块
资金到账时效（即时结算通常成本更高）

为了拿到准确报价/成本，你通常需要准备：

预估月交易笔数与金额
目标国家（如仅 Colombia）
销售类目（如电子产品、时尚、数字商品等）
现有支付方式与拒付率数据
技术对接能力说明（是否自研系统）
期望结算周期（T+1, T+2 等）
KYC 资料完整版（企业证件、银行账户信息）

常见坑与避坑清单

未确认结算货币和汇率损失：部分服务商以 COP 结算，换汇时产生隐性成本，建议提前确认。
忽略 Webhook 安全校验：未验证回调来源可能导致虚假支付状态更新，造成发货损失。
超时未支付订单未自动取消：Efecty 支付码通常有 24-72 小时有效期，系统应设置自动关闭机制。
未测试沙箱环境全链路：跳过测试直接上线易导致订单不同步、对账困难。
误以为 Efecty 直接对接：试图联系 Efecty 官方开户，浪费时间；必须通过授权支付网关。
忽视本地消费者习惯：未在订单页清晰展示操作指引（如“去附近 Tiendas D1、Alkosto 缴费”），影响支付成功率。
KYC 材料不完整被拒：外国公司需提供英文公证文件或本地代理信息，提前咨询服务商要求。
对账口径不一致：注意区分“支付成功时间”与“结算入账时间”，避免财务错判收入。
未设置拒付与争议响应机制：虽为现金支付，但仍可能存在买家否认交易情况，需留存交易日志。
过度依赖单一本地支付方式：建议同时接入 Baloto、PSE 等互补渠道，提升整体支付成功率。

FAQ（常见问题）

Efecty现金收款接口文档开发者连锁门店费率说明靠谱吗/正规吗/是否合规？
是正规支付方式。Efecty 受哥伦比亚金融监管机构监督，其合作收单机构需持有当地支付牌照。只要通过合法注册的支付网关接入，交易与资金流转符合当地法规。
适合哪些卖家/平台/地区/类目？
主要适用于：
- 面向哥伦比亚消费者的独立站或区域电商平台
- 类目如消费电子、家居、时尚、健康产品等
- 支持本地化运营且接受 T+1 以上回款周期的卖家
- 不适合高单价、低频次或 B2B 大额交易
怎么开通/注册/接入/购买？需要哪些资料？
需通过支付网关（如 PayU、Dlocal）注册商户账户，提供：
- 公司营业执照（中英文公证件）
- 法人身份证或护照
- 商户网站或 App 信息
- 银行账户信息（支持外币结算）
- 业务描述与预计交易规模
费用怎么计算？影响因素有哪些？
无统一标准，费用由支付网关制定，一般包含：
- 按笔收取的服务费
- 交易金额百分比佣金
- 汇率转换费（若以 COP 结算）
影响因素见上文“费用/成本通常受哪些因素影响”部分。
常见失败原因是什么？如何排查？
常见原因：
- 支付码过期未缴款
- 消费者输入参考号错误
- 系统未收到 Webhook 回调
- 商户账户异常导致无法生成订单
排查步骤：
1. 检查订单状态是否为“已生成”
2. 查看支付网关后台是否有回调记录
3. 核实商户账户状态与限额
4. 联系支付网关技术支持提供日志分析
使用/接入后遇到问题第一步做什么？
第一步应登录所使用的支付网关后台查看交易详情与错误代码，确认问题类型（如接口超时、签名失败、回调丢失）。随后联系该服务商的技术支持团队，并提供：
- 请求 ID
- 时间戳
- 接口返回原始报文
和替代方案相比优缺点是什么？
对比 Baloto： 覆盖门店数量相近，费率结构类似，可同时接入互为补充。
对比 PSE（网银转账）： Efecty 无需网银，更适合无银行账户人群，但 PSE 实时到账更快。
对比信用卡： Efecty 支付成功率更高，但结算周期更长，且不可用于订阅制业务。
新手最容易忽略的点是什么？
最易忽略：
- 未配置 Webhook 安全验证（如 HMAC 签名）
- 忽视支付码有效期导致长期挂单
- 未在前端清晰展示缴费门店列表与操作指引
- 未做对账映射规则（参考号与订单号匹配）
- 以为“支付成功”即等于“资金到账”，未区分清算与结算阶段