Efecty现金充值接口文档商家Marketplace平台详细解析
2026-02-24 4
详情
报告
跨境服务
文章
Efecty现金充值接口文档商家Marketplace平台详细解析
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后通过线下网点现金付款。
- 接入 Efecty 现金充值接口 可帮助跨境商家拓展哥伦比亚市场，提升本地转化率。
- 接口需通过支持拉美支付的收单机构或支付网关（如 PPRO、dLocal、PagaTodo）间接集成。
- 商家需具备本地合规主体或通过 Marketplace 平台代收款资质方可使用。
- 资金结算周期通常为 T+5 至 T+14，具体以合作支付服务商合同为准。
- 用户完成现金支付后，系统需依赖支付网关回调通知确认到账状态。
Efecty现金充值接口文档商家Marketplace平台详细解析 是什么
Efecty 是哥伦比亚领先的非银行支付网络，覆盖超过 20,000 个线下现金支付点，包括便利店、超市和邮局等。消费者在电商平台选择 Efecty 支付后，系统生成唯一付款码（reference number），用户凭此码在任意 Efecty 合作网点以现金完成支付。
现金充值接口 指支付服务提供商（PSP）或 Marketplace 平台提供的 API 接口，用于创建 Efecty 支付订单、获取付款凭证、接收支付成功回调通知等功能。
商家 Marketplace 平台 指支持多卖家入驻的电商平台（如 Mercado Libre、Linio、Falabella Marketplace），其通常已集成 Efecty 支付方式，并为第三方卖家提供统一的资金结算服务。
关键名词解释
- API 接口：应用程序编程接口，用于系统间数据交互。Efecty 本身不直接开放 API 给普通商家，需通过支付网关调用。
- 支付网关：中介技术平台（如 dLocal、PagaTodo、Rapyd），聚合多种本地支付方式，向跨境商家提供标准化接入方案。
- 回调通知（Webhook）：支付成功后，支付网关主动向商家服务器发送交易状态更新，用于触发发货流程。
- 资金结算：指买家付款后，平台或支付方将扣除手续费后的金额划转至商家指定账户的过程。
- 本地合规主体：部分支付渠道要求收款方在哥伦比亚注册实体公司或拥有税务识别号（NIT）。
它能解决哪些问题
- 痛点：哥伦比亚信用卡渗透率低（不足30%）→ 提供现金支付选项显著提升订单转化率。
- 痛点：国际信用卡拒付率高→ 使用本地支付方式降低风控拦截概率。
- 痛点：缺乏本地收款资质→ 通过 Marketplace 或支付网关实现代收与分账。
- 痛点：支付验证延迟→ 接入 Webhook 实现自动化对账与订单状态同步。
- 痛点：客户因无法支付放弃购物车→ 增加 Efecty 显著延长有效支付窗口期（通常72小时）。
- 痛点：物流与支付信息不同步→ 支付成功后自动释放订单进入履约流程。
- 痛点：人工核销效率低→ 系统自动匹配付款记录与订单编号，减少客服介入。
- 痛点：跨境收款周期长→ 部分支付网关支持本地清分，缩短结算时间。
怎么用/怎么开通/怎么选择
一、确定接入路径
- 评估是否通过 Marketplace 入驻：若在 Mercado Libre Colombia 等平台开店，确认该平台是否已支持 Efecty 并自动为卖家开通。
- 若自建站或独立站销售，则需接入第三方支付网关（如 dLocal、PagaTodo、Rapyd、PPRO）。
- 联系支付服务商获取 Efecty 接入能力说明，确认其是否具备哥伦比亚本地清算合作资源。
二、准备必要材料
- 企业营业执照（中国或海外均可，视服务商要求）。
- 法人身份证明文件及联系方式。
- 网站域名、商品类目、预计月交易量。
- 银行账户信息（用于结算，可能需美元或COP账户）。
- 技术对接人邮箱与服务器IP白名单（用于API通信安全）。
三、技术对接流程
- 签署服务协议并开通商户账号。
- 获取测试环境 API Key 与文档链接。
- 开发人员根据接口文档构建支付请求参数（包含金额、币种COP、订单号、回调地址等）。
- 调用支付网关 API 创建 Efecty 订单，返回付款码与二维码。
- 前端展示付款信息页面，引导用户前往线下网点支付。
- 配置 Webhook 接收支付成功通知，更新订单状态。
- 定期下载结算报表进行财务对账。
注意：Efecty 不支持退款原路返回现金，需通过银行转账或其他方式退还给消费者，具体流程由支付服务商制定。
费用/成本通常受哪些因素影响
- 交易手续费率（按笔或按比例，通常 3%-6%，取决于行业风险等级）
- 是否使用本地清分通道（本地清分可节省外汇转换费）
- 结算币种（COP 结算 vs USD 结算涉及汇率损益）
- 月交易 volume（高交易量可协商费率折扣）
- 技术支持等级（是否需要定制开发或专属客服）
- 是否存在拒付争议处理附加费
- 是否需额外购买防欺诈模块
- 平台佣金（若通过 Marketplace 销售，还需支付平台分成）
- 提现频率（频繁提现可能产生固定手续费）
- 合同签约主体所在国家（影响税务扣缴条款）
为了拿到准确报价，你通常需要准备以下信息：
- 目标市场（仅哥伦比亚还是覆盖多个拉美国家）
- 预估月交易笔数与总金额
- 主营类目（如电子产品、时尚服饰、健康美容等）
- 现有技术架构（是否使用 Shopify、Magento、自研系统等）
- 期望结算周期（T+1、T+7 或更长）
- 是否已有支付网关合作
常见坑与避坑清单
- 误以为 Efecty 支持即时到账：实际支付网点上传数据有延迟，建议设置订单保留时间为 24-72 小时。
- 未配置 Webhook 导致漏单：必须启用异步通知机制，不能仅依赖后台手动查询。
- 忽略付款码有效期：多数系统设定付款码 24-72 小时失效，超时需重新生成订单。
- 未做 IP 白名单限制：确保支付网关回调来源可信，防止伪造通知。
- 未测试沙箱环境即上线：务必在测试环境中完整走通支付、回调、退款流程。
- 忽视本地合规要求：某些服务商要求 NIT 或当地公司才能收款，提前确认资质门槛。
- 未明确退款责任方：与支付服务商书面约定退款操作流程与时效。
- 过度依赖单一支付通道：建议同时接入 Baloto、PSE 等其他哥伦比亚主流支付方式。
- 未监控支付成功率：定期分析失败原因（如参数错误、签名异常）并优化接口逻辑。
- 忽略语言适配：付款页面提示应使用西班牙语，避免用户误解操作步骤。
FAQ（常见问题）
- Efecty现金充值接口文档商家Marketplace平台详细解析 靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚央行认可的支付服务机构，合法运营多年。但商家需通过正规支付网关或合规 Marketplace 使用，避免使用非授权代理渠道。 - Efecty现金充值接口文档商家Marketplace平台详细解析 适合哪些卖家/平台/地区/类目？
主要适用于面向哥伦比亚消费者的跨境卖家；适合自建站、独立站及接入 Mercado Libre、Linio 等本地化程度高的 Marketplace；高频适用类目包括消费电子、家居用品、服装鞋包等。 - Efecty现金充值接口文档商家Marketplace平台详细解析 怎么开通/注册/接入/购买？需要哪些资料？
需通过支付网关或 Marketplace 提交企业资料申请商户账号，常见所需材料包括营业执照、法人身份证、网站信息、银行账户、技术对接人信息等，具体以服务商要求为准。 - Efecty现金充值接口文档商家Marketplace平台详细解析 费用怎么计算？影响因素有哪些？
费用通常包含交易手续费（3%-6%）、结算费、提现费等，影响因素包括交易量、类目风险、结算币种、是否本地清分、合同谈判能力等，需索取正式报价单确认。 - Efecty现金充值接口文档商家Marketplace平台详细解析 常见失败原因是什么？如何排查？
常见原因包括：API 签名错误、回调地址不可达、参数缺失、订单重复提交、用户未在有效期内完成现金支付。建议查看支付网关日志、测试沙箱响应码、检查服务器防火墙设置。 - 使用/接入后遇到问题第一步做什么？
首先确认问题类型：若是支付失败，检查前端报错代码并与支付网关技术支持联系；若是资金未到账，核对结算周期并导出交易明细比对；若是回调未收到，检查 Webhook 地址是否可访问并查看服务器日志。 - Efecty现金充值接口文档商家Marketplace平台详细解析 和替代方案相比优缺点是什么？
对比 Baloto：两者均为现金支付，覆盖率相似，Efecty 在城市便利店更密集；对比 PSE（网银转账）：Efecty 无需网银，更适合无银行账户人群；对比信用卡：Efecty 转化率更高但结算慢。建议组合使用。 - 新手最容易忽略的点是什么？
新手常忽略三点：一是未设置合理的订单保留时间导致用户错过支付；二是未启用 Webhook 自动化处理支付通知；三是未了解退款只能通过非现金方式返还，引发客诉。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业