Efecty现金收款API接入教程企业独立站收费标准
2026-02-24 1
详情
报告
跨境服务
文章
Efecty现金收款API接入教程企业独立站收费标准
要点速读(TL;DR)
- Efecty 是哥伦比亚主流的线下现金支付网络,支持消费者在便利店、超市等网点以现金完成线上订单支付。
- 通过 API 接入 可将 Efecty 支付方式嵌入企业独立站,提升拉美本地买家转化率。
- 主要适用于面向 哥伦比亚消费者 的跨境电商独立站卖家。
- 接入需完成商户资质认证、技术对接与风控设置,通常由支付网关或收单机构提供支持。
- 费用结构包含交易手续费、结算周期、失败处理成本等,具体以合作方报价为准。
- 常见坑:未验证用户支付状态、超时未付款、KYC材料不全导致审核延迟。
Efecty现金收款API接入教程企业独立站收费标准 是什么
Efecty 是哥伦比亚广泛使用的非银行现金支付服务,覆盖超过 2 万家线下网点(如 Droguería Similares、Éxito 商店),允许消费者在线下单后生成支付码,在指定门店用现金完成付款。该服务常用于水电缴费、话费充值及电商购物。
现金收款API接入 指通过标准化接口(API)将 Efecty 支付能力集成至企业自建独立站(DTC 站点),实现订单系统与 Efecty 支付系统的实时通信,自动创建支付单据并回传支付状态。
企业独立站 指由中国跨境卖家自主搭建和运营的电商平台(如基于 Shopify Plus、Magento、自研系统),区别于第三方平台(Amazon、MercadoLibre)。
收费标准 指使用 Efecty 收款服务所产生的各项费用,包括但不限于交易手续费、结算服务费、技术支持费等,通常由支付服务商或本地收单行制定。
它能解决哪些问题
- 痛点:拉美消费者信用卡渗透率低 → 提供现金支付选项,扩大客群覆盖。
- 痛点:PayPal 或国际卡拒付率高 → 使用本地化支付方式降低支付失败率。
- 痛点:独立站缺乏本地信任感 → 展示“可在附近门店付款”增强可信度。
- 痛点:资金回笼慢 → API 实现自动化对账与结算状态同步,减少人工核销。
- 痛点:订单履约滞后 → 支付成功后系统自动触发发货流程,提升效率。
- 痛点:无法追踪现金支付记录 → 通过唯一参考号(reference code)实现支付状态实时回调。
- 痛点:合规风险高 → 正规渠道接入可满足哥伦比亚金融监管要求(如 Superintendencia Financiera)。
怎么用/怎么开通/怎么选择
1. 确认业务适配性
检查目标市场是否为哥伦比亚,且商品单价适合现金支付(通常低于 100 万 COP ≈ 250 USD)。
2. 选择接入模式
- 直接接入:向 Efecty 官方申请成为商户合作伙伴(MP),需本地公司主体与银行账户(少见,门槛高)。
- 间接接入:通过持牌支付服务商(如 PayU Latam、DLocal、Transbank、360Commerce)集成 Efecty,推荐大多数中国卖家采用。
3. 注册支付服务商账户
在选定的服务商平台注册企业账户,提交以下资料:
- 营业执照(中英文公证件)
- 法人身份证件
- 独立站域名及网站截图
- 预计月交易量与品类说明
- 海外银行账户或收款账户信息(如 Wise、PingPong)
4. 技术对接 API
- 获取服务商提供的 API 文档(含 Sandbox 测试环境)
- 开发人员在独立站支付页添加 Efecty 图标与跳转逻辑
- 调用
/create-payment接口生成支付单,返回 reference code 与条形码 - 配置 Webhook 回调地址接收支付成功/失败通知
- 在后台实现订单状态自动更新
- 完成沙盒测试后申请上线
5. 上线与监控
- 开启实时交易日志监控
- 设置异常订单预警(如超时未付、重复支付)
- 定期核对结算报表与实际到账金额
费用/成本通常受哪些因素影响
- 月交易 volume(交易笔数与总金额)
- 单笔交易金额区间(阶梯费率)
- 是否使用统一支付网关(多国支付打包议价)
- 结算币种(COP vs USD)与汇率转换成本
- 结算频率(T+7, T+15 还是 T+30)
- 是否有退款/拒付处理费
- 技术服务支持等级(基础支持 or VIP SLA)
- 是否包含反欺诈风控模块
- 合同签约主体所在地(离岸公司 vs 本地注册)
- 是否需额外购买报告或数据分析功能
为了拿到准确报价,你通常需要准备:
- 近3个月模拟交易数据(笔数、平均客单价)
- 目标国家与支付方式组合
- 期望结算周期与币种
- 现有技术架构(前端框架、后端语言、服务器位置)
- 历史拒付率或风控事件说明
常见坑与避坑清单
- 未设置支付有效期:Efecty 支付码通常仅 1-3 天有效,需在订单系统中标注过期时间并自动取消未付订单。
- 忽略 Webhook 验证:必须校验回调来源 IP 与签名,防止伪造支付成功通知。
- KYC 材料翻译不规范:营业执照需经公证并附西班牙语翻译件,否则审核延误。
- 未做沙盒测试:直接上线可能导致支付失败或资金错配。
- 忽视本地消费者习惯:应在结账页清晰展示合作门店图标(Éxito、Alkosto 等),提升信任。
- 对账机制缺失:建议每日导出交易报告并与独立站订单比对,及时发现漏单。
- 未预留客服应对咨询:哥伦比亚买家常询问“哪里可以付款”,需准备FAQ文档。
- 选择无本地支持的服务商:出现问题响应慢,优先选在拉美设有办事处的供应商。
- 忽略税务合规:部分服务商不代扣 VAT,需自行申报 IVA(19%)。
- 过度依赖单一支付方式:应同时接入 PSE(网银转账)、Nequi 等互补渠道。
FAQ(常见问题)
- Efecty现金收款API接入教程企业独立站收费标准靠谱吗/正规吗/是否合规?
是的,Efecty 为哥伦比亚合法注册的支付网络,受 Superfinanciera 监管。通过持牌支付网关接入属于合规路径,但需确保服务商具备当地收单资质。 - 适合哪些卖家/平台/地区/类目?
主要适合:
- 面向哥伦比亚市场的中国跨境独立站卖家
- 商品单价在 50–800 美元之间的耐用品或时尚品类
- 使用 Shopify、WooCommerce、自研系统的 DTC 品牌
- 不适合 B2B 大额交易或虚拟服务类目 - 怎么开通/注册/接入/购买?需要哪些资料?
步骤:
1. 选择支持 Efecty 的支付网关(如 DLocal)
2. 提交企业营业执照、法人证件、网站信息
3. 完成 KYC 审核(通常 3–7 工作日)
4. 获取 API 密钥与文档
5. 开发对接并测试
6. 正式启用
所需资料详见上文“注册支付服务商账户”部分。 - 费用怎么计算?影响因素有哪些?
无统一标准,费用由支付服务商定价。常见结构为“交易手续费 + 结算费”,可能按笔收取或按比例抽成。影响因素见上文“费用/成本通常受哪些因素影响”列表。 - 常见失败原因是什么?如何排查?
常见原因:
- 用户未在有效期内完成现金支付
- 商户 Webhook 地址无法访问或返回错误状态码
- API 调用参数错误(如金额格式不符)
- KYC 审核未通过导致交易被拒
排查方法:
- 查看服务商后台交易日志
- 检查服务器是否正常接收并响应回调
- 核对 API 请求头与签名算法 - 使用/接入后遇到问题第一步做什么?
首先登录支付服务商管理后台查看交易详情与错误代码;其次确认 Webhook 是否接收到通知;最后联系服务商技术支持,提供 reference code、timestamp 和 error log。 - 和替代方案相比优缺点是什么?
对比 Nequi(移动钱包):
优点:覆盖更广(老年人群可用)
缺点:需线下操作,支付确认延迟
对比 PSE(网银直连):
优点:无需银行账户
缺点:不能即时到账
对比信用卡:
优点:降低拒付风险
缺点:结算周期长(通常 T+5 起) - 新手最容易忽略的点是什么?
一是未设置订单超时关闭机制,导致库存被长期占用;二是忽视本地化文案,未用西班牙语说明付款流程;三是缺少支付成功后的引导页面,影响用户体验。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业

