Efecty现金收款接口文档跨境卖家SaaS平台费率说明

Efecty现金收款接口文档跨境卖家SaaS平台费率说明

要点速读（TL;DR）

• Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后线下现金付款，适合无银行卡用户。
• 跨境卖家通过SaaS平台或支付网关接入 Efecty 接口，实现本地化收款，提升南美市场转化率。
• 需查阅官方 接口文档 完成技术对接，包括订单创建、状态回调、对账等流程。
• 费率说明 通常包含交易手续费、结算周期、失败处理费等，具体以服务商合同为准。
• 主要适用对象：面向哥伦比亚市场的独立站或电商平台卖家，尤其是高单价、货到付款替代场景。
• 常见坑：回调验证缺失、订单超时未支付、对账不一致、KYC材料不全导致结算延迟。

Efecty现金收款接口文档跨境卖家SaaS平台费率说明 是什么

Efecty 是哥伦比亚领先的非银行支付网络，覆盖超 2 万家线下网点（便利店、超市、药店等），用户可在线生成支付单，线下用现金完成付款。该服务广泛用于水电费、电信账单和电商交易。

现金收款接口文档 指 Efecty 或其授权支付网关（如 PagoFacil、PayU Latam、Dlocal 等）提供的 API 技术文档，说明如何集成 Efecty 支付方式至卖家系统或 SaaS 平台。

跨境卖家SaaS平台 指为出海企业提供一站式服务的软件系统（如 ShopBase、Ecwid、OpenCart 插件等），部分已预集成 Efecty，支持一键启用。

费率说明 指使用 Efecty 收款所需支付的成本结构，通常由支付服务商提供，包含交易费、提现费、汇率加价等明细。

关键名词解释

• API 接口：应用程序编程接口，用于系统间数据交互，如创建支付单、接收支付成功通知。
• 回调（Webhook）：支付完成后，Efecty 或中间网关向卖家服务器发送支付状态更新请求。
• SaaS 平台：Software-as-a-Service，即软件即服务，跨境卖家常用的一体化建站与运营工具。
• KYC：Know Your Customer，反洗钱要求下的身份验证流程，通常需提交营业执照、法人身份证、店铺链接等。
• 本地支付方式：指目标市场主流的非国际卡支付手段，如拉美的 Efecty、OXXO、Boleto，东南亚的便利店支付等。

它能解决哪些问题

• 痛点：哥伦比亚信用卡渗透率低（不足30%），大量消费者无法使用 Visa/Mastercard 在线支付。
  价值：接入 Efecty 可触达更广泛的现金用户群体，提升订单转化率。
• 痛点：独立站缺乏本地支付选项，购物车放弃率高。
  价值：增加 Efecty 显著降低支付摩擦，提升用户体验。
• 痛点：传统货到付款（COD）物流成本高、拒收率高。
  价值：Efecty 实现“先付后发”，降低资金与物流风险。
• 痛点：跨境支付成功率低，受银行风控拦截。
  价值：本地化支付路径绕过国际清算限制，提高支付成功率。
• 痛点：手动对账效率低、易出错。
  价值：通过接口自动同步支付状态，实现订单系统自动标记已付款。
• 痛点：缺乏支付确认凭证。
  价值：Efecty 提供唯一支付编号（reference number），可用于客服核验。

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

一、选择接入方式

1. 通过 SaaS 建站平台直接启用：若使用 ShopBase、Tiendanube、Nuvemshop 等拉美友好平台，可在支付设置中查找 Efecty 并开启（可能需切换地区为哥伦比亚）。
2. 通过第三方支付网关接入：选择支持 Efecty 的全球支付服务商（如 Dlocal、PayU Latam、Paddle、Rapyd），注册商户账户并申请开通 Efecty 支付渠道。
3. 自研系统对接 API：适用于有技术团队的中大型卖家，需获取 Efecty 官方或代理网关的 接口文档，开发支付创建与回调逻辑。

二、开通流程（以支付网关为例）

1. 注册支付服务商商户账号，填写公司信息、网站域名、预计交易量。
2. 提交 KYC 材料（企业营业执照、法人身份证、银行账户信息、店铺页面截图等）。
3. 申请开通哥伦比亚市场及 Efecty 支付方式（部分需单独审批）。
4. 获取 API Key、Secret 和测试环境接入地址。
5. 根据 接口文档 开发以下功能：
   • 创建支付订单（含金额、币种 COP、用户信息、callback URL）
   • 接收并验证 Webhook 回调（注意签名验证）
   • 查询订单状态（用于异常处理）
6. 在沙箱环境完成测试支付流程，确认回调正常触发。
7. 提交上线申请，切换至生产环境。

三、SaaS平台用户特别提示

• 确认所用 SaaS 是否原生支持 Efecty，或需安装插件。
• 检查是否支持多语言支付页（西班牙语优先）。
• 查看平台是否代管对账文件导出、结算报表等功能。

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

• 月均交易 volume（交易笔数与总额）
• 单笔交易金额区间（小额高频 vs 大额低频）
• 是否为新商户（初期可能费率较高）
• 所属行业类目（高风险类目如电子烟、成人用品可能被拒或加价）
• 结算币种（COP 本地结算 vs USD 跨境结算）
• 结算频率（T+7、T+14 或按周结算）
• 是否使用综合支付服务商（打包价含汇率加点）
• 是否有退款/争议处理需求（部分收取争议费）
• 技术对接方式（SaaS 内置可能含平台服务费）
• 是否需要发票或合规凭证（部分服务商额外收费）

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

• 公司注册地与运营主体
• 目标市场（哥伦比亚为主？）
• 月均交易笔数与GMV预估
• 主要销售类目
• 网站或App流量来源
• 是否已有支付服务商
• 期望结算周期与币种

常见坑与避坑清单

1. 未设置有效回调地址：导致支付成功但订单不自动发货。务必配置 HTTPS 回调 URL 并记录日志。
2. 忽略签名验证：伪造回调可能导致虚假发货。必须按接口文档验证回调签名（signature）。
3. 未处理超时未支付：Efecty 订单通常有效期 24-72 小时。需设置定时任务清理过期订单。
4. KYC 材料不完整：如缺少西班牙语翻译件、银行对账单过期，导致审核延迟。建议提前准备双语材料。
5. 汇率锁定机制不清：部分服务商在支付时锁定汇率，部分在结算时换汇，差异可能影响利润。需明确条款。
6. 对账文件格式不兼容：CSV 对账文件字段可能变化，建议定期校验字段映射关系。
7. 未监控支付成功率：应设置仪表盘跟踪 Efecty 支付转化率、失败原因分布。
8. 忽视用户指引：未在支付页清晰说明“如何线下付款”，导致用户不知操作流程。建议嵌入图文指南。
9. 使用测试密钥上线：常见低级错误，确保生产环境使用正式 API Key。
10. 未保留支付凭证：用户纠纷时无法提供 reference number 和支付时间戳，影响裁决结果。

FAQ（常见问题）

1. Efecty现金收款接口文档跨境卖家SaaS平台费率说明 靠谱吗/正规吗/是否合规？
   Efecty 是哥伦比亚合法注册的支付网络，受 Superintendencia Financiera de Colombia 监管。通过正规支付网关接入并完成 KYC 的交易属于合规路径，资金流可追溯。
2. 适合哪些卖家/平台/地区/类目？
   主要适用于：
   • 目标市场为哥伦比亚的独立站或第三方平台卖家
   • 使用支持 Efecty 的 SaaS 建站系统（如 Tiendanube、Shopify+第三方网关）
   • 销售中低价商品（5万-50万 COP）、追求高转化的品类（如时尚、小家电、美妆）
   高风险类目（如虚拟货币、赌博相关）通常不被支持。
3. 怎么开通/注册/接入/购买？需要哪些资料？
   流程：
   ① 选择支付服务商（如 Dlocal、PayU）注册商户账户
   ② 提交企业营业执照、法人身份证、银行账户证明、网站/App 截图
   ③ 申请开通 Efecty 支付方式
   ④ 获取 API 文档并完成技术对接
   ⑤ 测试通过后上线
   具体材料以服务商要求为准，部分需公证或翻译。
4. 费用怎么计算？影响因素有哪些？
   费用结构通常包括：
   • 交易手续费（按百分比 + 固定费）
   • 结算手续费（COP 出金）
   • 汇率加价（若换汇为 USD）
   • 失败交易是否收费（如超时未付）
   具体费率取决于交易量、行业、合作模式，需与服务商谈判确定。
5. 常见失败原因是什么？如何排查？
   常见原因：
   • 用户未在有效期内完成现金支付
   • 回调未送达（服务器防火墙阻挡）
   • 签名验证失败（时钟不同步或算法错误）
   • 订单金额与系统记录不符
   • KYC 审核未通过导致交易拒绝
   排查步骤：
   ① 查看支付网关后台交易日志
   ② 检查 Webhook 是否收到且返回 200 状态码
   ③ 核对 API 请求参数是否符合文档规范
   ④ 联系服务商技术支持提供 reference ID 查询。
6. 使用/接入后遇到问题第一步做什么？
   第一步：登录支付服务商后台查看交易详情与错误代码；第二步：检查本地系统日志，确认请求与回调是否正常；第三步：若无法定位，收集 timestamp、order_id、reference number 提交工单给服务商支持团队。
7. 和替代方案相比优缺点是什么？
   对比 Baloto：
   • 优点：Efecty 网点更多（尤其在中小城市），支付流程更快
   • 缺点：两者费率相近，Baloto 品牌认知度略高
   对比信用卡：
   • 优点：覆盖无卡人群，降低支付门槛
   • 缺点：到账慢（通常 T+1 至 T+3），存在用户不履约风险
   对比 COD：
   • 优点：先付款后发货，避免拒收损失
   • 缺点：需技术支持对接，初始接入成本高
8. 新手最容易忽略的点是什么？
   ① 忽视 回调安全性验证，仅依赖前端跳转判断支付状态；
   ② 未设置 订单超时自动关闭 机制；
   ③ 未保存 支付 reference 编号 用于售后核验；
   ④ 以为“上线即生效”，未进行充分沙箱测试；
   ⑤ 忽略本地化体验，如未提供西班牙语支付说明。

相关关键词推荐

• Efecty 支付接入
• 哥伦比亚本地支付方式
• 拉美现金支付解决方案
• 跨境支付 API 文档
• Dlocal 接口集成
• PayU Latam 商户注册
• 独立站本地化收款
• ShopBase 支付设置
• 现金支付转化率优化
• 跨境电商 KYC 材料
• Webhook 回调验证
• 南美电商支付习惯
• 非信用卡支付渠道
• 跨境收款费率对比
• 支付接口沙箱测试
• 订单状态同步机制
• 拉美电商市场准入
• 本地支付网关选择
• 跨境支付对账流程
• 高风险类目支付限制