Efecty现金收款API接入教程企业Marketplace平台怎么申请
2026-02-24 2
详情
报告
跨境服务
文章
Efecty现金收款API接入教程企业Marketplace平台怎么申请
要点速读(TL;DR)
- Efecty 是哥伦比亚主流的现金支付网络,支持消费者在线下单后线下网点现金付款。
- 跨境企业可通过接入 Efecty API 实现订单与支付状态自动同步,提升本地转化率。
- 主要适用于面向哥伦比亚消费者的电商平台或自建站卖家。
- 需通过具备拉美支付集成资质的第三方支付网关(如Paddle、dLocal、PayU Latam)间接接入Efecty。
- 企业需准备公司注册文件、税务信息、银行账户及合规KYC材料。
- 直接申请Efecty商户接口对非本地企业难度较高,建议通过已合作的收单机构或SaaS平台接入。
Efecty现金收款API接入教程企业Marketplace平台怎么申请 是什么
Efecty 是哥伦比亚领先的现金收款服务提供商,覆盖超1万家线下支付点(便利店、超市、药店等),允许用户在电商平台下单后生成Efecty付款码,凭码在指定网点以现金完成支付。
现金收款API 指Efecty提供的程序化接口,允许电商平台或支付网关将订单信息发送至Efecty系统,并实时获取支付状态回调,实现自动化对账和订单履约。
企业Marketplace平台 泛指B2C或多商户电商平台(如Mercado Libre、Linio或自建平台),需集成本地化支付方式以服务特定区域消费者。
关键名词解释
- API接入:应用程序接口对接,实现系统间数据交互。例如订单创建、支付状态查询。
- KYC:Know Your Customer,企业身份验证流程,通常包括营业执照、法人证件、银行证明等。
- 收单机构(Acquirer):处理交易结算的金融机构或支付服务商,如dLocal、PayU。
- 支付网关:连接电商平台与多种支付方式的技术中间层,常集成Efecty等本地支付方式。
- 回调通知(Webhook):支付成功后,Efecty向商户服务器发送支付结果的通知机制。
它能解决哪些问题
- 痛点:哥伦比亚信用卡渗透率低 → 价值:提供现金支付选项,扩大客群覆盖。
- 痛点:手动核销现金付款效率低 → 价值:API自动同步支付状态,减少人工对账。
- 痛点:消费者因无本地支付方式放弃下单 → 价值:提升结账转化率,降低购物车流失。
- 痛点:跨境支付拒付率高 → 价值:本地现金支付无拒付风险,资金更安全。
- 痛点:平台需支持多支付渠道管理 → 价值:通过统一支付网关集成Efecty及其他拉美支付方式。
- 痛点:新进入拉美市场缺乏本地收单能力 → 价值:借助第三方服务商快速上线本地支付。
- 痛点:订单延迟发货影响评分 → 价值:实时支付确认加快履约速度。
- 痛点:财务对账复杂 → 价值:API提供标准化交易记录,便于自动化记账。
怎么用/怎么开通/怎么选择
一、通过支付网关间接接入Efecty(推荐路径)
- 选择支持Efecty的支付服务商:如dLocal、Paddle、PayU Latam、Rapyd等,确认其在哥伦比亚支持Efecty现金支付。
- 注册企业商户账号:提交公司营业执照、法人身份证、银行账户信息、网站URL、业务模式说明等。
- 完成KYC审核:根据服务商要求上传公证文件、税务登记证(如RUT)、公司章程等,部分需视频验证。
- 技术对接API:获取支付网关提供的文档,集成其API以创建Efecty支付请求,设置Webhook接收支付通知。
- 测试环境调试:使用沙箱环境模拟订单生成、支付、回调全流程,确保状态同步准确。
- 上线生产环境:通过审核后启用正式交易,监控首周支付成功率与异常情况。
二、直接申请Efecty企业合作(难度较高)
据公开信息,Efecty主要面向本地企业开放直连,外资企业直接签约门槛高,常见做法:
- 需在哥伦比亚注册实体公司并持有当地银行账户。
- 联系Efecty商务团队(comercial@efecty.com.co)提交合作意向书。
- 签署服务协议并通过技术评估。
- 自行开发API对接,遵循其技术规范文档。
- 多数中国跨境企业不具本地实体,此路径可行性较低,建议优先走第三方网关。
三、Marketplace平台入驻申请
若你是企业欲入驻支持Efecty的电商平台(如Mercado Libre Colombia),流程如下:
- 访问平台官网(如mercadolibre.com.co)注册企业卖家账号。
- 选择“成为卖家”或“Vender en Mercado Libre”,提交公司资料。
- 完成税务信息登记(需提供RUT税号)。
- 绑定收款账户(可为本地银行或通过支付网关中转)。
- 上架商品并选择启用Efecty作为支付方式(平台默认集成)。
- 遵守平台佣金政策与物流规则(如Fulfillment by ML)。
费用/成本通常受哪些因素影响
- 交易手续费率(按笔或按比例,由支付网关或平台收取)
- 是否使用本地清结算通道
- 月交易 volume 等级(高量级可能享折扣)
- 币种转换成本(COP→USD/CNY)
- 支付网关基础服务费或月租
- KYC审核附加费用(如文件翻译、公证)
- 技术支持服务费(如定制开发)
- 退款处理费用
- 汇率波动风险承担方
- 平台佣金(如Mercado Libre约12%-18%)
为了拿到准确报价,你通常需要准备以下信息:
- 预计月交易笔数与金额
- 目标国家与币种
- 网站或App流量数据
- 历史拒付率(如有)
- 业务类目(如电子、时尚、健康)
- 是否已有支付服务商
- 技术对接方式(API/插件/托管页面)
常见坑与避坑清单
- 误以为可直接注册Efecty商户:中国公司无法直接签约,必须通过第三方。
- 忽略KYC材料本地化要求:部分文件需西班牙语翻译及海牙认证。
- 未配置Webhook回调地址:导致无法自动确认付款,延误发货。
- 测试不充分即上线:沙箱环境必须完整走通失败、超时、重复通知场景。
- 忽视支付有效期:Efecty付款码通常24-72小时有效,需提示用户及时支付。
- 未监控支付成功率:定期检查API响应码与用户投诉,排查集成问题。
- 选择不支持Efecty的支付网关:接入前务必确认该网关在哥伦比亚支持Efecty。
- 忽略平台合规要求:如Mercado Libre要求商品标签符合当地法规。
- 资金提现周期不清:了解结算周期(T+7/T+15)及最低起付额。
- 未保留原始交易日志:争议处理需提供API请求与响应原始记录。
FAQ(常见问题)
- Efecty现金收款API接入教程企业Marketplace平台怎么申请 靠谱吗/正规吗/是否合规?
是正规支付方式。Efecty受哥伦比亚金融监管局(Superintendencia Financiera de Colombia)监管,合规运营。通过持牌支付网关接入可保障交易合法性。 - 适合哪些卖家/平台/地区/类目?
适合面向哥伦比亚消费者的跨境电商,尤其是电子、家电、时尚、家居类目。适用于自建站、独立站或入驻Mercado Libre等本地平台的企业卖家。 - 怎么开通/注册/接入/购买?需要哪些资料?
通过dLocal、PayU等支持Efecty的支付网关注册企业账户。需准备:
- 营业执照中英文公证件
- 法人护照或身份证
- 公司银行账户证明
- 网站/App截图
- 业务描述与预期交易量
- 哥伦比亚税务RUT(若本地注册) - 费用怎么计算?影响因素有哪些?
费用由支付网关或平台决定,通常包含交易手续费、外汇损益、月费等。影响因素包括交易量、类目风险等级、结算周期、币种、是否含发票服务等。具体以服务商合同为准。 - 常见失败原因是什么?如何排查?
常见原因:
- API密钥错误或权限不足
- 回调地址无法访问(防火墙阻挡)
- 订单金额超出限制
- 客户端未在有效期内完成支付
- KYC审核未通过
排查方法:查看API返回码、检查日志、联系支付网关技术支持。 - 使用/接入后遇到问题第一步做什么?
首先检查API文档中的错误代码表,确认请求参数格式正确;其次验证Webhook是否收到通知;最后联系支付服务商客服,提供订单ID、时间戳、请求ID等信息。 - 和替代方案相比优缺点是什么?
对比PSE(网银转账):Efecty无需网银,适合无卡人群,但需线下支付;PSE即时到账但覆盖率低。
对比Baloto:两者均为现金支付,Efecty网点略少但系统稳定性较好。
对比信用卡:Efecty无拒付风险,但结算周期长(1-3天)。 - 新手最容易忽略的点是什么?
忽略支付时效性管理——未提醒用户在24小时内完成现金支付;未设置订单超时自动取消机制;未做多语言(西语)支付页面适配;以及未测试沙箱环境中的异常流程(如支付失败、重复通知)。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业

