Efecty现金充值接口文档商家独立站收费标准

2026-02-24 4

详情

报告

跨境服务

文章

Efecty现金充值接口文档商家独立站收费标准

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，允许消费者在无银行卡情况下通过线下网点完成付款。
接入 Efecty 现金充值接口 可提升独立站在拉美市场的转化率，尤其适合中低价商品。
接口文档由支付网关或收单机构提供，通常包含API端点、参数说明、回调机制和测试沙箱地址。
商家独立站需通过第三方支付服务商（如Paddle、dLocal、Checkout.com等）集成Efecty，原生直连不开放。
收费结构多为交易手续费+固定费，费率受月交易量、风控等级、结算周期影响。
合规重点：需满足当地反洗钱要求，交易信息须完整可追溯，退款流程需明确。

Efecty现金充值接口文档商家独立站收费标准是什么

Efecty现金充值接口文档 是指支持商家在其独立站中接入Efecty支付方式的技术文档，包含API调用规则、数据格式、身份验证方式、支付流程时序图、异步通知机制等内容。该接口允许消费者下单后生成一个条形码或数字码，在Efecty合作网点以现金完成支付。

关键名词解释：

Efecty：哥伦比亚本地流行的非银行卡支付渠道，覆盖超1万家线下代理点，用户可在Almacén、D1、Éxito等零售店完成现金支付。
现金充值接口：一种预付式支付接入方式，用户先下单生成待支付订单，再凭凭证到指定网点缴费，资金到账后订单生效。
接口文档：由支付服务提供商提供的技术说明书，指导开发者如何调用Efecty支付API，实现订单创建、状态查询、回调处理等功能。
独立站：指卖家自主搭建的电商网站（如Shopify、Magento、自研系统），不依赖Amazon、Mercado Libre等第三方平台。
收费标准：指使用Efecty支付通道所产生的费用结构，通常包括交易手续费、固定费用、货币转换费、退款处理费等。

它能解决哪些问题

痛点：拉美消费者银行卡渗透率低 → 价值：Efecty支持现金支付，扩大无卡人群覆盖。
痛点：跨境支付信任度不足 → 价值：本地化支付方式增强购买信心，降低弃单率。
痛点：独立站支付方式单一 → 价值：增加Efecty显著提升结账页转化率。
痛点：订单无法实时确认 → 价值：通过Webhook回调自动同步支付状态，减少人工对账。
痛点：资金回款慢 → 价值：部分服务商支持T+2~T+5结算，优于传统银行电汇。
痛点：拒付风险高 → 价值：现金支付不可撤销，基本无信用卡拒付（Chargeback）风险。
痛点：本地合规门槛高 → 价值：通过持牌支付服务商间接合规接入，降低自建资质难度。

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

接入Efecty现金充值接口的典型步骤

选择支持Efecty的支付服务商：确认其在官网或文档中明确列出Efecty为可用支付方式（如dLocal、PagaTodo、Checkout.com、Rapyd等）。
注册商户账户：提交公司营业执照、法人身份证、银行账户、网站域名、SKU示例等资料完成KYC审核。
获取API密钥与接口文档：登录服务商后台，进入“开发者中心”下载最新版Efecty集成文档。
开发对接：按照文档实现以下功能：
- 创建支付会话（含金额、币种、用户信息）
- 接收异步通知（Webhook）
- 查询订单状态
- 处理退款请求
沙箱测试：使用测试环境模拟完整支付流程，验证条形码生成、网点支付模拟、状态更新等环节。
上线审批与生产环境切换：提交上线申请，部分服务商要求提供测试报告或流量预估。

注意：Efecty本身不直接向境外商家开放API，必须通过具备本地收单能力的中间支付网关接入。

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

月均交易笔数与总交易额（volume-based pricing）
是否为新签约商户（初期可能有优惠费率）
结算币种（COP vs USD）及是否含货币转换服务
结算周期（T+1/T+7 影响资金占用成本）
是否使用增值服务（如防欺诈系统、多语言客服）
退款频率与处理复杂度
商户所属行业类目（高风险类目费率更高）
合同谈判能力（大卖家可议价）
支付服务商定价模型（阶梯制/统一费率）
是否有隐藏费用（如月费、调单费、提现失败费）

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

预计月交易量（笔数与GMV）
目标国家（仅哥伦比亚 or 多国）
网站类型（独立站/APP/小程序）
主要销售类目
希望的结算周期与币种
现有支付方式配置情况

常见坑与避坑清单

误以为可直连Efecty：实际必须通过第三方支付网关，避免浪费时间联系Efecty官方。
忽略Webhook安全性：未校验签名可能导致虚假支付通知触发发货。
未设置订单有效期：Efecty支付码通常24-72小时过期，超时应自动取消订单。
缺少西班牙语提示：支付页面、短信通知应本地化，否则影响用户体验。
未监控支付成功率：定期分析失败原因（如参数错误、超时），及时优化接口逻辑。
忽视退款政策差异：Efecty退款不能原路退回现金，需通过银行转账或其他方式返还，流程更长。
跳过沙箱测试：直接上线易导致订单丢失或重复发货。
合同未明确费率细节：确认是否含附加费、最低月费、提前解约条款。
未备案IP白名单：部分服务商要求将服务器IP加入白名单才能调用API。
忽略GDPR/本地数据合规：传输用户信息时需符合哥伦比亚《数据保护法》（Law 1581/2012）。

FAQ（常见问题）

Efecty现金充值接口靠谱吗/正规吗/是否合规？
是正规支付方式。Efecty受哥伦比亚金融监管局（Superintendencia Financiera de Colombia）监督，通过持牌支付网关接入即合规。建议选择PCI DSS认证的服务商。
Efecty现金充值接口适合哪些卖家/平台/地区/类目？
适合面向哥伦比亚消费者的独立站卖家，尤其是中低价商品（$10-$100）、电子产品配件、时尚服饰、健康美容等类目。不适合B2B大额交易或需即时到账的场景。
Efecty现金充值接口怎么开通/注册/接入/购买？需要哪些资料？
需通过支持Efecty的支付服务商开通。常见资料包括：企业营业执照、法人身份证明、银行开户证明、网站URL、产品截图、月交易预估。个人卖家通常无法接入。
Efecty现金充值接口费用怎么计算？影响因素有哪些？
费用一般由交易手续费% + 固定费（COP）构成，可能另加货币转换费。影响因素包括交易量、类目风险、结算周期、服务商定价策略。具体以合同为准。
Efecty现金充值接口常见失败原因是什么？如何排查？
常见原因：参数缺失/格式错误、API密钥无效、Webhook未响应、支付码过期、用户未在网点完成支付。排查方法：查看服务商日志、测试沙箱环境、检查HTTPS回调地址可达性。
使用/接入后遇到问题第一步做什么？
立即登录支付服务商后台查看交易日志与错误代码，比对官方接口文档；若无法定位，联系技术支持并提供request_id、timestamp、payload样本。
Efecty现金充值接口和替代方案相比优缺点是什么？
vs Baloto：两者均为哥伦比亚主流现金支付，覆盖率相近，费率类似，可同时接入。
vs 信用卡：Efecty无拒付风险但到账慢（1-2天），信用卡快但有chargeback风险。
vs PSE（网银转账）：PSE需有本地银行账户，受众较小；Efecty更适合无银行用户。
新手最容易忽略的点是什么？
一是未设置支付超时自动取消，导致库存被长期锁定；二是未做本地化文案，用户看不懂支付指引；三是未测试退款流程，售后时被动。