Efecty现金收款接口文档开发者Marketplace平台收费标准

Efecty现金收款接口文档开发者Marketplace平台收费标准

要点速读（TL;DR）

• Efecty 是哥伦比亚主流的本地现金支付方式，广泛用于无银行账户人群支付电商订单。
• 接入 Efecty 现金收款接口 需通过支持拉美市场的支付网关或收单机构，通常以 API 形式提供。
• 作为 开发者，需查阅支付服务提供商提供的 接口文档 完成技术对接。
• Marketplace 平台 若开放第三方卖家入驻，需明确 Efecty 收款的资金结算路径与手续费承担机制。
• 收费标准由支付服务商制定，受交易金额、月交易量、风控等级等因素影响，不统一公开。
• 合规性要求高，需确保资金流、信息流与当地反洗钱法规一致。

Efecty现金收款接口文档开发者Marketplace平台收费标准 是什么

Efecty 是哥伦比亚领先的现金支付网络，用户可在其遍布全国的数万家线下网点（如便利店、药店、超市）用现金完成线上购物付款。对于面向哥伦比亚消费者的跨境电商平台或 Marketplace，支持 Efecty 可显著提升转化率，尤其覆盖无信用卡人群。

现金收款接口 指支付服务提供商（PSP）向平台或开发者提供的 API 接口，用于生成 Efecty 支付订单、获取付款码、查询支付状态等操作。

接口文档 是由支付服务商提供的技术说明文件，包含请求参数、返回字段、签名规则、回调机制、错误代码等内容，是开发者完成系统对接的核心依据。

开发者 指负责技术实现的工程师或技术团队，需基于接口文档完成前端调用、后端逻辑处理及异常监控。

Marketplace 平台 指允许多个第三方卖家入驻经营的电商平台，如 Mercado Libre、Linio 或自建多商户平台。此类平台在接入 Efecty 时，需设计分账逻辑、明确各参与方（平台、卖家、支付方）的资金结算关系。

收费标准 指使用 Efecty 支付通道所产生的费用结构，通常包括交易手续费、提现费、失败交易费等，具体由合作的支付服务商定义。

它能解决哪些问题

• 场景：哥伦比亚消费者不愿/无法使用信用卡 → 支持 Efecty 提升本地支付覆盖率，提高下单转化率。
• 场景：平台希望拓展拉美市场但缺乏本地支付能力 → 通过集成 Efecty 接口增强本地化服务能力。
• 场景：开发者不清楚如何对接本地支付渠道 → 查阅官方或服务商提供的接口文档可快速完成技术对接。
• 场景：Marketplace 需要统一管理多个卖家的收款方式 → 可将 Efecty 作为平台级支付选项，集中处理资金归集与分账。
• 场景：担心大额现金交易资金安全 → Efecty 系统生成唯一付款码，资金由持牌机构托管，降低欺诈风险。
• 场景：需要自动化对账与状态同步 → 通过 API 实现支付状态实时回调，减少人工核销成本。
• 场景：新进入市场不确定合规要求 → 正规支付服务商通常已具备当地金融监管资质，协助满足合规要求。
• 场景：平台难以获取准确费率结构 → 明确收费标准构成因素有助于谈判更优定价。

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

1. 确认业务需求与目标市场

确认是否主要面向哥伦比亚消费者，且目标用户群体存在现金支付偏好。适用于销售电子产品、家居用品、时尚类高等单价商品的跨境平台。

2. 选择支持 Efecty 的支付服务提供商（PSP）

常见国际或本地 PSP 如:

• PagueloFacil
• DaviPlata（与 Efecty 同属 Grupo Aval）
• PayU Latam（已被 Rapyd 收购）
• RappiPay
• Stripe（部分地区支持）

建议优先选择已在哥伦比亚持牌运营、支持 Marketplace 架构的 PSP。

3. 注册商户账户并申请接入权限

向选定 PSP 提交企业资料（公司注册证明、税务 ID、银行账户、网站/App 信息），申请开通 Efecty 支付方式。部分服务商需进行 KYC 审核。

4. 获取 Efecty 现金收款接口文档

审核通过后，PSP 将提供专属的 API 文档链接或沙箱环境访问权限。文档通常包含：

• 创建支付订单（Create Charge）接口
• 支付状态查询（Get Status）接口
• 异步通知（Webhook）配置说明
• 签名加密算法（如 HMAC-SHA256）
• 测试凭证与沙箱 URL

5. 开发者完成技术对接

1. 在后台系统中集成 API 调用模块
2. 用户选择 Efecty 支付时，调用“创建订单”接口生成付款参考码和截止时间
3. 前端展示付款码、二维码及附近网点地图
4. 配置 Webhook 监听支付成功通知
5. 实现订单状态自动更新与财务对账逻辑

6. 测试与上线

使用沙箱环境模拟支付全流程，验证状态同步准确性。测试通过后申请生产环境切换，并开启正式交易。

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

• 商户所属行业类目（高风险类目费率更高）
• 月均交易笔数与总交易额
• 是否为 Marketplace 模式（涉及分账则可能加收费用）
• 资金结算周期（T+1 vs T+7 影响流动性成本）
• 是否使用 PSP 提供的托管账户（Escrow Account）
• 提现到境外银行账户的跨境转账费用
• 争议处理与拒付（Chargeback）相关服务费
• API 调用频率过高是否产生额外请求费
• 是否需要定制化开发支持
• 合同谈判能力与长期合作承诺

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

• 公司主体名称与注册地
• 预计月交易量与平均订单金额
• 销售类目清单
• 平台类型（独立站 / Marketplace / 自营B2C）
• 目标国家（仅哥伦比亚 or 多国）
• 是否已有支付服务商合作经历
• 期望的资金结算周期
• 技术对接资源情况（是否有专职开发）

常见坑与避坑清单

1. 未核实 PSP 是否真正支持 Efecty：部分服务商宣称支持“哥伦比亚本地支付”，实则仅含 Baloto 或 PSE，务必确认 Efecty 在可用列表中。
2. 忽略支付有效期设置：Efecty 订单通常有 24-72 小时付款期限，超时未付需主动关闭订单并释放库存。
3. 未配置 Webhook 回调验证机制：易导致虚假通知触发发货，造成资损。
4. 未处理部分支付场景：某些情况下用户可能只支付部分金额，需在接口文档中查证如何识别该状态。
5. Marketplace 分账逻辑不清：平台应明确 Efecty 收款后是先归集再分账，还是直接结算至子商户账户。
6. 忽视本地语言提示：付款指引页面应提供西班牙语说明，否则影响用户体验。
7. 跳过沙箱测试直接上线：可能导致订单状态不同步、重复生成付款码等问题。
8. 未监控支付成功率与用户流失点：定期分析从下单到完成支付的漏斗数据，优化流程。
9. 未保留原始交易日志：发生争议时缺乏证据链支持，不利于申诉。
10. 未关注合规变更：哥伦比亚金融监管局（Superintendencia Financiera）可能调整电子支付规则，需保持跟进。

FAQ（常见问题）

1. Efecty现金收款接口文档开发者Marketplace平台收费标准靠谱吗/正规吗/是否合规？
   通过持牌支付服务提供商接入的 Efecty 接口属于正规支付渠道，符合哥伦比亚反洗钱与电子支付监管要求。建议选择有 SFDA（Superfinanciera）备案或与 Banco de Bogotá 等银行合作的服务商。
2. Efecty现金收款接口文档开发者Marketplace平台收费标准适合哪些卖家/平台/地区/类目？
   适合主要面向哥伦比亚市场的跨境电商卖家、独立站及 Marketplace 平台；尤其适用于消费电子、家电、服装、美妆等高频高价品类。不适合俄罗斯、中东等非拉美市场。
3. Efecty现金收款接口文档开发者Marketplace平台收费标准怎么开通/注册/接入/购买？需要哪些资料？
   需通过支付服务商注册商户账户，提交公司营业执照、法人身份证、银行账户证明、网站域名、业务描述等材料。开发者需获得 API Key 和接口文档以完成技术对接。
4. Efecty现金收款接口文档开发者Marketplace平台收费标准费用怎么计算？影响因素有哪些？
   费用由支付服务商设定，通常按交易金额百分比 + 固定费收取，也可能包含月费或提现费。影响因素包括交易量、类目风险、结算周期、是否分账等，具体以合同为准。
5. Efecty现金收款接口文档开发者Marketplace平台收费标准常见失败原因是什么？如何排查？
   常见原因包括：API 签名错误、付款码过期、用户未在网点完成支付、Webhook 未正确接收回调、IP 白名单限制等。建议检查日志、启用调试模式、联系技术支持获取交易追踪 ID。
6. 使用/接入后遇到问题第一步做什么？
   首先确认问题类型：若是技术故障（如接口报错），查看 API 返回码并对照接口文档；若是资金未到账，核对结算周期并与 PSP 客服提供交易号查询；若是用户投诉未支付成功，调取交易详情与 Efecty 系统记录比对。
7. Efecty现金收款接口文档开发者Marketplace平台收费标准和替代方案相比优缺点是什么？
   对比 Baloto：两者均为现金支付，但 Efecty 网点更多（约 30,000+），覆盖更广；Baloto 更偏向账单支付场景。对比信用卡：Efecty 转化率高但到账慢（通常需 24-48 小时确认）；信用卡即时到账但拒付率高。
8. 新手最容易忽略的点是什么？
   新手常忽略三点：一是未设置支付超时自动取消机制；二是未做西班牙语支付引导页面；三是误以为 Efecty 支付即等于资金到账，实际需等待 PSP 确认清算后才能放行发货。

相关关键词推荐

• Efecty 支付接入指南
• 哥伦比亚本地支付方式
• 拉美电商支付解决方案
• Marketplace 分账系统设计
• 跨境支付 API 对接流程
• PagueloFacil 接口文档
• PayU Latam 开发者文档
• 现金支付订单状态同步
• 跨境电商本地化支付
• 支付网关选择标准
• Stripe 哥伦比亚支付支持
• Rapyd 支付平台评测
• Webhook 回调安全验证
• KYC 商户审核材料清单
• 电子钱包与现金支付区别
• 高风险类目支付限制
• 跨境资金结算周期优化
• 反洗钱合规要求
• API 签名加密方法
• 沙箱测试环境配置