Efecty现金取现API接入教程开发者Marketplace平台费率说明
2026-02-24 1
详情
报告
跨境服务
文章
Efecty现金取现API接入教程开发者Marketplace平台费率说明
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的现金支付网络，支持消费者在线下单后线下现金付款，常用于本地化支付场景。
- 其 现金取现API 允许电商平台或ERP系统对接生成付款凭证（含条码或二维码），供买家在便利店、超市等网点现金支付。
- 主要面向在拉美（尤其是哥伦比亚）开展业务的跨境卖家、独立站运营者、平台开发者。
- 接入需通过官方或第三方支付网关进行API集成，涉及身份认证、商户资质审核和合规审查。
- 平台费率通常由交易手续费、提现费用、汇率转换费构成，具体以合同或结算页面为准。
- 常见坑包括：未完成KYC验证、回调通知配置错误、未处理退款流程、对账不及时。
Efecty现金取现API接入教程开发者Marketplace平台费率说明 是什么
Efecty 是哥伦比亚领先的非银行支付网络，覆盖超1万家线下网点（如Alkosto、Éxito、D1超市等），用户可在线生成账单并前往门店用现金支付。该服务广泛应用于电商、电信、公共服务等领域。
现金取现API 指 Efecty 提供给开发者的程序接口（Application Programming Interface），允许 Marketplace、SaaS 系统或独立站自动创建支付订单、获取支付凭证（参考号/条形码）、接收支付状态回调，实现与Efecty系统的自动化对接。
Marketplace平台费率说明 指使用Efecty作为支付渠道时，平台方（或支付服务商）向商户收取的服务费用结构，通常包含交易处理费、资金结算费、异常处理费等。
关键名词解释
- API：应用程序接口，用于两个系统间数据交互。例如：你的订单系统调用Efecty API生成一个可线下支付的账单。
- 现金取现：用户获得一个支付编号或二维码，在指定实体网点用现金完成支付，资金随后结算给商户。
- KYC：了解你的客户（Know Your Customer），指注册时提交企业营业执照、法人身份、银行账户等资料以通过合规审核。
- 回调通知（Webhook）：当用户完成支付后，Efecty服务器主动向你的系统发送支付成功消息，用于更新订单状态。
- 收单机构 / 支付网关：部分情况下你无法直接对接Efecty，需通过本地持牌支付服务商（如Paddle、dLocal、PayU Latam）间接接入。
它能解决哪些问题
- 痛点：哥伦比亚消费者信用卡渗透率低 → 价值：支持现金支付提升转化率。超过60%的哥伦比亚网购人群依赖现金支付方式。
- 痛点：跨境支付拒付率高 → 价值：本地化支付降低风控风险。Efecty为本地成熟体系，减少国际卡拒付争议。
- 痛点：独立站缺乏本地支付选项 → 价值：增强信任感与购买意愿。显示Efecty标识可提高本地用户下单信心。
- 痛点：手动开票效率低易出错 → 价值：API自动化生成支付凭证。每笔订单实时生成唯一参考码，避免人工干预。
- 痛点：资金到账慢且难对账 → 价值：提供清晰结算周期与交易报告。多数服务商支持T+1~T+3结算，并提供CSV对账文件。
- 痛点：多平台订单分散 → 价值：统一接入支付状态同步至ERP。可通过API将支付结果回传至内部系统，实现库存自动扣减。
- 痛点：退款流程复杂 → 价值：明确退款规则与原路返还机制。已支付订单可在规定时间内发起线上退款请求。
- 痛点：语言与合规障碍 → 价值：通过本地合作伙伴完成税务与金融合规申报。部分支付网关承担当地合规责任。
怎么用/怎么开通/怎么选择
步骤1：确认是否可以直接接入或需通过支付网关
Efecty 官方通常不直接向境外中小卖家开放API权限。你需要：
- 检查是否已有合作的拉美本地支付服务商（如 dLocal、PayU Latam、Mercado Pago、Paddle）支持Efecty通道；
- 若无，则联系具备哥伦比亚收单资质的服务商申请接入；
- 注意：部分服务商要求企业注册地在特定国家或拥有本地公司主体。
步骤2：准备商户入驻材料（KYC）
常见所需资料包括：
- 企业营业执照扫描件（中英文或西语翻译公证件）；
- 法人身份证或护照；
- 银行账户信息（支持美元或COP比索结算）；
- 网站域名及产品类目说明；
- 月均交易预估量与客单价；
- 反洗钱合规声明表（AML/KYC表格）。
步骤3：技术对接API
- 获取服务商提供的 API文档（含测试环境Endpoint、认证方式、参数列表）；
- 在沙箱环境中测试创建订单（POST /payments）；
- 解析返回的 referenceCode 和 barcode 或 qr_string；
- 前端展示支付凭证供买家打印或扫码；
- 配置 Webhook URL 接收支付成功通知；
- 上线前完成至少10笔模拟交易验证全流程。
步骤4：上线与监控
- 切换至生产环境，启用正式交易；
- 每日核对结算报表与内部订单状态；
- 设置异常订单报警机制（如超时未支付、回调失败）；
- 定期审查退款请求并遵循服务商时限要求。
费用/成本通常受哪些因素影响
- 商户所属行业类目（高风险类目费率更高）；
- 月交易流水规模（高 volume 可协商折扣）；
- 结算币种（USD vs COP）及汇率加点；
- 是否使用第三方支付网关（叠加服务费）；
- 提现频率与单笔金额（批量提现更便宜）；
- 退款率水平（过高可能触发风控审查）；
- 技术对接模式（自研开发 or 使用插件/SaaS方案）；
- 是否需要多语言客服支持；
- 合同签约主体所在地（离岸公司 vs 哥伦比亚本地实体）；
- 是否有反欺诈保障服务附加。
为了拿到准确报价/成本，你通常需要准备以下信息：
- 目标市场（仅哥伦比亚 or 多国）；
- 预计月交易笔数与总金额；
- 主营类目（如电子产品、服饰、虚拟商品）；
- 现有技术栈（PHP/Python/Shopify/WooCommerce）；
- 是否已有支付服务商合作关系；
- 期望的结算周期（T+1, T+3, 周结）；
- 是否需要发票或税务合规支持。
常见坑与避坑清单
- 未完成KYC即开始调试API → 导致测试订单无效或无法转正式环境，建议提前提交资料并等待审核通过。
- 忽略Webhook安全验证 → 未校验签名可能导致虚假回调伪造支付记录，务必验证X-Signature头或HMAC。
- 未设置订单有效期 → Efecty账单通常72小时内有效，超时需重新生成，应在前端提示用户及时支付。
- 未处理异步通知失败情况 → 网络中断可能导致支付成功但未收到回调，应建立定时对账任务查询待确认订单。
- 直接暴露referenceCode给前端 → 存在被篡改风险，应在后端存储并与订单绑定，防止重复使用。
- 忽视退款时效限制 → 部分服务商要求在支付后24小时内发起退款才支持原路返还，逾期需人工打款。
- 未测试小语种界面兼容性 → 西班牙语文案显示乱码会影响用户体验，确保UTF-8编码与字体适配。
- 跳过沙箱测试直接上线 → 极易造成资金损失或客户投诉，必须完整走通测试流程。
- 未保留原始日志 → 出现纠纷时无法提供证据链，建议保存至少6个月的请求/响应日志。
- 低估本地合规复杂度 → 哥伦比亚有ICBP税（增值税）、数据保护法（Law 1581），建议咨询本地法律顾问。
FAQ（常见问题）
- Efecty现金取现API接入教程开发者Marketplace平台费率说明靠谱吗/正规吗/是否合规？
是的，Efecty是哥伦比亚金融监管局（Superintendencia Financiera de Colombia）认可的支付服务机构，合法运营多年。但跨境接入需通过合规持牌收单方，确保资金路径合法。 - 适合哪些卖家/平台/地区/类目？
适用于面向哥伦比亚消费者的跨境电商卖家，特别是独立站、B2C平台、数字商品或高单价实物商品卖家。不适合禁售品类（如药品、武器）及纯B2B大额交易。 - 怎么开通/注册/接入/购买？需要哪些资料？
一般通过支付网关（如dLocal、PayU）开通。需提供企业执照、法人证件、银行信息、网站链接、业务描述等。个人卖家通常无法直接接入。 - 费用怎么计算？影响因素有哪些？
费用结构由交易手续费（百分比+固定费）、提现费、汇率服务费组成。具体取决于交易量、类目、结算频率和服务商政策，以合同为准。 - 常见失败原因是什么？如何排查？
常见原因：- API密钥错误或权限不足；
- 参数格式不符合规范（如日期格式、字符编码）；
- 订单金额超出限额；
- Webhook地址不可达；
- KYC未完成或信息不一致。
- 使用/接入后遇到问题第一步做什么？
首先检查服务商提供的开发者文档和状态码说明，确认错误类型；其次登录商户后台查看交易详情；最后携带request_id和时间戳联系客服或技术支持。 - 和替代方案相比优缺点是什么？
对比PSE（网银转账）、Baloto（另一现金支付网络）：- 优点：网点更多、操作简便、消费者认知度高；
- 缺点：仅限哥伦比亚、需本地合作方、结算周期较长。
- 新手最容易忽略的点是什么？
一是回调通知的安全验证，二是订单有效期管理，三是未建立对账机制导致资金差异。建议从最小可行流程开始测试，逐步扩展功能。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业