Efecty现金收款API接入教程财务Marketplace平台费率说明
2026-02-24 3
详情
报告
跨境服务
文章
Efecty现金收款API接入教程财务Marketplace平台费率说明
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后到线下网点用现金付款。
- 通过 API 接入 可实现订单状态同步、支付确认自动化，适用于自建站或本地化电商平台。
- 主要服务 拉美市场 卖家，尤其针对无银行卡用户的消费群体。
- 接入需技术开发能力，涉及订单创建、回调通知、对账处理等关键接口。
- 财务结算周期通常为 T+3 到 T+7，具体以商户协议为准。
- Marketplace 平台若集成 Efecty，需明确分摊 交易费率、提现成本、争议处理责任。
Efecty现金收款API接入教程财务Marketplace平台费率说明 是什么
Efecty 是哥伦比亚领先的非银行支付网络，支持消费者在电商平台选择 Efecty 作为支付方式后，生成一个条码或参考号，前往超过 14,000 个合作网点（如药店、超市、便利店）以现金完成支付。该服务广泛用于跨境卖家进入哥伦比亚市场的本地化支付解决方案。
API 接入 指通过 Efecty 提供的 RESTful 接口，将电商平台或 ERP 系统与其支付网关对接，实现订单创建、支付状态查询、异步回调通知等功能，确保资金流与信息流自动同步。
财务结算 指 Efecty 在用户完成现金支付后，扣除手续费并按约定周期向商户打款的过程。结算币种通常为 COP（哥伦比亚比索），需注意汇率转换与提现通道费用。
Marketplace 平台费率说明 指当多商户平台（如 Mercado Libre、Linio 或自建 Mall）集成 Efecty 时，平台方需向子商户披露的费用结构、结算规则、争议处理机制及各方责任划分。
它能解决哪些问题
- 场景：目标客户无信用卡 → 借助 Efecty 覆盖哥伦比亚约 70% 未拥有银行卡的人群，扩大购买力。
- 场景：支付转化率低 → 提供本地信任的现金支付选项，提升结账完成率。
- 场景：订单人工核销效率低 → 通过 API 实现支付状态自动回传，减少人工对账工作量。
- 场景：跨境拒付风险高 → 现金支付不可逆，降低欺诈和 chargeback 风险。
- 场景：本地化体验不足 → 支持西班牙语支付页面和本地网点导航，增强用户体验。
- 场景：平台资金管理复杂 → 明确 Marketplace 下游商户的费率分摊逻辑，避免财务纠纷。
- 场景：结算周期不透明 → 通过合同约定结算频率（如每日/每周）、最低起付金额、退款流程。
- 场景：合规要求不明 → 符合哥伦比亚金融监管机构 Superintendencia Financiera de Colombia 对第三方支付的规定。
怎么用/怎么开通/怎么选择
一、Efecty 商户注册与资质准备
- 访问 Efecty 官方商业合作页面或联系其企业销售团队获取接入申请表。
- 提交公司注册文件（如 NIT 编号）、营业执照、法人身份证明、银行账户信息。
- 提供电商平台 URL、商品类目说明、预计月交易量。
- 签署服务协议，明确费率结构、结算周期、违约条款。
- 获得测试环境 API 凭据（Client ID、Secret Key、Endpoint URL）。
二、API 接入开发流程
- 配置测试环境：使用 Efecty 提供的沙箱环境进行接口调试。
- 创建支付订单：调用
/payments接口传递订单号、金额（COP）、买家邮箱、过期时间（通常 24-72 小时）。 - 接收支付通知：设置 Webhook 回调地址，接收
payment.confirmed事件，验证签名防止伪造。 - 查询订单状态：通过
/payments/{id}接口轮询或主动查询支付结果。 - 处理退款请求：Efecty 不支持线上退款，需商户自行退还现金，系统标记退款状态。
- 上线前联调：完成至少 10 笔模拟交易并通过 Efecty 技术审核。
三、财务结算与对账
- 登录 Efecty 商户后台下载每日结算报告（CSV 格式），包含交易明细、手续费、净额。
- 核对实际到账金额与报表一致性，关注延迟到账或异常扣费。
- 设置内部财务系统自动匹配订单 ID 与结算流水。
- 定期审查争议交易（如超时未付款、重复支付），提交申诉材料。
四、Marketplace 平台集成注意事项
- 明确平台是否统一签约 Efecty 还是允许子商户独立接入。
- 制定子商户费率模板：可采用“平台承担”、“商户承担”或“分摊”模式。
- 在店铺后台展示清晰的支付说明，包括有效期、可用网点地图链接。
- 建立子商户结算台账，记录 Efecty 打款与平台分账之间的差额。
- 设定争议响应 SLA（如 48 小时内处理投诉）。
费用/成本通常受哪些因素影响
- 商户行业类目（高风险类目费率更高）
- 月均交易笔数与总金额（量大可协商折扣）
- 是否使用 Efecty 提供的前端支付组件
- 结算频率（高频结算可能增加手续费）
- 提现币种与通道（COP 转 USD 的汇损）
- 平台是否加收服务费（Marketplace 层级抽成）
- 是否存在争议交易比例超标导致罚款
- 技术对接复杂度（是否需定制开发）
- 是否启用高级风控模块
- 合同签约主体所在国家/地区
为了拿到准确报价/成本，你通常需要准备以下信息：
- 公司注册地与税务编号（如 NIT）
- 电商平台类型（独立站/Magento/Shopee 等）
- 过去三个月 GMV 与订单量
- 目标市场（仅限哥伦比亚还是泛拉美）
- 期望的结算周期（D+1/D+3/D+7）
- 是否已有其他本地支付方式（如 PSE、Baloto）
- 技术团队对接能力说明（是否有专职开发）
常见坑与避坑清单
- 未设置有效 Webhook 验证机制 → 导致虚假支付通知触发发货，建议验证 HTTPS 签名与来源 IP 白名单。
- 忽略支付有效期 → 用户未在规定时间内付款，订单应自动取消，避免库存锁定。
- 结算数据未自动化对账 → 手工核对易出错，建议开发脚本自动匹配交易 ID。
- 未告知买家付款截止时间 → 引发客诉，应在支付成功页明确显示“请于 XX 前完成现金支付”。
- 平台未披露底层费率 → 子商户质疑抽成过高，建议在入驻协议中列明基础成本。
- 技术文档依赖翻译 → Efecty 官方文档多为西班牙语，需配备懂西语技术人员或使用专业翻译工具。
- 忽视退款政策差异 → Efecty 不处理退款，所有退还需商户自行完成并通知平台关闭订单。
- 测试不充分即上线 → 建议至少跑通 3 种异常场景：超时、重复请求、网络中断。
- 未监控支付成功率 → 若低于 60%，应及时优化支付跳转流程或更换入口文案。
- 未留存完整日志 → 发生争议时无法举证，建议保存至少 180 天的 API 请求/响应记录。
FAQ（常见问题）
- Efecty现金收款API接入教程财务Marketplace平台费率说明靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚金融监管局 SF 监管的合法支付机构，具备运营资质。其 API 接入流程符合 PCI DSS 基本安全要求，但具体合规性还需结合商户自身业务判断。 - 适合哪些卖家/平台/地区/类目？
主要适用于面向哥伦比亚消费者的跨境电商卖家、本地电商平台、SaaS 工具商。适合电子消费品、时尚服饰、家居用品等大众类目，禁售类目（如烟草、武器）不予接入。 - 怎么开通/注册/接入/购买？需要哪些资料？
需通过 Efecty 官方渠道提交企业注册证明、NIT 税号、银行账户、网站信息、法人身份证件。个人卖家通常无法直接签约，需通过平台间接使用。 - 费用怎么计算？影响因素有哪些？
费用由交易手续费 + 结算费 + 可能的平台服务费构成。具体费率取决于行业、交易量、结算频率、技术方案，需签订合同后确认。 - 常见失败原因是什么？如何排查？
常见原因包括：API 凭据错误、Webhook 无法访问、订单超时未支付、买家未在网点完成缴费。排查步骤：检查日志、验证签名、确认回调地址可达、查看商户后台状态。 - 使用/接入后遇到问题第一步做什么？
首先查看 Efecty 商户后台是否有错误提示，其次检查 API 日志与 Webhook 接收情况，最后联系 Efecty 技术支持并提供 transaction ID 和时间戳。 - 和替代方案相比优缺点是什么？
对比 Baloto：两者覆盖相似，但 Efecty 网点略多；对比 PSE：Efecty 无需网银，更适合低收入人群；对比信用卡：Efecty 虽慢但转化率高且无拒付风险。 - 新手最容易忽略的点是什么？
一是未设置自动取消未支付订单机制；二是未做西班牙语版支付指引；三是以为 Efecty 会自动退款；四是忽略对账自动化建设，后期财务压力大。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业