Efecty现金收款接口文档开发者连锁门店怎么申请
2026-02-24 4
详情
报告
跨境服务
文章
Efecty现金收款接口文档开发者连锁门店怎么申请
要点速读(TL;DR)
- Efecty 是哥伦比亚主流的现金支付网络,支持消费者在实体门店用现金完成线上订单支付。
- 跨境卖家若想接入 Efecty 收款,需通过支持该方式的本地支付网关或收单机构进行集成。
- 目前 Efecty 不直接向境外商户开放接口申请,通常由拉美本地合作方或支付服务商代为对接。
- 开发者需获取 API 接口文档,完成技术对接,实现订单生成、状态查询等核心功能。
- 连锁门店无需单独申请,Efecty 本身已覆盖超 2 万家线下网点,系统自动分配可用付款点。
- 合规重点:确保交易信息可追溯,符合哥伦比亚金融监管要求,避免资金冻结风险。
Efecty现金收款接口文档开发者连锁门店怎么申请 是什么
Efecty 是哥伦比亚领先的非银行支付网络,提供现金收款服务。消费者在线下单后,可凭生成的条码或参考号,在 Efecty 合作的便利店、药房、超市等实体网点以现金支付订单金额。该服务广泛用于电商、账单缴纳、电信充值等场景。
关键词解释:
- 现金收款接口:指支付平台提供的 API 接口,允许电商平台动态生成支付凭证(如条码、参考号),并将支付状态回传给商户系统。
- 开发者:指负责技术对接的程序员或技术团队,需阅读并实现 API 文档中的调用逻辑。
- 接口文档:由支付服务商提供,包含请求地址、参数说明、签名规则、回调机制、错误码等开发必需信息。
- 连锁门店:Efecty 自身与多家零售品牌(如 Droguería La Rebaja、Exito、Alkosto)合作,形成覆盖全国的现金支付网络,商户无需自行签约门店。
它能解决哪些问题
- 痛点:哥伦比亚消费者信用卡渗透率低 → Efecty 提供现金支付选项,提升转化率。
- 痛点:国际支付方式在当地信任度不高 → 使用本地熟知的品牌门店支付,增强用户信心。
- 痛点:PayPal 或信用卡拒付率高 → 现金支付为预付费模式,无退款争议风险。
- 痛点:缺乏本地银行账户收款能力 → 通过第三方支付网关间接接收本地资金。
- 痛点:物流与支付不同步 → Efecty 支付成功后实时回调,便于触发发货流程。
- 痛点:技术团队不了解本地支付生态 → 借助成熟网关服务商降低接入门槛。
- 痛点:资金结算周期长 → 部分网关支持 T+1 或更短结算周期,改善现金流。
怎么用/怎么开通/怎么选择
一、确认是否需要 Efecty 收款
- 目标市场为哥伦比亚且主要客户为中低收入人群。
- 销售低价标品(如手机配件、日用百货),适合现金支付习惯。
- 已在使用 Mercado Libre、Linio 等拉美电商平台,或自建站面向哥国用户。
二、选择支持 Efecty 的支付服务商
常见路径:通过以下类型平台间接接入
- 本地收单机构:如 PSE Colombia(虽主推网银,但部分方案含 Efecty)。
- 全渠道支付网关:如Dlocal、PagueloFacil、PayU Latam、Conpay,均支持 Efecty 现金支付接入。
- 中国出海支付服务商:部分支持拉美本地支付方式聚合,需核实是否包含 Efecty。
三、注册并开通商户账户
- 访问选定支付服务商官网(如 Dlocal 商户后台)。
- 提交企业资料:营业执照、法人身份证、公司银行账户、网站/App 信息。
- 填写哥伦比亚业务相关信息(如有本地实体则更有利)。
- 签署服务协议,完成 KYC 审核。
- 申请开通 Efecty 支付方式权限(部分需单独申请)。
四、获取 Efecty 接口文档并开发对接
- 登录服务商后台,进入“开发者中心”或“API 文档”页面。
- 下载包含 Efecty 支付的 API 文档(通常为 PDF 或 Swagger 格式)。
- 关键接口包括:
- 创建现金支付订单(返回参考号和条码)
- 查询支付状态(轮询或 webhook 回调)
- 处理退款(如有) - 按文档要求实现签名加密、参数组装、异步通知处理。
- 在测试环境完成沙箱支付流程验证。
- 提交上线申请,切换至生产环境。
五、连锁门店是否需要申请?
不需要。Efecty 已与哥伦比亚超过 20,000 个线下网点合作,包括:
- Droguerías (药房)
- Supermercados (超市)
- Tiendas de conveniencia (便利店)
- Estaciones de servicio (加油站)
消费者在支付时会看到最近的可用门店列表,系统自动分配,商户无需单独签约或管理门店。
费用/成本通常受哪些因素影响
- 商户所属行业类目(高风险类目费率更高)
- 月交易 volume(交易量越大议价空间越大)
- 是否拥有哥伦比亚本地公司主体
- 结算币种(COP vs USD)及结算频率
- 所选支付服务商的定价模型(固定费率 + 每笔费用)
- 是否包含欺诈检测、反洗钱风控模块
- 技术支持等级(标准支持 vs VIP 专属服务)
- 是否有跨境提现需求及通道成本
为了拿到准确报价,你通常需要准备以下信息:
- 预计月交易笔数与金额
- 目标国家与币种
- 网站/App 日均 UV/PV
- 历史拒付率数据(如有)
- 是否已有本地银行账户
- 技术对接方式(API 直连 or 插件嵌入)
常见坑与避坑清单
- 误以为 Efecty 可直接注册:实际必须通过第三方网关,建议优先联系 Dlocal 或 PayU。
- 忽略支付时效限制:Efecty 订单通常有 24-72 小时付款有效期,超时未付需重新生成。
- 未设置有效回调通知:导致无法自动确认收款,影响发货效率。
- 参考号生成规则错误:不符合 Efecty 编码规范会导致门店无法识别。
- 未做多语言提示:应向用户清晰展示西班牙语版支付指引。
- 忽视对账差异:现金支付可能存在延迟入账,需建立每日对账机制。
- 跳过沙箱测试:正式上线前务必完成全流程测试。
- 未保留原始交易日志:一旦发生争议,需提供完整 API 请求响应记录。
FAQ(常见问题)
- Efecty现金收款接口文档开发者连锁门店怎么申请 靠谱吗/正规吗/是否合规?
Efecty 是哥伦比亚合法运营的支付网络,受 Superintendencia Financiera de Colombia 监管。通过正规支付网关接入即合规,资金流向可追踪,建议选择有 PCI DSS 认证的服务商。 - Efecty现金收款接口文档开发者连锁门店怎么申请 适合哪些卖家/平台/地区/类目?
适合面向哥伦比亚市场的跨境电商卖家,尤其是自建站、独立站、SaaS 商城;适用类目包括电子产品、时尚服饰、家居用品等低价高频商品。不建议高单价或易产生纠纷的商品使用。 - Efecty现金收款接口文档开发者连锁门店怎么申请 怎么开通/注册/接入/购买?需要哪些资料?
需通过支付网关(如 Dlocal)注册商户账号,提交营业执照、法人身份证明、银行账户信息、网站域名/App 包名、业务描述等。部分服务商要求提供哥伦比亚本地联系人或税务编号(RUT)。 - Efecty现金收款接口文档开发者连锁门店怎么申请 费用怎么计算?影响因素有哪些?
费用由支付服务商收取,一般为交易金额的百分比 + 固定手续费。影响因素包括交易量、行业风险、结算周期、是否有本地实体等。具体费率需向服务商索取报价单。 - Efecty现金收款接口文档开发者连锁门店怎么申请 常见失败原因是什么?如何排查?
常见原因:API 签名错误、参数缺失、网络超时、订单过期、门店系统故障。排查步骤:检查请求日志、验证签名算法、确认时间戳同步、查看服务商状态页、联系技术支持提供 reference ID。 - 使用/接入后遇到问题第一步做什么?
首先检查服务商提供的“交易详情”页面或日志系统,确认错误码;其次核对 API 调用是否符合最新文档;最后通过官方客服渠道提交工单,附上 request ID 和 timestamp。 - Efecty现金收款接口文档开发者连锁门店怎么申请 和替代方案相比优缺点是什么?
对比 Baloto:两者均为现金支付,Efecty 门店密度略高,但 Baloto 更早被 PayU 支持;对比 PSE:PSE 为网银转账,需有本地银行卡,覆盖率低于现金;对比信用卡:Efecty 无拒付风险,但到账慢 1-2 天。 - 新手最容易忽略的点是什么?
一是未设置自动订单关闭机制(超时未付);二是未实现异步通知(webhook)导致人工对账;三是忽略西班牙语用户引导文案;四是未测试退款流程;五是以为“连锁门店”要自己去谈合作。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业

