Efecty现金收款对接流程开发者连锁门店全面指南

Efecty现金收款对接流程开发者连锁门店全面指南

要点速读（TL;DR）

• Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后在实体网点用现金付款。
• 适合面向哥伦比亚本地消费者销售的跨境卖家或本地化运营商家。
• 接入需通过支持 Efecty 的第三方支付网关（如 PayU Latam、Mercado Pago 等），不支持直接对接。
• 开发者需完成 API 集成，生成有效票据编号（reference code），供用户线下支付使用。
• 资金结算周期通常为 T+3 到 T+7 工作日，具体以支付服务商合同为准。
• 关键避坑点：确保订单状态同步准确、票据有效期设置合理、退款流程合规。

Efecty现金收款对接流程开发者连锁门店全面指南 是什么

Efecty 是哥伦比亚领先的非银行现金收单网络，覆盖超过 20,000 家线下合作门店（包括 Droguería Simi、Alkosto、Éxito 等连锁零售点），为无银行卡或不愿在线输卡信息的用户提供“线上下单 + 线下现金支付”服务。

关键词解释

• 现金收款：指买家不通过电子方式支付，而是在实体网点以现金完成交易确认。
• 对接流程：指电商平台或系统开发者将 Efecty 支付选项集成至结账页面的技术实现路径。
• 开发者：负责技术对接的工程师或技术团队，需处理 API 调用、回调通知、错误处理等逻辑。
• 连锁门店：Efecty 合作的零售网络，消费者可凭系统生成的参考码在此类门店完成现金支付。

它能解决哪些问题

• 转化率低 → 哥伦比亚约 60% 成年人无国际信用卡，提供现金支付可显著提升成交率。
• 支付信任不足 → 消费者更愿意在熟悉的便利店完成现金交易，降低弃单率。
• 拒付风险高 → 现金支付即刻到账确认，避免信用卡拒付（Chargeback）问题。
• 物流前置验证难 → 支付完成后才触发发货，减少无效配送成本。
• 本地化体验差 → 缺少本地常用支付方式会影响平台可信度和复购意愿。
• 清关与税务合规 → 正规支付渠道有助于留存交易凭证，满足当地财税要求。

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

由于 Efecty 不向独立站或中小卖家开放直接接入权限，必须通过已签约的支付服务提供商（PSP）间接集成。以下是典型技术对接流程：

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

常见支持 Efecty 的平台包括：

• PayU Latam（Red Pagos）
• Mercado Pago（部分区域）
• DLocal（为跨境企业提供的多国支付聚合方案）
• Clip（适用于拉美市场的支付中间件）

建议优先选择已在哥伦比亚市场有稳定运营记录的服务商。

步骤 2：注册并开通商户账户

• 提交公司营业执照、法人身份证明、网站/APP 信息、预计交易量等资料。
• 签署服务协议，明确结算周期、手续费结构、争议处理机制。
• 获取商户 ID（merchantId）、API 密钥（apiKey）、安全盐值（apiSecret）等认证参数。

步骤 3：开发环境配置

• 申请沙箱环境（Sandbox）账号用于测试。
• 下载官方 SDK 或查阅 API 文档（通常为 RESTful 接口，JSON 格式通信）。
• 配置服务器 IP 白名单（如需要）及 HTTPS 回调地址（notification URL）。

步骤 4：发起支付请求（创建票据）

• 用户下单选择 Efecty 支付方式后，前端调用后端接口。
• 后端构造请求体发送至 PSP 的 /payments 接口，包含金额、货币（COP）、商品描述、外部订单号、支付方式标识（如 efecty）。
• 成功响应返回：referenceCode（客户付款码）、paymentUrl（跳转打印页）、expirationDate（截止时间，通常 3 天内）。

步骤 5：展示支付信息给买家

• 将 referenceCode 和二维码显示在订单确认页。
• 提供 PDF 下载链接或提示前往 Efecty 官网查询网点。
• 建议提示：“请在 72 小时内完成支付，逾期订单自动取消”。

步骤 6：处理支付结果与对账

• PSP 在收到 Efecty 支付确认后，向你的 notification URL 发送异步回调（POST 请求）。
• 验证签名有效性，更新订单状态为“已支付”。
• 每日定时拉取结算报表（Settlement Report），核对入账金额与订单一致性。
• 未支付订单超过有效期应自动关闭，并释放库存。

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

• 月均交易笔数与总流水规模
• 是否为新入驻商户（初期费率可能较高）
• 所选支付网关的品牌溢价（如 DLocal vs 本地 PSP）
• 结算币种（COP 本币结算 vs USD 结算）
• 是否有反欺诈风控附加服务
• 是否使用高级 API 功能（如分账、延迟结算）
• 退款频率与争议处理成本分摊条款
• 是否需要定制化开发支持
• 合同谈判能力与商务关系
• 是否存在最低月费或固定通道费

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

• 公司注册地与运营主体国家
• 目标市场（仅哥伦比亚 or 多国）
• 预计首年 GMV 与平均客单价
• 销售平台类型（独立站 / Marketplace / APP）
• 技术支持能力（能否自主对接 API）
• 历史支付数据（如有）

常见坑与避坑清单

1. 未设置合理的票据过期时间 → 导致长期占用库存，建议设为 72 小时。
2. 忽略异步通知验签 → 可能被伪造回调导致虚假发货，务必验证 HMAC-SHA256 签名。
3. 未监控支付成功率 → 若低于行业平均水平（约 65%-75%），应及时优化 UI 提示或更换渠道。
4. 手动对账耗时易错 → 建议自动化拉取每日结算文件并与内部订单匹配。
5. 未告知用户最近网点 → 应集成 Efecty 网点查询工具或提供地图指引。
6. 退款流程不透明 → 现金支付退款需原路退回至 Efecty 账户再提现，不能直接返现，须提前说明。
7. 未做异常状态兜底 → 如网络超时导致重复生成 referenceCode，应设计幂等机制。
8. 忽视语言本地化 → 支付页面需全西语呈现，避免混用英文术语。

FAQ（常见问题）

1. Efecty 现金收款靠谱吗？是否合规？
   是的，Efecty 是哥伦比亚金融监管局（Superintendencia Financiera de Colombia）许可的支付机构，所有交易受央行监管，资金流向可追溯，符合当地反洗钱规定。
2. 适合哪些卖家/平台/地区/类目？
   主要适用于：
   - 目标市场为哥伦比亚的跨境电商（尤其是独立站）
   - 销售电子产品、家电、时尚服饰等中高单价商品
   - 平台类型：Shopify、Magento、自研系统等可通过 API 接入的场景
   - 不适合纯 B2B 批发或高频率小额交易场景
3. 怎么开通 Efecty 接入？需要哪些资料？
   无法直接开通，必须通过第三方支付网关（如 PayU、DLocal）。所需材料通常包括：
   - 公司营业执照（中英文公证件）
   - 法人护照或身份证
   - 商户网站或 App 截图
   - 银行账户信息（用于结算）
   - KYC 表格填写（由 PSP 提供）
4. 费用怎么计算？影响因素有哪些？
   费用由支付服务商收取，一般包含：
   - 交易手续费（按百分比）
   - 固定每笔费用（COP 计价）
   - 结算费或外汇转换费（如 USD→COP）
   具体费率取决于商户资质、流水规模和合同约定，以实际合同为准。
5. 常见失败原因是什么？如何排查？
   常见原因：
   - 用户未在有效期内完成支付 → 检查 expirationDate 设置
   - referenceCode 重复生成 → 检查订单唯一性约束
   - 回调地址不可达 → 查看服务器日志是否接收 POST 请求
   - 签名验证失败 → 对照文档检查 apiSecret 使用方式
   - 网络超时导致状态不一致 → 增加重试机制与人工对账流程
6. 使用/接入后遇到问题第一步做什么？
   第一步应：
   1. 查看 PSP 提供的交易详情页或日志面板
   2. 获取 transactionId 和 referenceCode
   3. 联系支付服务商技术支持，提供完整请求/响应报文
   4. 若涉及用户投诉，暂勿发货并标记订单待核实
7. Efecty 和其他现金支付方式相比优缺点是什么？
   对比 Baloto：
   优点：Efecty 网点更密集（尤其在二三线城市），操作流程更简化。
   缺点：部分 PSP 对 Efecty 支持弱于 Baloto，集成文档较少。
   对比 PSE（网银转账）：
   优点：无需网银，适合无银行账户人群。
   缺点：支付确认延迟（T+1 才能到账），无法即时发货。
8. 新手最容易忽略的点是什么？
   最常忽略：
   - 忽视票据过期后的库存释放机制
   - 未在前端清晰展示支付指引（如“去 Simi 门店付现金”）
   - 缺少西语客服支持，用户支付出错无法及时解决
   - 未设置自动取消未支付订单的工作流

相关关键词推荐

• Efecty 支付接入
• 哥伦比亚现金支付
• 拉美跨境收款
• PayU Latam 接口文档
• DLocal Efecty 集成
• 独立站本地支付方式
• Latam 支付解决方案
• 海外订单现金支付
• 跨境支付 API 对接
• 南美电商支付习惯
• Shopify 哥伦比亚支付
• Red Pagos 收款网络
• 现金支付订单管理
• 跨境退款流程设计
• 本地化支付用户体验
• 拒付风险控制
• 多币种结算系统
• 支付网关选择指南
• 拉丁美洲金融科技
• 跨境电商合规支付