Efecty现金收款API接入教程跨境卖家本地电商费率说明

Efecty现金收款API接入教程跨境卖家本地电商费率说明

要点速读（TL;DR）

• Efecty 是哥伦比亚主流的现金支付网络，支持消费者在线下单后线下现金付款，帮助跨境卖家提升本地转化率。
• 通过 API 接入 可实现订单与 Efecty 支付系统的自动同步，减少人工干预，提升结算效率。
• 主要适用于面向 哥伦比亚消费者 的跨境电商平台或独立站卖家。
• 收款资金通常以 COP（哥伦比亚比索） 结算，需通过合作收单机构或支付网关完成提现至人民币账户。
• 本地化支付方式可降低拒付率，但需注意 交易时效限制（如24-72小时未付款自动取消）。
• 费率结构非公开透明，通常由支付服务商报价，受交易量、风控等级、结算周期等因素影响。

Efecty现金收款API接入教程跨境卖家本地电商费率说明 是什么

Efecty 是哥伦比亚领先的非银行现金支付服务提供商，覆盖超过1万家线下网点（便利店、超市、药店等），允许用户在电商平台选择“Efecty”作为支付方式后生成付款码或账单，在指定时间内以现金完成支付。

API 接入 指通过技术接口将卖家的电商平台（如 Shopify、Magento 或自建站）与 Efecty 的支付系统对接，实现订单创建、状态更新、支付回调等流程自动化。

本地电商费率 指使用 Efecty 等本地支付方式时，支付服务商向卖家收取的服务费用，通常包含交易手续费、结算费、外汇转换费等，具体以合同约定为准。

关键名词解释

• Efecty：哥伦比亚本地现金支付渠道，类比墨西哥的 Oxxo、巴西的 Boleto Bancário。
• API 接口：应用程序编程接口，用于系统间数据交互，实现订单与支付状态实时同步。
• 收单机构（Acquirer）：负责处理本地支付请求并与 Efecty 合作的技术服务商，多数中国卖家需通过第三方支付网关间接接入。
• 结算周期：指从用户完成现金支付到资金到账卖家账户的时间，常见为 T+3 至 T+7 工作日。
• 拒付（Chargeback）：虽然现金支付不可逆，但若系统误判或重复扣款，仍可能引发争议。

它能解决哪些问题

• 痛点：哥伦比亚信用卡渗透率低（不足30%）→ 价值：支持现金支付显著提升成交转化率。
• 痛点：国际信用卡拒付率高 → 价值：现金预付模式几乎零拒付风险。
• 痛点：本地消费者信任度低 → 价值：使用本国熟悉的支付品牌增强购买信心。
• 痛点：订单需手动确认付款 → 价值：API 自动回传支付状态，减少运营人力成本。
• 痛点：资金回笼慢 → 价值：缩短对账周期，加快库存周转。
• 痛点：缺乏本地支付选项导致流失客户 → 价值：完善拉美市场本地化体验的关键一环。
• 痛点：汇率损失大 → 价值：部分服务商支持多币种结算对冲汇损。

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

步骤 1：确认业务适配性

p>检查目标市场是否为哥伦比亚，商品单价是否适合现金支付（建议低于 USD 500）。

步骤 2：选择支持 Efecty 的支付网关

p>目前 Efecty 不直接对中国卖家开放入驻，需通过以下类型服务商接入：

• 全球支付平台（如PagSeguro、Dlocal、Paddle、Checkout.com）
• 专注拉美的收单机构（如Conekta、Kushki、Mercado Pago）
• ERP 或 SaaS 工具集成方案（如Shopify Payments 加持第三方插件）

步骤 3：注册并申请开通 Efecty 渠道权限

p>在选定服务商后台提交企业资料，包括：

• 公司营业执照（中英文公证件）
• 法人身份证明
• 网站或店铺链接
• 月均交易额预估
• KYC 表格填写

审核周期通常为 3-10 个工作日。

步骤 4：获取 API 凭据并开发对接

p>服务商提供以下内容：

• API Key / Secret
• API 文档（含请求地址、参数说明、签名规则）
• Webhook 回调地址配置指引

技术团队需完成：

• 订单创建时调用 Efecty 创建支付链接
• 前端展示付款二维码或参考号
• 设置 Webhook 接收支付成功通知
• 更新订单状态为“已付款”

步骤 5：测试沙箱环境

p>使用服务商提供的测试账号和模拟流程验证全流程通畅性，确保：

• 订单能正确生成
• 回调通知可接收
• 异常情况（超时、取消）有处理机制

步骤 6：上线并监控交易

p>切换至生产环境后，定期查看：

• 支付成功率
• 回调失败率
• 结算明细与对账文件
• 客户投诉记录

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

• 月交易笔数与总金额（量大可议价）
• 商户所属行业类目（高风险类目费率更高）
• 结算货币（COP vs USD）及是否含换汇服务
• 结算频率（T+1 vs T+7）
• 是否使用托管账户或虚拟子账户
• 是否有反欺诈风控模块附加费
• 退款处理费（如有）
• API 调用次数超额费用（少数平台收取）
• 技术支持服务等级（基础支持 vs VIP）
• 合同签约主体所在地（离岸公司可能溢价）

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

• 预计月交易量（笔数与金额）
• 主营类目与 SKU 类型
• 目标国家与支付方式组合
• 现有支付渠道使用情况
• 是否已有当地注册实体
• 期望的结算周期与币种

常见坑与避坑清单

• 未设置有效 Webhook 导致漏单：务必配置 HTTPS 回调地址并启用重试机制。
• 忽略付款有效期：Efecty 订单通常 24-72 小时内有效，过期需重新生成，应在前端明确提示用户。
• 未做多语言提示：付款页面应显示西班牙语说明，避免消费者误解操作流程。
• 对账不及时：每日下载结算报表并与内部订单核对，防止资金差异。
• 选择无本地支持的服务商：优先选在拉美设有办公室或客服团队的供应商，便于应急沟通。
• 忽视合规要求：哥伦比亚税务部门可能要求保留交易日志至少5年，需确保数据存储符合当地法规。
• 过度依赖单一渠道：建议同时接入 Baloto 或 PSE 提升整体支付覆盖率。
• 未测试极端场景：如网络中断、重复回调、部分付款等情况下的系统响应逻辑。
• 跳过 KYC 预审：提前自查资质完整性，避免因材料不全延误上线。
• 未签订 SLA 协议：明确故障响应时间、赔付标准和服务保障条款。

FAQ（常见问题）

1. Efecty现金收款API接入教程跨境卖家本地电商费率说明靠谱吗/正规吗/是否合规？
   是的，Efecty 是哥伦比亚合法注册的支付网络，受 Superintendencia Financiera de Colombia 监管。通过正规支付网关接入属于合规路径，但需确保最终服务商具备相应牌照。
2. 适合哪些卖家/平台/地区/类目？
   主要适合：
   - 面向哥伦比亚市场的跨境电商（独立站为主）
   - 平台如 Shopify、WooCommerce、Magento
   - 类目建议为电子配件、时尚服饰、家居用品等中低价商品
   - 不适用于虚拟商品、博彩、成人用品等受限类目
3. 怎么开通/注册/接入/购买？需要哪些资料？
   需通过第三方支付服务商开通，常见资料包括：
   - 公司营业执照（翻译公证）
   - 法人身份证/护照
   - 商户网站或App信息
   - 银行账户信息（用于结算）
   - KYC 问卷填写
   具体以服务商要求为准。
4. 费用怎么计算？影响因素有哪些？
   无统一标准费率，通常按交易金额百分比 + 固定费收取，影响因素包括交易量、类目风险、结算周期、是否含换汇等。建议提供业务数据向多家服务商询价对比。
5. 常见失败原因是什么？如何排查？
   常见原因：
   - API 签名错误
   - 回调地址无法访问（防火墙阻挡）
   - 用户未在有效期内完成现金支付
   - 订单金额超出限额
   排查方法：
   - 查看 API 返回错误码
   - 检查服务器日志
   - 联系服务商技术支持提供交易ID追踪
6. 使用/接入后遇到问题第一步做什么？
   立即登录服务商后台查看交易详情与错误日志，并联系其技术支持团队提供以下信息：
   - 交易ID
   - 发生时间
   - 错误截图
   - 请求与响应原始数据（如有）
7. 和替代方案相比优缺点是什么？
   对比 Baloto：
   - 优势：Efecty 网点更密集，尤其在中小城市
   - 劣势：Baloto 支持更多电商平台原生集成
   对比信用卡：
   - 优势：现金支付转化率高、拒付率极低
   - 劣势：结算周期长、需本地化运营支持
8. 新手最容易忽略的点是什么？
   四大盲区：
   - 忽视付款时效提醒设计
   - 未配置自动取消未支付订单逻辑
   - 缺少西班牙语版支付指引
   - 未建立与本地物流的订单联动机制（如未付款不发货）

相关关键词推荐

• Dlocal 接入指南
• 拉美本地支付方式
• 哥伦比亚 Cash Payment API
• 独立站 Efecty 支付插件
• 跨境收款 结算周期
• Shopify 哥伦比亚支付
• 现金支付 跨境电商
• 收单机构 对比
• API 对接 文档
• KYB 审核 材料清单
• Webhook 回调配置
• 拒付率 降低方法
• 本地化支付 提升转化
• 货币兑换 成本控制
• 支付网关 选择标准
• 拉美市场 进入策略
• 跨境合规 数据留存
• ERP 系统 支付集成
• 多币种账户 开通
• 支付成功率 监控指标