Efecty现金充值接口文档商家Marketplace平台费率说明
2026-02-24 4
详情
报告
跨境服务
文章
Efecty现金充值接口文档商家Marketplace平台费率说明
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的现金支付网络，支持消费者在线下单后线下现金付款。
- 接入 Efecty现金充值接口 可帮助跨境商家拓展拉美市场，尤其覆盖无银行卡用户群体。
- 接口文档由支付网关或本地收单机构提供，包含API端点、签名规则、回调机制等技术细节。
- 商家需通过支持Efecty的支付服务提供商（PSP）完成技术对接与结算。
- Marketplace平台若集成Efecty，需明确平台费率结构：交易手续费、提现费、退款处理费等。
- 费率通常按笔收取或按比例+固定费组合计算，具体以签约PSP或平台政策为准。
Efecty现金充值接口文档商家Marketplace平台费率说明 是什么
“Efecty现金充值接口文档商家Marketplace平台费率说明”指跨境电商平台或支付服务商为接入哥伦比亚本地支付方式 Efecty 所提供的技术文档和商业条款说明。它涵盖两个核心部分：
- 技术侧：Efecty现金充值接口文档，用于系统对接生成付款码、查询支付状态、接收异步通知。
- 商业侧：商家在使用该支付方式时需承担的费用结构，常见于Marketplace平台对卖家的收费细则中。
关键词解释
- Efecty：哥伦比亚领先的非银行支付网络，用户可通过便利店、药店、超市等网点用现金完成线上订单支付。
- 现金充值接口：指支付网关提供的API接口，允许电商平台为买家生成唯一的Efecty付款凭证（如参考号），并实时追踪支付结果。
- 接口文档：由支付服务提供商（如PayU Latam、Redpagos、Dlocal等）提供，包含请求参数、加密方式、回调URL配置、错误代码表等开发所需信息。
- 商家Marketplace平台：指第三方电商平台（如Mercado Libre、Linio、Amazon Colombia等），在其上运营的中国卖家需遵守平台规定的支付接入流程与费用标准。
- 费率说明：平台或支付服务商向卖家收取的服务费用明细，包括交易手续费、提现费、争议处理费等。
它能解决哪些问题
- 拓展拉美市场：哥伦比亚约40%以上人口无信用卡，Efecty帮助商家触达依赖现金支付的消费人群。
- 提升转化率：提供本地化支付选项可降低购物车放弃率，尤其适用于高单价商品分期场景。
- 资金安全性增强：买家完成线下现金支付后，平台才确认收款，减少虚假交易风险。
- 合规结算路径：通过持牌PSP接入Efecty，确保跨境资金回流合法合规。
- 统一账务管理：接口支持自动对账，避免人工核销带来的延迟与误差。
- 平台入驻必备条件：部分拉美Marketplace要求卖家必须支持本地主流支付方式才能上线销售。
- 应对竞争压力：竞争对手已支持Efecty时，未接入将处于明显劣势。
- 优化用户体验：买家可在家附近任意Efecty网点完成支付，无需绑定银行卡或担心网络欺诈。
怎么用/怎么开通/怎么选择
步骤1：确认目标市场与平台要求
检查你计划销售的Marketplace平台是否支持Efecty，并查阅其卖家中心关于本地支付方式接入指南。
步骤2：选择支持Efecty的支付服务提供商（PSP）
常见国际PSP如：
- Dlocal
- PayU Latam
- PagSeguro（部分区域）
- Transbank Global
联系其商务或技术支持团队，获取Efecty接入能力确认函。
步骤3：申请商户账号与API权限
提交企业营业执照、法人身份证明、网站/App信息、预计交易量等资料完成KYC审核。
步骤4：获取Efecty现金充值接口文档
从PSP后台下载最新版API文档，重点关注：
- 创建Efecty支付会话的POST URL
- 必填参数：订单号、金额、币种、用户邮箱、返回链接
- 签名算法（如HMAC-SHA256）
- 异步通知（Webhook）配置方法
- 支付状态查询接口
步骤5：技术对接与测试
开发人员根据接口文档实现以下功能：
- 前端生成Efecty支付按钮
- 后端调用API创建支付订单
- 解析响应数据并展示付款参考号与截止时间
- 部署Webhook接收支付成功通知
- 在沙箱环境中完成全流程测试
步骤6：上线与监控
切换至生产环境，开启实时交易监控，定期核对结算报表与平台账单一致性。
费用/成本通常受哪些因素影响
- 月均交易笔数与总交易额（GMV）
- 单笔交易金额区间（小额高频 vs 大额低频）
- 是否使用PSP的一揽子解决方案（含收单、换汇、分账）
- 结算周期（T+7 vs T+15）
- 币种转换需求（COP→USD→CNY）
- 退款频率与争议处理复杂度
- 是否需额外投保交易资金险
- 平台层级（普通卖家 vs 品牌旗舰店）
- 合同谈判能力（大客户可争取阶梯费率）
- 是否存在隐性费用（如失败交易也计费）
为了拿到准确报价/成本，你通常需要准备以下信息：
- 公司注册地与主体类型（中国大陆/香港/离岸）
- 主要销售平台及站点（如Mercado Libre Colombia）
- 预估月交易单量与平均客单价
- 历史拒付率与客服响应时效
- 现有支付通道清单
- 是否已有当地实体公司或税务登记号（RUT）
常见坑与避坑清单
- 忽略付款有效期：Efecty付款码通常仅24-72小时有效，超时未付需重新发起，系统应自动释放库存。
- 未正确处理Webhook：未设置HTTPS回调地址或未验证签名可能导致订单状态不同步。
- 误读费率结构：以为只收交易手续费，实际还有提现费、货币转换费、每月固定服务费。
- 缺乏对账机制：未建立自动化对账流程，导致财务无法匹配平台结算单与PSP打款记录。
- 忽视本地合规要求：哥伦比亚要求电子发票包含特定字段，否则可能被认定为无效交易。
- 过度依赖单一PSP：一旦接口故障或风控拦截，所有Efecty订单中断，建议预留备用通道。
- 未做用户引导：买家不清楚如何在Efecty网点操作，导致支付失败率升高。
- 跳过沙箱测试：直接上线造成首单失败，影响店铺评分。
- 忽略语言适配：付款页面提示仍为英文，应提供西班牙语界面。
- 合同未明确SLA：未约定API可用性、故障响应时间、赔偿机制。
FAQ（常见问题）
- Efecty现金充值接口文档商家Marketplace平台费率说明靠谱吗/正规吗/是否合规？
只要通过持牌支付机构（如PayU Latam）接入，并遵循哥伦比亚金融监管局（Superintendencia Financiera de Colombia）相关规定，则属于合规支付渠道。建议核查PSP是否在当地有备案。 - 适合哪些卖家/平台/地区/类目？
主要适用于面向哥伦比亚消费者的中国跨境卖家，常见于电子产品、时尚服饰、家居用品类目；适用平台包括Mercado Libre、Linio、Amazon.co等支持Efecty的Marketplace。 - 怎么开通/注册/接入/购买？需要哪些资料？
需通过支持Efecty的PSP注册商户账户，一般需要：
- 企业营业执照（中英文公证件）
- 法人身份证或护照
- 公司银行账户证明
- 网站或App截图
- KYC表格填写
- 预计交易规模说明 - 费用怎么计算？影响因素有哪些？
费用通常由交易手续费（如3.5%-5%）+固定费（如COP 1,000-2,000/笔）构成，另可能收取提现费、月租费、汇率加价点差。具体取决于交易量、行业风险等级、结算周期等因素，以合同约定为准。 - 常见失败原因是什么？如何排查？
常见原因：
- 买家未在有效期内完成现金支付
- API签名错误导致订单创建失败
- Webhook未收到或未正确响应200状态码
- 买家输入参考号错误
排查建议：
检查日志中的HTTP响应码、比对签名逻辑、确认回调服务器可访问、查看PSP后台交易流水。 - 使用/接入后遇到问题第一步做什么？
立即登录PSP商户后台查看交易详情与错误代码，同时检查自身系统日志；若无法定位，截取完整请求/响应报文并联系PSP技术支持提交工单。 - 和替代方案相比优缺点是什么？
对比PSE网银转账：
优点：无需网银，覆盖更广人群；
缺点：到账慢（T+1）、需人工对账可能性高。
对比信用卡：
优点：降低拒付风险；
缺点：不能即时到账，影响发货效率。
对比Baloto（另一现金支付）：
两者覆盖率相近，但Efecty网点略多，费率差异小，通常需同时接入。 - 新手最容易忽略的点是什么？
一是忘记设置订单超时关闭逻辑，导致库存被长期锁定；二是未配置西班牙语支付指引，造成用户困惑；三是未阅读PSP的结算周期说明，误以为T+1到账，影响现金流规划。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业