Efecty现金收款接口文档财务连锁门店费率说明

2026-02-24 4

详情

报告

跨境服务

文章

Efecty现金收款接口文档财务连锁门店费率说明

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后在实体门店以现金付款。
跨境卖家通过接入 Efecty 现金收款接口 可覆盖无银行卡人群，提升拉美市场转化率。
需查阅官方 接口文档 完成技术对接，包括订单生成、状态回调、错误码处理等环节。
财务对账 需依赖 Efecty 提供的结算文件，注意时区、货币单位和手续费标注方式。
支持门店数量多，但费率结构复杂，通常按交易笔数或金额阶梯计价，具体以合同为准。
主要适用于面向哥伦比亚消费者的电商平台或独立站卖家。

Efecty现金收款接口文档财务连锁门店费率说明是什么

Efecty现金收款 是哥伦比亚本地广泛使用的替代性支付方式（Alternative Payment Method, APM），用户在线选择 Efecty 支付后，系统生成唯一付款码或票据，消费者凭码在 Efecty 覆盖的连锁零售门店（如Droguería Ara、Alkosto、Éxito等）以现金支付完成订单。

接口文档 指 Efecty 或其支付网关合作方（如PayU Latam、Red Pagos、Mercado Pago等）向商户提供的 API 技术文档，包含：

订单创建请求参数（金额、币种、订单号、回调地址）
响应数据结构（付款码、有效期、支付链接）
支付状态异步通知（Webhook）机制
错误代码与处理建议
签名验证逻辑（用于防篡改）

财务指交易完成后资金结算流程，涉及：

结算周期（T+1、T+2 或周结）
结算币种（COP 哥伦比亚比索）
对账文件格式（CSV/XLS）及字段说明
退款处理机制与时效

连锁门店 指 Efecty 合作的线下现金收单网点，据公开信息显示覆盖超 20,000 家门店，分布于城市与乡镇，是其核心履约网络。

费率说明 指使用 Efecty 收款所需支付的服务费用，通常由支付网关或本地收单机构收取，可能包含：

交易手续费（按笔或按比例）
固定服务费
退款处理费
汇率转换费（若结算为美元）

实际费率结构需根据签约主体和业务规模协商确定，以合同或官方报价单为准。

它能解决哪些问题

痛点：哥伦比亚信用卡渗透率低 → 价值：支持现金支付，触达无卡人群，提升成交率。
痛点：本地消费者信任在线扣款 → 价值：先下单后现金付款，增强支付安全感。
痛点：国际支付渠道拒付率高 → 价值：本地化支付方式降低风控拦截概率。
痛点：缺乏本地收单能力 → 价值：通过 Efecty 接口实现本地收款与结算。
痛点：订单支付状态难追踪 → 价值：API 回调实时同步支付结果，自动化订单管理。
痛点：财务对账效率低 → 价值：提供标准化对账文件，支持系统自动匹配。
痛点：退换货资金返还复杂 → 价值：明确退款路径与周期，降低客诉风险。
痛点：拉美市场本地化体验差 → 价值：提供本土熟知的支付选项，提升品牌可信度。

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

常见接入流程（步骤化）

确认业务适配性：评估是否面向哥伦比亚市场销售，产品单价适合现金支付（通常中低价位更佳）。
选择接入方式：
- 通过第三方支付平台（如 PayU Latam、Mercado Pago、Dlocal）集成 Efecty，适合中小卖家；
- 直接与 Efecty 或本地银行合作，需较强本地合规与技术能力。
注册商户账号：在选定平台提交公司资料（营业执照、法人身份、网站/APP信息、银行账户等）。
获取接口文档：登录平台开发者后台下载 Efecty 现金支付 API 文档，确认支持的功能版本。
技术对接开发：
- 实现订单创建接口调用
- 配置异步通知（Webhook）接收地址
- 处理签名验证与错误码
- 在前端展示付款码或支付指引
测试与上线：使用沙箱环境测试全流程（生成订单→门店支付→状态回调→财务结算），确认无误后切换至生产环境。

注：具体流程和材料要求以所选支付平台的实际页面和审核规则为准。

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

月交易 volume（交易笔数或总金额）
单笔交易平均金额（AOT）
是否为新签约商户
结算币种（COP vs USD）
是否包含汇率服务
退款频率与处理量
技术支持等级（标准支持 vs VIP）
是否捆绑其他支付方式打包定价
合同谈判能力与合作周期
所在行业类目风险等级（如虚拟商品可能费率更高）

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

预估月交易量（笔数+金额）
目标市场（国家+城市层级）
销售类目（实物/虚拟/高风险类目）
现有支付渠道情况
技术对接能力说明（是否有开发资源）
期望结算周期与币种

常见坑与避坑清单

未核实门店可用性：部分偏远地区门店可能不支持 Efecty 支付，应在前端提示用户查询附近网点。
忽略付款有效期：Efecty 订单通常有 24-72 小时有效期限，超时未付需重新下单，系统应自动关闭过期订单。
回调未做幂等处理：Webhook 可能重复推送，未做去重可能导致订单状态异常。
对账文件字段理解错误：如“结算金额”是否已扣除手续费，需与文档逐项核对。
未设置人工核验机制：少数情况下门店录入延迟，需建立客服查单流程。
忽视本地合规要求：哥伦比亚对电子发票、消费者告知义务有规定，需确保流程符合当地法律。
直接使用非官方文档：避免依赖第三方博客或论坛信息，以支付平台官网发布文档为准。
未监控支付成功率：定期分析支付失败原因（如参数错误、签名失败），优化接口调用。
忽略用户体验引导：未清晰说明如何在门店支付，导致用户放弃付款。
合同未明确退款责任方：确认退款是由平台原路退回还是卖家自行处理。

FAQ（常见问题）

Efecty现金收款接口文档财务连锁门店费率说明靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚持牌支付服务机构，与多家银行和电商平台合作，具备合法运营资质。其现金收款服务受金融监管框架约束，合规性较高，但具体合作方（如支付网关）也需核查牌照情况。
Efecty现金收款接口文档财务连锁门店费率说明适合哪些卖家/平台/地区/类目？
主要适合：
- 面向哥伦比亚消费者的跨境独立站或本地电商平台；
- 销售中低价实物商品（如日用百货、电子产品配件）；
- 目标用户为无信用卡或偏好现金支付人群；
- 已接入拉美本地支付网关（如 PayU、Dlocal）的卖家。
Efecty现金收款接口文档财务连锁门店费率说明怎么开通/注册/接入/购买？需要哪些资料？
通常需通过支付网关平台开通，流程如下：
1. 注册商户账号；
2. 提交企业营业执照、法人身份证、银行账户证明、网站/App信息；
3. 完成KYC审核；
4. 开通 Efecty 支付方式权限；
5. 下载接口文档并开发对接。
具体材料以平台要求为准。
Efecty现金收款接口文档财务连锁门店费率说明费用怎么计算？影响因素有哪些？
费用通常由支付网关收取，可能包含：
- 按交易金额百分比收费
- 按笔固定费用
- 结算服务费
影响因素包括交易量、单笔金额、结算币种、行业类目等，具体费率需与平台协商并签署合同。
Efecty现金收款接口文档财务连锁门店费率说明常见失败原因是什么？如何排查？
常见失败原因：
- 接口调用参数错误（如金额格式不符）
- 签名验证失败
- 回调地址无法访问
- 订单超时未支付
- 门店系统临时故障
排查方法：
1. 查看接口返回错误码；
2. 检查服务器日志与 Webhook 接收状态；
3. 使用沙箱环境复现；
4. 联系支付网关技术支持。
使用/接入后遇到问题第一步做什么？
第一步应：
1. 记录问题发生时间、订单号、错误信息；
2. 检查自身系统日志与接口调用记录；
3. 登录支付平台后台查看交易状态；
4. 联系支付服务商技术支持，并提供完整凭证。
Efecty现金收款接口文档财务连锁门店费率说明和替代方案相比优缺点是什么？
对比 PSE（网银转账）、Nequi（移动钱包）、Tarjeta de Crédito：
优点：
- 覆盖无银行账户人群
- 支付门槛低
- 用户信任度高
缺点：
- 到账延迟（需门店录入）
- 存在现金丢失风险（极低）
- 退款周期较长
- 需额外对接成本
新手最容易忽略的点是什么？
1. 忽视付款码有效期管理；
2. 未配置 Webhook 幂等处理；
3. 对账时未区分“毛收入”与“净结算额”；
4. 缺少用户支付指引页面；
5. 未测试门店实际支付流程；
6. 忽略本地消费者沟通语言（需西班牙语说明）。