Efecty现金充值接口文档企业连锁门店怎么开通

2026-02-24 3

详情

报告

跨境服务

文章

Efecty现金充值接口文档企业连锁门店怎么开通

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，支持消费者在线下单后在实体门店用现金完成支付。
企业若想接入 Efecty 现金充值服务，需通过支付网关或本地收单机构申请API接口权限。
连锁门店无需单独开通——作为收款终端存在，关键在于商户主体与支付系统的对接。
接入核心步骤：注册本地支付服务商账户 → 提交企业资质 → 技术对接API文档 → 测试上线。
常见失败原因包括资质不全、税务信息不符、技术回调配置错误。
建议通过已集成Efecty的SaaS平台或本地合作银行加快接入流程。

Efecty现金充值接口文档企业连锁门店怎么开通是什么

Efecty 是哥伦比亚领先的非银行现金支付网络，覆盖超过18,000个线下网点（如Alkosto、Éxito超市、D1超市等），允许用户在线生成付款码后到店以现金结算订单。该系统广泛用于电商、账单缴纳和金融服务。

现金充值接口文档 指由Efecty或其授权支付网关提供的API技术文档，包含请求参数、签名规则、异步通知机制、状态查询方式等，供企业系统对接使用。

企业连锁门店 在此场景中通常指作为现金收款终端存在的零售网点，并非主动“开通”接口的一方；真正需要开通的是商户/电商平台，以便为用户提供Efecty支付选项。

涉及的关键名词解释

API接口：应用程序编程接口，用于实现电商平台与Efecty支付系统的数据交互。
支付网关：中介平台（如PayU Latam、Mercado Pago、Red Pagos），聚合多种本地支付方式并提供统一接入方案。
回调通知（Callback）：支付完成后，Efecty向商户服务器发送支付结果的通知URL，必须正确配置以更新订单状态。
RUT：哥伦比亚企业唯一税务识别号，注册时必备。
PSE：哥伦比亚在线银行转账系统，常与Efecty并列作为本地支付方式之一。

它能解决哪些问题

痛点：目标市场银行卡渗透率低 → 价值：哥伦比亚约40%成年人无银行卡，Efecty扩展了现金用户的购买能力。
痛点：跨境支付拒付率高 → 价值：现金预付，资金即时锁定，降低信用风险和欺诈交易。
痛点：本地化体验差 → 价值：提供本地熟悉的支付方式，提升转化率（据部分卖家反馈可提高15%-25%）。
痛点：清关缴税不便 → 价值：可用于缴纳进口相关税费（通过特定渠道），简化履约流程。
痛点：物流末端代收难 → 价值：结合货到付款替代方案，避免配送失败。
痛点：缺乏本地收款账户 → 价值：通过第三方支付网关间接支持Efecty，无需自建本地公司也可接入。
痛点：对账复杂 → 价值：支付网关提供统一结算报表，整合多支付方式流水。
痛点：合规门槛高 → 价值：合规责任转移至持牌支付服务商，降低商户直接监管压力。

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

企业无法直接从Efecty官网申请API接口，必须通过其认证的支付服务提供商（PSP）进行接入。以下是典型流程：

选择支持Efecty的支付网关
- 常见平台：PayU Colombia、Mercado Pago、Kushki、Afinia、Transbank（拉美区域性网关）。
- 评估标准：是否支持人民币结算、是否有中文技术支持、是否已与中国电商平台（如Shopify、Magento、自研系统）有插件集成。
注册商户账户
- 访问所选支付网关官网，进入商户入驻页面。
- 填写企业基本信息：公司名称、RUT（或外国企业等效税号）、营业执照扫描件、法人身份证件、网站域名、预计月交易额。
- 若为中国企业出海，需提供海外注册证明或授权代理文件（视网关要求而定）。
提交审核材料
- 通常包括：银行对公账户证明、经营类目说明、商品详情页截图、隐私政策与退货政策链接。
- 部分网关要求视频验证或电话回访。
签署协议并获取API密钥
- 审核通过后，签署电子服务协议。
- 登录后台获取Merchant ID、API Key、Private Key 及 Callback URL 配置入口。
技术对接接口文档
- 下载对应网关的Efecty支付接口文档（通常为PDF或Swagger格式）。
- 开发人员实现以下功能：
  - 创建支付订单（含金额、货币COP、客户信息、过期时间）
  - 接收并验证异步通知（Callback）
  - 查询支付状态接口调用
  - 前端展示Efecty支付选项及付款码
测试与上线
- 使用沙箱环境模拟完整支付流程。
- 确认回调处理逻辑稳定、订单状态同步准确。
- 提交上线申请，切换至生产环境。

注意：连锁门店本身不需要操作任何开通动作，只需确保在Efecty合作网络列表内即可接受现金充值。商户可通过网关后台查看支持门店地图链接，供用户查找。

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

商户所属行业类目（高风险类目费率更高）
月均交易量（交易越多议价空间越大）
是否为跨境商户（外籍主体可能附加服务费）
结算周期（T+7比T+14手续费高）
币种转换需求（COP转USD是否存在汇损）
是否使用网关提供的防欺诈模块
是否有定制化开发支持需求
退款频率与处理成本
是否需开具本地合规发票
技术对接复杂度（如多系统集成）

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

企业注册地与运营国家
电商平台类型（自建站/Magento/Shopify等）
预期月交易笔数与平均客单价（COP）
主要销售品类
是否已有本地公司或银行账户
是否需要多语言客服支持
希望的结算货币与频次

常见坑与避坑清单

误以为Efecty可直接签约：实际必须经由PSP接入，提前联系网关而非Efecty总部。
忽略税务合规要求：哥伦比亚对数字服务征收19% VAT，部分网关会代扣，需明确责任方。
Callback未做签名校验：易被伪造通知导致虚假发货，务必验证签名字段（signature或hash）。
未设置订单有效期：Efecty付款码通常24-72小时失效，超时应自动取消订单。
地址填写不符合本地格式：导致无法生成有效票据，影响门店收款确认。
未监控支付成功率：定期检查失败日志，识别参数缺失或网络超时问题。
忽视用户指引设计：未清晰展示如何找门店、打印付款单，增加客服压力。
使用过期接口版本：升级时不及时跟进文档变更，造成中断。
未测试异常场景：如用户重复支付、部分支付、门店拒收等情况下的处理流程。
依赖单一支付通道：建议同时接入PSE、Baloto等其他本地方式分散风险。

FAQ（常见问题）

Efecty现金充值接口文档企业连锁门店怎么开通靠谱吗/正规吗/是否合规？
是正规支付方式，由哥伦比亚金融监管局（Superintendencia Financiera de Colombia）监管，通过持牌支付网关接入即符合当地合规要求。
Efecty现金充值接口文档企业连锁门店怎么开通适合哪些卖家/平台/地区/类目？
适用于面向哥伦比亚消费者的跨境电商卖家，特别是自建站、独立站、B2C电商平台；热销类目如3C配件、时尚服饰、家居用品较适用；不适合虚拟币、赌博、成人内容等受限行业。
Efecty现金充值接口文档企业连锁门店怎么开通怎么开通/注册/接入/购买？需要哪些资料？
需通过支付网关（如PayU）注册商户账号，提交企业营业执照、法人证件、RUT或等效税号、网站信息、银行账户证明等。连锁门店无需单独注册。
Efecty现金充值接口文档企业连锁门店怎么开通费用怎么计算？影响因素有哪些？
费用由支付网关收取，一般按交易金额百分比+固定费计价，具体取决于行业、交易量、结算周期等因素，详细结构需与网关协商确定。
Efecty现金充值接口文档企业连锁门店怎么开通常见失败原因是什么？如何排查？
常见原因：企业资质不完整、RUT验证失败、Callback地址无法访问、IP未加入白名单、签名算法错误。排查建议：检查提交材料完整性、测试回调连通性、核对API文档中的加密方式。
使用/接入后遇到问题第一步做什么？
首先查看支付网关提供的交易日志与错误代码，确认是前端跳转、后端通知还是结算问题；然后联系网关技术支持，提供Order ID、Transaction ID、时间戳等信息。
Efecty现金充值接口文档企业连锁门店怎么开通和替代方案相比优缺点是什么？
对比Baloto：两者均为现金支付，但Efecty门店密度略高；对比PSE：PSE为网银转账，支付更快但需银行卡；对比信用卡：Efecty无拒付风险但到账慢（通常1-2个工作日）。综合来看，Efecty更适合无卡人群。
新手最容易忽略的点是什么？
一是未配置安全的Callback验证机制，二是未告知用户“必须打印付款单”或“仅限本人支付”，三是忽略对账单中的手续费明细核对，四是未设置支付超时自动取消策略。