Efecty现金收款API接入教程商家Marketplace平台收费标准
2026-02-24 3
详情
报告
跨境服务
文章
Efecty现金收款API接入教程商家Marketplace平台收费标准
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后线下现金付款，适合无银行卡用户。
- 通过 API 接入 可实现与电商平台或ERP系统对接，自动化生成付款码、订单同步与状态更新。
- 主要适用于面向 哥伦比亚市场 的跨境卖家、本地化运营的 Marketplace 平台。
- 接入需具备技术开发能力或使用第三方集成工具，建议通过官方认证合作伙伴加快流程。
- 费用结构通常包含交易手续费、结算周期成本、汇率损失及可能的失败订单管理成本。
- 商家在 Marketplace 上架商品时，需遵守平台对 Efecty 支付方式的展示规则与服务标准。
Efecty现金收款API接入教程商家Marketplace平台收费标准 是什么
Efecty 是哥伦比亚领先的非银行支付网络，覆盖超 2 万家线下网点（便利店、超市、药店等），用户可在线生成账单二维码或参考号，前往任意门店以现金完成支付。该服务广泛用于水电缴费、话费充值及电商购物。
现金收款API 指 Efecty 向商户提供的程序接口，支持订单创建、付款链接/条码生成、支付状态回调通知等功能，实现与电商平台、独立站或ERP系统的自动化集成。
商家Marketplace平台 指如 Mercado Libre、Linio、Amazon Colombia 等允许第三方卖家入驻销售的电商平台，部分平台原生支持 Efecty 作为支付选项。
收费标准 包括两部分：一是 Efecty 或其支付网关服务商收取的交易处理费；二是 Marketplace 平台针对使用 Efecty 支付订单所设定的佣金或附加规则。
关键名词解释
- API（Application Programming Interface）：系统间通信接口，用于自动传递订单数据和支付状态。
- 支付网关：连接电商平台与支付机构的技术中间层，常由第三方服务商提供（如 PayU Latam、Dlocal、Paddle）。
- 回调通知（Webhook）：支付成功后，Efecty 主动向商家服务器发送支付结果，用于更新订单状态。
- 结算周期：指从用户完成现金支付到资金划入商家账户的时间，通常为 T+1 至 T+7 工作日。
- 拒付风险：现金支付不可逆，一般不涉及信用卡拒付，但存在用户未实际付款却上传虚假凭证的风险。
它能解决哪些问题
- 痛点：哥伦比亚银行卡渗透率低 → 提供现金支付入口，扩大潜在客户群。
- 痛点：本地消费者信任度不足 → 使用本土知名支付品牌提升转化率。
- 痛点：手动核销效率低 → API 自动化生成账单并接收支付反馈，减少人工对账。
- 痛点：订单履约延迟 → 实时获取支付状态，避免发货给未付款订单。
- 痛点：平台强制要求本地支付方式 → 满足 Marketplace 入驻条件中对支付多样性的要求。
- 痛点：跨境支付渠道受限 → 绕过国际卡限制，提升南美市场订单成功率。
- 痛点：资金回笼慢 → 明确结算周期与手续费结构，优化现金流预测。
- 痛点：多平台管理复杂 → 通过统一支付网关集中管理 Efecty 订单。
怎么用/怎么开通/怎么选择
步骤 1：确认业务适用性
判断是否目标市场为哥伦比亚，且销售客单价适中（通常 COP 50,000 - 2,000,000），适合现金支付场景。
步骤 2：选择接入方式
- 方式一：直接接入 Efecty 官方 API —— 需申请企业商户资质，签署合同，获取 API Key 与密钥。
- 方式二：通过支付网关间接接入 —— 如使用 Dlocal、PayU、Rapyd 等已集成 Efecty 的全球支付平台，简化技术对接。
- 方式三：通过 Marketplace 内置支持 —— 若在 Mercado Libre Colombia 等平台开店，启用 Efecty 支付选项即可，无需自行开发。
步骤 3：准备技术文档与环境
- 获取 Efecty 或网关提供的 API 文档（含沙箱环境地址、请求格式、签名算法）。
- 配置服务器接收 Webhook 回调（需公网 IP、HTTPS 加密）。
- 开发订单创建接口调用逻辑，返回付款码或参考号给买家。
步骤 4：测试交易流程
- 在沙箱环境中模拟生成订单、支付确认、回调接收。
- 验证签名有效性、金额一致性、状态同步准确性。
步骤 5：上线并监控
- 切换至生产环境，开启真实交易。
- 设置日志记录与异常报警机制，监控失败回调、重复通知等问题。
步骤 6：与 Marketplace 平台协调
- 确保平台端正确显示 Efecty 图标与说明。
- 遵守平台关于订单取消、退款、售后响应时间的规定。
- 定期核对平台结算单与自身系统流水。
费用/成本通常受哪些因素影响
- 交易金额区间（阶梯费率）
- 月交易 volume（高 volume 可协商更低费率）
- 是否通过中间支付网关（增加一层服务费）
- 结算币种与汇率转换方式（COP→USD→本币）
- 结算频率（T+1 vs T+7 影响资金占用成本）
- 退款处理政策（是否收费、能否冲正）
- 技术支持模式（是否有额外咨询或实施费）
- 违约金条款（如未达最低交易量）
- 平台佣金叠加（Marketplace 对 Efecty 订单额外收费）
- 欺诈订单损失承担方（商家、网关或平台）
为了拿到准确报价/成本，你通常需要准备以下信息：
- 预估月交易笔数与总金额
- 目标国家与币种
- 现有技术架构（独立站/平台/SaaS系统）
- 是否已有支付网关合作
- 期望的结算周期与币种
- 历史拒付率或争议数据（如有）
常见坑与避坑清单
- 未配置 Webhook 监听导致漏单：务必确保服务器能稳定接收并解析回调通知。
- 签名验证缺失引发伪造支付：必须按 API 文档校验签名，防止恶意提交假付款截图。
- 忽略结算周期造成现金流误判：明确首次结算时间，预留运营资金。
- 未告知买家付款有效期：Efecty 账单通常有 24-72 小时有效，超期失效需重新下单。
- 在 Marketplace 关闭 Efecty 却继续引流：平台政策变动后应及时调整前端展示。
- 未做多语言提示：向哥伦比亚用户清晰说明“如何用 Efecty 付款”操作指引。
- 未监控失败交易原因：定期分析支付失败日志（如金额不符、超时等）。
- 依赖单一接入渠道：建议同时接入多种本地支付方式（如 PSE、Baloto）以提高覆盖率。
- 忽视合规申报义务：在哥伦比亚有持续交易可能触发税务登记要求，建议咨询本地会计师。
- 跳过沙箱测试直接上线：必须完整走通测试流程再开放真实交易。
FAQ（常见问题）
- Efecty现金收款API接入教程商家Marketplace平台收费标准靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚央行认可的支付服务机构，合法运营多年。其 API 接入需通过正式商业合同，数据传输符合行业加密标准。但具体合规性还需结合商家所在国出口管制、外汇管理政策综合判断。 - 适合哪些卖家/平台/地区/类目？
主要适合：
- 面向哥伦比亚消费者的跨境卖家或本地化运营团队
- 销售电子配件、家居用品、服装鞋包等中低价商品
- 使用独立站 + 支付网关 或 入驻拉美电商平台（如 Mercado Libre）
- 不适合高单价、B2B 大额交易或禁止现金支付的受限类目。 - 怎么开通/注册/接入/购买？需要哪些资料？
常见做法：
- 通过支付网关（如 Dlocal）注册商户账号，提交公司营业执照、法人身份证明、银行账户信息、网站/App 信息。
- 或联系 Efecty 官方授权代理，签署本地服务协议，提供哥伦比亚税务识别号（NIT）等材料。
具体所需资料以实际页面或合同为准。 - 费用怎么计算？影响因素有哪些？
无统一标准，费用结构通常包括：
- 按笔或按比例收取交易手续费
- 结算货币转换差价
- 支付网关附加服务费
- 平台佣金叠加
影响因素见上文“费用/成本通常受哪些因素影响”清单。 - 常见失败原因是什么？如何排查？
常见原因：
- 用户未在有效期内完成现金支付
- 回调通知丢失或签名验证失败
- 订单金额与实际支付不一致
- 系统超时未收到确认
排查方法：
- 查看 API 返回错误码
- 核对 Webhook 日志
- 登录支付网关后台查询交易详情
- 联系技术支持提供 trace ID 追踪 - 使用/接入后遇到问题第一步做什么？
第一步应：
- 确认问题类型（支付失败、未到账、重复扣款等）
- 记录订单号、交易时间、错误截图
- 登录支付服务商后台查看状态
- 联系对应客服通道（优先选择技术支持邮箱或工单系统）
切勿私自修改生产环境代码。 - 和替代方案相比优缺点是什么？
对比 Baloto： 类似现金支付网络，覆盖略少，但部分地区更普及。
对比 PSE： 在线银行转账，即时到账，但需网银账户。
对比信用卡： 国际卡拒付风险高，本地卡覆盖率低。
优势： 现金友好、用户基数大、降低支付门槛。
劣势： 结算慢、需防伪凭证、依赖线下网点。 - 新手最容易忽略的点是什么？
最易忽略：
- 忽视付款码有效期导致订单长时间挂起
- 未设置自动取消未支付订单机制
- 缺少西班牙语版支付指引
- 未测试沙箱环境下的完整流程
- 忽略平台对 Efecty 订单的绩效考核指标（如发货时效）
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业