Efecty现金充值API接入教程商家Marketplace平台怎么申请

Efecty现金充值API接入教程商家Marketplace平台怎么申请

要点速读（TL;DR）

• Efecty 是哥伦比亚主流的线下现金支付方式，支持消费者通过便利店、ATM等渠道以现金完成线上交易。
• 接入 Efecty 现金充值 API 可让跨境商家在拉美市场（尤其是哥伦比亚）提升本地化支付覆盖率。
• 商家需通过支持 Efecty 的支付网关或收单机构间接接入，通常不支持直接对接 Efecty 官方 API。
• 申请流程包括：选择合规支付服务商、提交企业资质、技术对接测试、上线收款。
• 常见坑：未核实服务商是否真实支持 Efecty、忽略结算周期与汇率成本、未配置订单状态回调机制。
• 适合面向哥伦比亚消费者的中国跨境电商卖家，尤其是独立站或本地化运营的 Marketplace 卖家。

Efecty现金充值API接入教程商家Marketplace平台怎么申请 是什么

Efecty 是哥伦比亚领先的非银行支付网络，为无银行卡用户提供线下现金支付服务。用户在线下单后生成一个条码或参考号，前往 Efecty 合作网点（如 Baloto、Davivienda ATM、超市等）用现金付款，系统确认后订单生效。

现金充值API 指支付服务商提供的程序接口，允许电商平台或商家系统自动创建 Efecty 支付订单、获取付款码、接收支付成功通知。该 API 实现订单与支付系统的自动化对接。

商家 Marketplace 平台 指多商户入驻的电商平台（如 Mercado Libre、Linio 或自建平台），此类平台若想为入驻中国卖家提供本地支付能力，需集成 Efecty 作为支付选项。

它能解决哪些问题

• 痛点：哥伦比亚信用卡渗透率低（不足30%）→ 价值：覆盖超70%使用现金/预付方式的消费者。
• 痛点：国际卡拒付率高 → 价值：本地现金支付降低支付失败和争议风险。
• 痛点：独立站转化率低 → 价值：增加本地信任感，提升下单意愿。
• 痛点：平台类卖家无法收款本地支付 → 价值：Marketplace 可为卖家统一接入，实现本地化结算。
• 痛点：手动核销效率低 → 价值：API 自动回传支付状态，减少人工对账。
• 痛点：资金回款路径不透明 → 价值：通过正规支付通道结算至国内账户，合规可控。
• 痛点：缺乏支付凭证 → 价值：Efecty 提供官方交易记录，便于纠纷处理。
• 痛点：新市场进入门槛高 → 价值：具备本地支付是平台审核或用户增长的关键指标。

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

目前 Efecty 不对中国跨境商家开放直接注册或 API 对接权限。必须通过具备拉美本地收单能力的第三方支付服务商（Payment Service Provider, PSP）间接接入。以下是典型流程：

步骤 1：选择支持 Efecty 的支付服务商

常见支持 Efecty 的国际或区域型 PSP 包括：

• PayU Latam（已被 Rapyd 收购）
• DLocal
• Checkout.com（部分区域支持）
• Thunes（侧重汇款通道）
• 本地银行合作的网关（如 Bancolombia Gateway）

建议核实：该服务商是否在官网明确列出 Colombia + Efecty 支持，并提供 API 文档。

步骤 2：注册并提交企业资料

• 访问所选 PSP 官网，注册商业账户（Business/Merchant Account）。
• 准备以下材料：
  - 营业执照（中英文或公证翻译件）
  - 法人身份证或护照
  - 公司银行账户信息（用于结算）
  - 商城网址或 App 名称及功能说明
  - 预期月交易量与客单价
  - KYC 表格（由 PSP 提供）
• 提交后等待风控审核，通常 3-7 个工作日。

步骤 3：获取 API 接入权限

• 审核通过后，登录服务商后台，启用 Colombia 市场与 Efecty 支付方式。
• 申请 API Key、Secret Key 及环境地址（测试/生产）。
• 下载 Efecty 现金支付 API 接口文档，重点关注：
  - 创建支付订单（Create Cash Payment）
  - 查询支付状态（Query Transaction Status）
  - 异步通知回调（Webhook Setup）

步骤 4：技术对接与测试

• 开发人员根据 API 文档，在结账页面集成 Efecty 选项。
• 调用创建订单接口，返回 bar_code、reference_code 和 expiration_date。
• 前端展示付款二维码或参考号，并提示用户在指定时间内完成现金支付。
• 配置 Webhook 接收支付成功通知，自动更新订单状态。
• 使用沙箱环境完成至少 3 笔测试交易，验证全流程。

步骤 5：上线与监控

• 切换至生产环境，开启 Efecty 支付入口。
• 在 PSP 后台设置结算周期（T+1、T+3 或周结）。
• 定期检查交易成功率、退款率、回调延迟等指标。
• 保留原始交易日志，以备争议处理。

步骤 6：Marketplace 平台商家如何申请

• 若你是 Marketplace 上的第三方卖家，无需自行接入。
• 确认该平台是否已开通 Efecty 支付（可在结账页查看）。
• 联系平台运营或客服，申请开通本地支付收款权限。
• 提供营业执照、品类信息、预计销量等资料。
• 平台审核通过后，你的商品将自动支持 Efecty 用户下单。
• 结算由平台统一处理，注意查看分账规则与结算周期。

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

• 交易手续费率（按笔或按比例，不同 PSP 差异大）
• 结算币种（COP 哥伦比亚比索 vs USD 美元）
• 结算频率（高频结算可能增加成本）
• 月交易 volume（高交易量可协商费率）
• 是否含外汇兑换服务
• 是否有固定月费或接入费
• 拒付与退款处理费
• 技术支持等级（是否需要专属客户经理）
• 是否使用高级风控模块
• 合同签约主体（境内公司 or 境外子公司）

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

• 公司基本信息（名称、注册地、成立时间）
• 主营业务与销售品类
• 目标市场（是否仅哥伦比亚）
• 预估月交易笔数与金额
• 网站/App 流量数据
• 历史支付渠道使用情况
• 期望的结算周期与币种
• 技术对接方式（API / Hosted Page / Redirect）

常见坑与避坑清单

• 误以为可直连 Efecty：Efecty 不开放独立商户接入，必须通过认证 PSP。
• 忽略支付有效期：Efecty 订单通常 24-72 小时内有效，超时未付需重新生成。
• 未配置 Webhook 回调：导致订单状态无法自动更新，影响发货。
• 未测试沙箱环境：上线后出现签名错误或字段缺失。
• 忽视本地合规要求：哥伦比亚要求交易信息保留至少 5 年，需做好日志存储。
• 结算币种误解：部分服务商以 COP 结算，需自行换汇，存在汇率损失。
• 过度依赖单一通道：建议同时接入 Baloto、PSE 等其他本地支付方式。
• 未告知用户付款地点：应在支付成功页提示“可在 Davivienda、Éxito 等门店付款”。
• 未监控支付成功率：异常下降可能因 IP 被限、证书过期或接口变更。
• 合同条款未细读：注意冻结资金、争议处理责任归属等条款。

FAQ（常见问题）

1. Efecty现金充值API接入靠谱吗/正规吗/是否合规？
   是正规支付方式，Efecty 受哥伦比亚金融监管局 Superintendencia Financiera 监管。通过合规 PSP 接入即符合反洗钱与支付法规，资金路径可追溯。
2. Efecty现金充值API接入适合哪些卖家/平台/地区/类目？
   适合面向哥伦比亚消费者的企业，尤其是电子消费品、时尚服饰、家居用品类目。适用于独立站、SaaS 商城系统或本地化运营的 Marketplace 入驻商家。
3. Efecty现金充值API接入怎么开通/注册/接入/购买？需要哪些资料？
   需通过 PSP 注册商业账户，提交营业执照、法人身份证明、银行账户、网站信息及 KYC 表格。接入需开发资源完成 API 对接与测试。
4. Efecty现金充值API接入费用怎么计算？影响因素有哪些？
   费用由 PSP 制定，通常包含交易手续费、结算费、外汇费等。具体取决于交易量、币种、结算频率、合同谈判结果，需向服务商索取正式报价单。
5. Efecty现金充值API接入常见失败原因是什么？如何排查？
   常见原因：API 签名错误、IP 白名单未配置、参数缺失、证书过期、服务商系统维护。排查方法：检查请求日志、对照 API 文档、联系技术支持获取响应码解释。
6. 使用/接入后遇到问题第一步做什么？
   首先确认问题类型：支付未到账查交易 ID；接口报错看返回码；页面无法加载检查前端 JS。然后登录 PSP 后台查看交易详情，并联系其技术支持提供日志片段。
7. Efecty现金充值API接入和替代方案相比优缺点是什么？
   对比 Baloto：两者均为现金支付，Efecty 网点略少但稳定性较好；对比信用卡：Efecty 覆盖人群广但结算慢（需用户实际付款后才到账）；对比 PSE（网银转账）：Efecty 无需网银，更适合低收入群体。
8. 新手最容易忽略的点是什么？
   一是未设置支付到期提醒，导致库存被长期占用；二是未做多语言支付页面（应提供西班牙语说明）；三是忽视用户付款后的通知机制（短信/邮件提醒）。

相关关键词推荐

• Efecty 支付
• 哥伦比亚现金支付
• 拉美本地支付接入
• PayU Latam 接入指南
• DLocal API 文档
• Marketplace 本地支付解决方案
• 跨境支付 API 对接
• 独立站 Efecty 支持
• 现金支付订单回调
• 拉丁美洲电商支付方式
• Colombia online payment methods
• 非银行卡支付接入
• 跨境电商本地化支付
• 支付网关选择
• 跨境收款合规
• API 接口签名验证
• Webhook 支付通知
• 现金支付时效
• 商户 KYC 材料
• 支付成功率优化