Efecty现金收款接口文档财务Marketplace平台费率说明

Efecty现金收款接口文档财务Marketplace平台费率说明

要点速读（TL;DR）

• Efecty 是哥伦比亚主流的现金支付方式，支持消费者在线下单后通过线下网点现金付款。
• 接入 Efecty 现金收款接口 需要技术对接其 API，并遵循本地合规与反洗钱要求。
• 接口文档包含认证方式、请求参数、回调机制、错误码等关键信息，是系统集成的基础。
• 财务结算周期通常为 T+7 到 T+15，具体取决于平台或支付服务商的规则。
• Marketplace 平台对使用 Efecty 的订单可能收取额外服务费，费率因平台而异。
• 适合面向哥伦比亚市场、销售中低价商品、希望提升转化率的跨境卖家。

Efecty现金收款接口文档财务Marketplace平台费率说明 是什么

Efecty 是哥伦比亚领先的电子支付网络，提供覆盖全国的现金收款服务。消费者在电商平台选择 Efecty 支付后，会获得一个条形码或参考号，可在超过 20,000 个合作网点（如药店、超市、便利店）用现金完成支付。

现金收款接口文档 指 Efecty 或第三方支付网关（如 PagoFacil、PayU Latam、Mercado Pago）提供的技术文档，用于指导电商平台或独立站系统与其支付系统进行对接。文档内容包括：

• API 接口地址（RESTful 或 SOAP）
• 身份验证方式（如 API Key、OAuth、商户ID）
• 创建支付订单的请求参数（金额、货币、订单号、用户信息）
• 支付成功后的异步通知（Webhook/Callback URL）处理逻辑
• 查询订单状态接口
• 错误代码表及处理建议

财务结算 指 Efecty 或其合作收单方将买家支付的资金结算给平台或卖家的过程。该过程涉及清算周期、手续费扣除、汇率转换（如适用）、退款处理等环节。

Marketplace 平台费率说明 指电商平台（如 Mercado Libre、Linio、Amazon Colombia）对使用 Efecty 支付方式所设定的服务费用结构，通常包含交易手续费、固定费用、延迟结算等条款。

关键名词解释

• API 接口：应用程序编程接口，用于两个系统之间数据交互。例如，你的网站调用 Efecty 的 API 创建支付订单。
• Callback/Webhook：支付完成后，Efecty 向你服务器发送通知的技术机制，用于更新订单状态。
• 收单方（Acquirer）：实际处理交易并承担资金风险的金融机构或支付公司，常与 Efecty 合作完成资金归集。
• 结算周期：从交易完成到资金到账的时间，常见为 T+N 日。
• 平台费率：Marketplace 对特定支付方式收取的服务费，可能高于信用卡或其他数字支付方式。

它能解决哪些问题

• 场景：哥伦比亚消费者缺乏银行卡 → 提供现金支付选项，扩大客群覆盖范围。
• 场景：线上支付转化率低 → 增加本地化支付方式，提升信任感和下单意愿。
• 场景：无法接收跨境小额现金交易 → 通过 Efecty 实现“线上下单+线下现金履约”闭环。
• 场景：平台强制要求支持本地支付方式 → 满足 Mercado Libre 等拉美平台的入驻或流量扶持条件。
• 场景：担心资金安全与对账混乱 → 通过标准接口文档实现自动化订单同步与财务核销。
• 场景：不清楚成本结构影响利润 → 明确平台费率构成，优化定价策略。
• 场景：技术团队不了解集成流程 → 参考官方接口文档快速完成开发对接。
• 场景：客户支付后订单未确认 → 正确配置回调机制可自动更新订单状态，减少人工干预。

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

一、接入 Efecty 现金收款的常见流程

1. 确定接入模式：
   • 直接与 Efecty 官方合作（门槛高，需本地实体）
   • 通过已集成 Efecty 的支付网关（如 PayU Latam、Mercado Pago、Stripe Latam 合作伙伴）——大多数跨境卖家的选择
2. 注册支付服务商账户：提交企业营业执照、法人身份证明、银行账户信息、网站/APP 信息等资料。
3. 申请开通 Efecty 支付方式：在支付网关后台提交功能开通请求，部分需签署补充协议。
4. 获取接口文档：从服务商开发者中心下载最新版 Efecty API 文档，确认支持的功能（创建订单、查询、回调等）。
5. 技术对接与测试：
   • 开发人员根据文档实现订单创建接口调用
   • 配置安全的 Callback URL 并验证通知解析逻辑
   • 使用沙箱环境完成全流程测试（生成二维码 → 模拟支付 → 接收回调）
6. 上线与监控：切换至生产环境，开启实时日志监控，定期核对交易流水与结算报表。

二、财务管理注意事项

• 确认结算币种（COP 哥伦比亚比索）及是否支持跨境结算（如 USD 结算）
• 了解结算周期（例如每周结算一次，延迟 7–15 天）
• 保存每笔交易的 reference code 和 payment ID，用于对账
• 关注退款政策：Efecty 是否支持部分退款？处理时效多久？

三、理解 Marketplace 平台费率

• 登录平台卖家后台，查看“支付方式费用”或“结算管理”页面
• 对比不同支付方式的费率结构（如 Efecty vs. Visa vs. Baloto）
• 注意是否存在：
  - 固定手续费（如 COP 2,000/单）
  - 百分比费率（如 4.5%）
  - 最低收费
  - 额外风险准备金扣留
• 以官方说明为准，费率可能随类目、销售额等级动态调整。

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

• 交易金额大小（阶梯式费率）
• 月交易 volume（高交易量可能享折扣）
• 所属行业类目（高风险类目费率更高）
• 是否使用第三方支付网关（增加一层服务费）
• 平台是否加收附加费（如 Mercado Libre 对 Efecty 订单收取额外费用）
• 结算频率（频繁结算可能增加成本）
• 退款率水平（高退款率可能导致风控押金或费率上浮）
• 是否有外汇兑换需求（COP 转 USD 是否产生汇损）
• 合同谈判能力（大卖家可协商定制费率）
• 是否包含技术支持或 SLA 保障服务

为了拿到准确报价/成本，你通常需要准备以下信息：

• 预计月均交易笔数与总金额
• 目标国家（仅哥伦比亚 or 多国）
• 销售类目（如电子产品、服饰、虚拟商品）
• 现有技术架构（是否已有支付系统？使用哪种语言开发？）
• 期望的结算周期与币种
• 是否需要多语言客服支持
• 企业注册地与税务信息

常见坑与避坑清单

1. 未正确配置 Callback 导致订单不确认 → 必须实现幂等性处理，防止重复发货。
2. 忽略支付有效期 → Efecty 订单通常有 24–72 小时支付时限，超时自动关闭，需前端提示用户。
3. 未做沙箱测试即上线 → 先在测试环境走通全流程再切生产。
4. 忽视本地合规要求 → 哥伦比亚对数据隐私、发票开具有明确法规，确保符合当地法律。
5. 误读平台费率结构 → 不要只看百分比，综合计算固定费+平台佣金+支付手续费。
6. 结算账户不匹配 → 确保收款银行账户名称与注册主体一致，避免资金滞留。
7. 未监控异常交易 → 设置风控规则识别高频小额测试订单或 IP 异常行为。
8. 依赖单一服务商 → 建议同时接入 Baloto 或 PSE 等其他本地支付方式，分散风险。
9. 未保留原始凭证 → 所有支付记录、通知日志至少保存 18 个月，便于争议处理。
10. 忽略用户体验设计 → 支付成功页应清晰显示参考号和可用网点地图链接。

FAQ（常见问题）

1. Efecty现金收款接口文档财务Marketplace平台费率说明靠谱吗/正规吗/是否合规？
   是的，Efecty 是哥伦比亚央行认可的支付网络，与多家国际支付网关合作。只要通过正规渠道接入并遵守当地金融监管规定（如 Superintendencia Financiera de Colombia），即属合规操作。
2. 适合哪些卖家/平台/地区/类目？
   主要适用于：
   - 目标市场为哥伦比亚的跨境卖家
   - 在 Mercado Libre Colombia、Linio 等本地平台运营的商家
   - 独立站且希望提升拉美转化率的品牌
   - 销售中低价商品（USD 10–100）的品类（如手机配件、时尚饰品、家居用品）
3. 怎么开通/注册/接入/购买？需要哪些资料？
   多数通过支付网关开通，所需资料一般包括：
   - 企业营业执照扫描件
   - 法人身份证或护照
   - 公司银行账户信息（SWIFT/BIC）
   - 网站域名及隐私政策链接
   - 业务描述与预期交易量
   - KYC 表格填写（由服务商提供）
4. 费用怎么计算？影响因素有哪些？
   费用通常由三部分组成：
   1) 平台佣金（如 Mercado Libre 收取）
   2) 支付网关服务费（按交易额计费）
   3) Efecty 现金处理费（可能含固定+比例）
   具体以合同约定为准，影响因素见上文“费用影响因素”列表。
5. 常见失败原因是什么？如何排查？
   常见原因：
   - Callback 地址不可访问（防火墙阻挡）
   - 签名验证失败（密钥错误）
   - 订单超时未支付
   - 用户输入参考号错误
   排查步骤：
   1) 查看支付网关日志中的 error code
   2) 核对 API 请求参数格式
   3) 测试 Callback 是否能正常接收 POST 请求
   4) 联系服务商技术支持提供 transaction ID 追踪
6. 使用/接入后遇到问题第一步做什么？
   第一步：检查交易日志和错误代码；第二步：确认是否已完成沙箱测试；第三步：联系支付服务商技术支持，提供完整请求/响应日志、订单号、时间戳。
7. 和替代方案相比优缺点是什么？
   对比 Baloto：功能相似，覆盖率接近，费率结构类似，可同时接入。
   对比信用卡：Efecty 触达无卡人群，但结算慢、手续费略高。
   对比 PSE（网银转账）：PSE 实时到账但需用户有网银账户，Efecty 更普惠但依赖线下履约。
8. 新手最容易忽略的点是什么？
   1) 忽视支付有效期导致库存锁定过久
   2) 未设置自动取消未支付订单机制
   3) 没有在前端清晰展示操作指引（如何找网点）
   4) 忘记对账，造成财务差异
   5) 以为“接入=立即收款”，忽略了结算周期的存在

相关关键词推荐

• Efecty 支付接入流程
• 哥伦比亚现金支付方式
• PayU Latam Efecty 集成
• Mercado Libre 支付费率
• 拉美跨境电商收款
• 独立站本地支付解决方案
• 跨境支付 API 文档
• 拉丁美洲 Cash Payment
• 收单机构 合作模式
• 支付回调通知配置
• 电商平台结算周期
• 跨境支付手续费对比
• 高转化支付方式 哥伦比亚
• 现金支付订单对账
• 支付网关选择指南
• API 接口调试工具
• 支付失败 error code
• 本地化支付 UX 设计
• 跨境电商业务合规
• 新兴市场支付基础设施