Efecty现金收款API接入教程跨境卖家连锁门店收费标准

2026-02-24 2

详情

报告

跨境服务

文章

Efecty现金收款API接入教程跨境卖家连锁门店收费标准

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，支持消费者在实体连锁门店用现金支付线上订单。
跨境卖家可通过接入 Efecty API 实现自动订单同步与支付状态回调，提升本地转化率。
主要适用于面向哥伦比亚消费者的电商卖家，尤其是销售中低价商品的独立站或平台卖家。
接入需技术对接 API，并通过支付服务商或收单机构完成集成。
手续费通常由服务提供商收取，按交易笔数或金额比例计费，具体以合同为准。
常见坑：未处理支付超时、缺乏本地客服支持、未验证用户身份导致争议。

Efecty现金收款API接入教程跨境卖家连锁门店收费标准是什么

Efecty 是哥伦比亚领先的非银行支付网络，覆盖超过 14,000 家线下零售门店（如 Droguería Familiar、Alkosto、Éxito 等），允许消费者在线下单后生成付款码，凭码在门店以现金支付。

现金收款API接入 指跨境电商平台或独立站通过 Efecty 提供的 RESTful API 接口，实现以下功能：

创建支付订单（生成参考号）
查询支付状态
接收支付成功/失败的 Webhook 回调
取消未支付订单

连锁门店收费标准 并非由 Efecty 直接向消费者收费，而是指商户使用该服务时，支付服务商或收单机构所收取的技术服务费、交易手续费等成本结构。实际费用由集成方制定，Efecty 不直接对跨境卖家报价。

关键名词解释

API：应用程序接口，用于系统间数据交互。此处指 Efecty 提供的标准接口文档，支持 HTTPS 请求与 JSON 格式响应。
Webhook：服务器到服务器的异步通知机制。当用户完成现金支付后，Efecty 向卖家系统推送支付结果。
收单机构 / 支付服务商：如 dLocal、Paddle、Checkout.com 等具备拉美本地支付接入能力的第三方，通常作为中介帮助跨境卖家集成 Efecty。
参考号（Reference Number）：每笔订单唯一的支付标识，用户凭此在门店付款。
支付时效：通常为 24-72 小时，逾期未付自动失效。

它能解决哪些问题

痛点：哥伦比亚信用卡渗透率低 → 价值：支持现金支付，扩大客群：约 60% 成年人无国际信用卡，Efecty 覆盖广泛线下触点，提升转化。
痛点：PayPal 或国际卡拒付率高 → 价值：本地化支付方式降低拒付风险。
痛点：独立站信任度不足 → 价值：提供本地熟悉的支付选项增强可信度。
痛点：资金回款周期长 → 价值：支付确认后快速释放订单，配合本地清关提速履约。
痛点：多渠道订单管理混乱 → 价值：API 自动同步支付状态，减少人工核对。
痛点：无法追踪现金支付行为 → 价值：Webhook 实现实时到账通知和库存释放。
痛点：客户因无法支付弃单 → 价值：增加支付方式选择，降低购物车流失率。

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

由于 Efecty 不直接向境外电商开放 API 接入，跨境卖家需通过第三方支付服务商完成集成。以下是常见流程：

选择支持 Efecty 的支付服务商：优先考虑已在拉美有运营经验的服务商，例如 dLocal、Mercado Pago Global、Paddle、Nuvei 等，确认其支持 Colombia → Efecty 现金支付。
注册商户账户：提交公司营业执照、法人身份证明、网站域名、SKU 示例、预计交易量等资料完成 KYC 审核。
签署合作协议：明确结算周期、手续费结构、责任划分、数据使用权限等内容。
获取 API 接入凭证：服务商提供 API Key、Secret、测试环境 Endpoint 及文档链接。
开发对接：
- 调用 /payments 创建 Efecty 订单，返回 reference_number 和 barcode
- 前端展示支付信息（含条形码和门店列表）
- 配置 Webhook 地址接收支付成功通知
- 定期轮询 /payments/{id} 查询状态（备用机制）
上线前测试：使用沙箱环境模拟创建订单、支付回调、异常处理流程，确保系统稳定。

注意：Efecty 本身不提供独立开发者账号，所有接入必须经由持牌支付机构代理。

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

月均交易笔数与总交易额（volume-based pricing）
是否包含多币种结算（COP vs USD）
结算周期（T+7 vs T+14）
是否需要反欺诈模块或风控服务
技术支持等级（是否有专属客户经理）
是否捆绑其他本地支付方式（如 PSE、Baloto）
退款处理费用
汇率转换差价（若以美元结算）
API 调用频率限制与超额费用
是否有最低月费或年费

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

公司注册文件（营业执照、税务登记）
网站或 App 链接及截图
过去 3-6 个月交易流水（如有）
目标市场国家与主要产品类目
预期月交易量与客单价
是否已有支付服务商合作经历
技术团队对接能力说明（是否可自行开发 API）

常见坑与避坑清单

未设置支付截止时间：应明确告知用户付款有效期（通常 24-72 小时），并自动关闭过期订单。
忽略 Webhook 安全校验：必须验证签名或来源 IP，防止伪造支付通知。
未提供清晰支付指引：应在订单页标注“可在 Éxito、Alkosto 等门店支付”，提高完成率。
缺乏本地语言支持：支付页面、短信通知应使用西班牙语，避免误解。
未监控支付成功率：定期分析 abandoned cart 中选择 Efecty 但未完成的比例，优化流程。
误将 reference number 泄露给他人：每个 reference 唯一且可被他人代付，需加强用户身份绑定。
未与物流系统联动：应在收到 Webhook 后再触发发货，避免提前出库。
忽视争议处理机制：若用户称已付款但系统未记录，需保留日志并与服务商协同查证。
过度依赖单一本地支付方式：建议同时接入 Baloto、PSE 等互补方式，提升整体支付成功率。
未评估合规要求：哥伦比亚对跨境数字服务可能征收 IVA（增值税），需咨询税务顾问。

FAQ（常见问题）

Efecty现金收款API接入教程跨境卖家连锁门店收费标准靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚央行认可的支付网络，与多家银行和金融机构合作。通过正规支付服务商接入属于合法合规操作，但需确保自身业务符合当地税务与消费者保护法规。
适合哪些卖家/平台/地区/类目？
主要适合：
- 目标市场为哥伦比亚的跨境独立站或 Shopify 商家
- 销售电子配件、时尚服饰、家居用品等中低价商品
- 使用 dLocal、Checkout.com 等支持拉美本地支付的收单通道
不适用于禁运品类（如食品、药品、武器）或高退货率商品。
怎么开通/注册/接入/购买？需要哪些资料？
需通过支付服务商开通，流程包括：
- 提交企业营业执照、法人身份证
- 提供网站 URL 及产品描述
- 完成 KYC 审核
- 签署服务协议
- 获取 API 密钥并完成技术对接
个人卖家通常无法单独接入。
费用怎么计算？影响因素有哪些？
费用不由 Efecty 直收，而是由支付服务商定价，常见模式为：
- 按交易金额百分比 + 固定手续费
- 月费 + 交易阶梯费率
影响因素包括交易量、结算周期、是否含汇率服务、技术支持等级等，具体以服务商合同为准。
常见失败原因是什么？如何排查？
常见原因：
- 用户未在有效期内付款
- API 调用参数错误（如金额格式不符）
- Webhook 服务器不可达或未返回 200 状态码
- reference number 重复使用
排查方法：
- 检查日志中的 HTTP 响应码
- 验证 timestamp 与时区设置
- 测试沙箱环境全流程
- 联系服务商技术支持提供 transaction ID 查询。
使用/接入后遇到问题第一步做什么？
第一步应：
- 记录错误发生时间、订单号、API 请求与响应日志
- 检查服务商提供的状态面板或交易明细
- 查阅官方 API 文档确认调用规范
- 若属技术故障，联系服务商技术支持并附上 trace ID
切勿自行修改生产环境配置。
和替代方案相比优缺点是什么？
对比 Baloto：
- 优势：Efecty 门店密度更高，尤其在中小城市
- 劣势：Baloto 更早被电商平台采用，认知度略高
对比 PSE（网银转账）：
- 优势：Efecty 支持现金，无需银行卡
- 劣势：PSE 实时到账，Efecty 存在延迟
对比信用卡：
- 优势：覆盖无卡人群
- 劣势：不能即时确认支付，需等待门店同步。
新手最容易忽略的点是什么？
最易忽略：
- 未设置订单过期自动关闭机制
- 忽视 Webhook 安全验证导致虚假支付入账
- 缺少西班牙语版支付说明，造成用户困惑
- 未测试退款流程与对账逻辑
- 没有建立本地客服渠道应对支付咨询。