Efecty现金收款接口文档商家连锁门店2026最新

2026-02-24 2

详情

报告

跨境服务

文章

Efecty现金收款接口文档商家连锁门店2026最新

要点速读（TL;DR）

Efecty 是哥伦比亚主流的线下现金支付网络，支持消费者在实体门店用现金完成电商付款。
跨境卖家可通过集成 Efecty 现金收款接口，为哥伦比亚买家提供本地化支付方式。
接入需通过支付网关或收单机构合作，获取官方 API 接口文档 并完成技术对接。
适用于高客单、低信用卡渗透率的品类，如家电、3C、大件家居。
2026年趋势：更多平台要求支持 Efecty 作为本地合规支付选项，尤其面向无银行账户人群。
关键挑战：订单时效管理、对账复杂、退款流程非即时。

Efecty现金收款接口文档商家连锁门店2026最新是什么

Efecty 是哥伦比亚领先的非银行支付网络，拥有超过 14,000 家合作实体门店（包括药房、便利店、超市等），允许用户以现金方式缴纳账单或完成线上购物付款。对于跨境电商卖家而言，Efecty 现金收款接口 指的是通过技术对接，将 Efecty 支付选项嵌入到独立站或电商平台结账页面的能力。

关键名词解释：

现金收款接口：指由支付服务提供商（PSP）提供的 API 接口，用于生成可被消费者在 Efecty 实体网点支付的虚拟票据（reference number）。
商家连锁门店：指 Efecty 合作的线下零售网络，消费者在此支付后，系统会同步更新订单状态。
接口文档：由支付网关或 Efecty 授权合作伙伴提供的开发指南，包含请求参数、回调机制、错误码说明等。
2026 最新：反映当前监管环境与市场实践的变化，例如更严格的 KYC 要求、实时对账功能增强、反欺诈规则升级。

它能解决哪些问题

痛点：哥伦比亚信用卡持有率不足 30%，大量消费者无法使用国际卡支付 —— 价值：扩展无卡人群购买能力。
痛点：PayPal 或信用卡拒付率高，风控严格 —— 价值：降低支付失败率，提升转化。
痛点：本地电商平台（如 Mercado Libre Colombia）强制要求支持本地支付方式 —— 价值：满足平台入驻条件。
痛点：客户担心跨境交易安全，不愿绑定银行卡 —— 价值：提供熟悉的线下支付场景，增强信任。
痛点：物流成本高，退换货频繁 —— 价值：现金预付模式减少未付款发货风险。
痛点：清关需要实名支付凭证 —— 价值：Efecty 支付记录可作为合规资金来源证明。
痛点：缺乏本地收单能力 —— 价值：通过第三方网关实现本地结算。

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

常见接入流程（适用于独立站或自建系统卖家）

选择支付服务提供商（PSP）：确认其是否支持 Efecty 接入，如 Dlocal、PagueloFacil、PayU Latam、360Commerce 等。
注册商户账号：提交公司营业执照、法人身份证明、网站信息、SKU 类目清单、预计月交易额等资料。
签署合作协议：明确结算周期、手续费结构、争议处理责任划分。
获取接口文档：从 PSP 后台下载最新的 Efecty 现金支付 API 文档，包含沙箱环境地址、生产环境配置、签名算法说明。
技术对接：
- 前端展示 Efecty 图标与说明；
- 下单时调用 PSP 的创建订单接口，传入金额、币种（COP）、订单号、过期时间（通常 24-72 小时）；
- 接收返回的 reference code 和条形码 URL；
- 展示给用户用于线下支付。
回调与对账：
- 配置服务器接收 PSP 发送的异步通知（webhook），确认支付成功；
- 定期导出交易报表，核对实际到账与订单状态；
- 设置自动取消未支付订单的任务（建议 ≤72 小时）。

注意：Efecty 本身不直接向境外电商开放接口，必须通过持牌本地收单机构或全球支付网关间接接入。

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

月交易 volume（交易笔数与总金额）
单笔交易金额区间（阶梯费率）
是否包含欺诈监控与拒付保障服务
结算货币（COP 本币 vs USD）及换汇成本
结算周期（T+2、T+7 或按周结算）
技术支持等级（是否有专属客户经理）
是否需要多语言客服支持
合同中是否包含最低交易额承诺
是否存在一次性接入费或年费
退款处理费用（部分服务商收取）

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

目标市场（仅哥伦比亚 or 多拉美国家）
预期月均订单量与GMV
主要销售类目（电子、时尚、健康等）
现有技术栈（Shopify、Magento、自研系统？）
是否已有其他本地支付方式需求（Baloto、PSE、Nequi）
是否需要发票自动化系统对接

常见坑与避坑清单

未设订单过期机制：消费者生成 reference 后未支付，导致库存锁定 —— 建议设置自动关闭订单任务。
忽视 callback 验证逻辑：未校验签名即更新订单状态，易被伪造通知 —— 必须验证 webhook 来源与签名。
未监控支付成功率：部分门店终端故障或网络延迟导致支付失败但状态未回传 —— 需建立异常订单人工核查流程。
退款流程不透明：Efecty 不支持原路退回现金，需走银行转账或余额返还 —— 提前告知用户并记录凭证。
KYC 材料不全：使用个体户或离岸公司主体申请被拒 —— 建议使用哥伦比亚本地注册实体或通过合规代理通道。
忽略语言本地化：支付页面未翻译成西班牙语，指引不清 —— 影响用户体验与转化率。
对账口径差异：PSP 结算金额与订单总额不符（扣除手续费后未明确标注）—— 要求提供明细对账单字段说明。
依赖单一服务商：某 PSP 出现接口中断导致支付不可用 —— 建议预留备用支付通道。
未测试沙箱环境全流程：上线后才发现回调地址错误或参数缺失 —— 上线前完成完整测试用例。
未关注监管变化：2025年起 Superintendencia Financiera de Colombia 加强对跨境商户的资金流向审查 —— 定期检查合规要求。

FAQ（常见问题）

Efecty现金收款接口文档商家连锁门店2026最新靠谱吗/正规吗/是否合规？
是的，Efecty 是受哥伦比亚金融监管局（SFC）监管的合法支付网络，其合作机构需具备相应支付牌照。只要通过正规渠道（如 Dlocal、PayU）接入，并完成商户KYC，即属合规操作。
适合哪些卖家/平台/地区/类目？
主要适用于：
- 目标市场为哥伦比亚的中国跨境卖家
- 独立站或自建站（Shopify Plus、Magento）
- 平台型卖家（Mercado Libre、Linio）若平台已集成则无需单独接入
- 高单价、低频次商品：手机、笔记本、健身器材、家具等
怎么开通/注册/接入/购买？需要哪些资料？
需通过支付网关注册商户账户，常见材料包括：
- 公司营业执照（中英文公证件）
- 法人护照或身份证扫描件
- 商业计划书或网站截图
- 银行账户信息（用于结算）
- SKU 清单与产品描述
- 预计交易数据
具体以所选 PSP 的审核要求为准。
费用怎么计算？影响因素有哪些？
无统一标准，费用由 PSP 制定，通常包含：
- 交易手续费（按百分比 + 固定费）
- 结算服务费
- 技术支持费（如有）
影响因素见上文“费用/成本”章节，最终以合同约定为准。
常见失败原因是什么？如何排查？
常见原因：
- reference code 过期未支付
- 消费者输错号码
- 门店系统故障
- callback 未正确接收或验证失败
排查步骤：
1. 查看 PSP 后台订单状态
2. 核对 webhook 日志
3. 联系 PSP 客服提供 reference code 查询支付结果
4. 设置内部异常订单标记机制
使用/接入后遇到问题第一步做什么？
第一步应登录支付服务商后台查看订单详情与日志；第二步检查 webhook 是否正常接收；第三步联系 PSP 技术支持并提供 transaction ID、reference code、时间戳等信息。
和替代方案相比优缺点是什么？
对比 Baloto：覆盖门店略少，但处理速度更快；
对比 PSE：无需网银，适合无银行用户；
对比信用卡：转化率更高但结算慢（T+2起）；
对比 Nequi/DaviPlata：不依赖智能手机，触达更广人群。
总体优势：覆盖广、信任度高；劣势：非实时到账、退款复杂。
新手最容易忽略的点是什么？
一是未设置订单超时关闭，造成库存虚占；二是忽略 callback 安全校验，存在虚假支付风险；三是未准备西班牙语版支付说明，导致用户在门店支付困难；四是不了解本地节假日影响（如 Semana Santa 期间门店营业时间缩短）。