Efecty现金收款接口文档企业连锁门店详细解析
2026-02-24 3
详情
报告
跨境服务
文章
Efecty现金收款接口文档企业连锁门店详细解析
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的现金支付网络，支持消费者在实体连锁门店用现金完成线上订单支付。
- 跨境卖家可通过集成 Efecty 收款接口文档 实现自动对账与订单状态同步，适用于面向哥伦比亚市场的电商交易。
- 主要适用平台：自建站、本地化电商平台或通过支付网关（如Paddle、dLocal、Rapyd）接入的系统。
- 企业需具备合规主体资质，并遵循当地反洗钱与资金结算监管要求。
- 对接核心依赖 API 文档 中的支付创建、状态查询、回调通知等接口，建议进行沙箱测试后再上线。
- 常见失败原因包括：IP限制、签名错误、超时未支付、身份信息不匹配。
Efecty现金收款接口文档企业连锁门店详细解析 是什么
Efecty 是哥伦比亚领先的非银行支付网络，提供覆盖全国的现金收款服务。用户在线下单后，可凭生成的支付码到Efecty合作的连锁便利店（如D1、Alkosto、Éxito等）以现金付款，商家随后收到结算款项。
现金收款接口文档 指Efecty为商户提供的技术集成指南，包含API端点、请求参数、加密方式、回调机制等内容，用于实现订单创建、状态更新和财务对账自动化。
企业连锁门店 在此指Efecty的合作零售网点，作为线下收银终端承载现金收取职能，其分布密度高、覆盖城乡，提升无卡用户的购买转化率。
关键名词解释
- API 接口：应用程序编程接口，允许电商平台与Efecty系统通信，发送订单并获取支付结果。
- 回调通知（Webhook）：当用户完成现金支付后，Efecty服务器主动向商户系统推送支付成功信号。
- 支付凭证码（Payment Code）：一组数字编码或条形码，消费者凭此在门店完成缴费。
- 结算周期：指从用户支付到账款划入商户账户的时间，通常为T+1至T+3个工作日，依合同约定。
- 商户ID / API Key / Secret Key：身份认证凭据，用于调用接口时验证合法性。
它能解决哪些问题
- 痛点：哥伦比亚信用卡渗透率低 → 价值： 支持现金支付显著提升成单率，尤其适合大众消费品、家电、家具类目。
- 痛点：人工核销效率低 → 价值： 通过接口自动接收支付状态，减少客服介入与错漏对账。
- 痛点：订单长时间待支付 → 价值： 设置有效时限（通常24-72小时），提高资金流转效率。
- 痛点：跨境收款通道缺失 → 价值： 借助本地化支付方式降低拒付率，增强用户体验。
- 痛点：缺乏本地信任背书 → 价值： 使用知名连锁门店收款，增加买家安全感。
- 痛点：无法追踪付款来源 → 价值： 每笔支付绑定唯一订单号，便于财务审计与争议处理。
- 痛点：多渠道订单难统一管理 → 价值： 接口支持批量查询与异步通知，适配ERP或OMS系统集成。
怎么用/怎么开通/怎么选择
一、确认是否需要直接对接Efecty
- 若使用第三方支付平台（如dLocal、Rapyd、Paddle、Checkout.com），通常已内置Efecty选项，无需单独申请。
- 仅当自建支付系统或追求更高控制权时，才建议直接对接Efecty官方接口。
二、直接对接流程（常见做法）
- 注册企业账户：访问Efecty商业服务官网，提交公司注册文件、税务识别号（NIT）、法人身份证明、银行账户信息等资料。
- 签署合作协议：明确费率结构、结算周期、责任边界及数据使用条款。
- 获取测试环境权限：索取沙箱环境URL、测试商户ID与密钥，用于开发调试。
- 阅读并实现接口文档功能：重点实现以下接口：
- 创建支付单（POST /payments）
- 查询支付状态（GET /payments/{id}）
- 接收Webhook回调（需公网可访问地址）
- 退款申请（如有） - 完成技术联调：在沙箱环境中模拟全流程，确保支付码生成、状态变更、回调接收正常。
- 提交上线申请：通过技术验收后，切换至生产环境密钥，正式启用服务。
三、通过支付网关间接接入
- 选择支持Efecty的国际支付服务商（如dLocal）。
- 在其后台开启Efecty作为可用支付方式。
- 按照该平台提供的文档完成前端展示与后端通知配置。
- 利用统一API管理多种本地支付方式，降低维护成本。
费用/成本通常受哪些因素影响
- 月交易 volume（交易笔数或金额 tier）
- 单笔交易金额区间（阶梯定价）
- 是否使用高级功能（如即时通知、定制报表）
- 结算频率（每日/每周/每月）
- 币种转换需求（COP → USD）
- 退款处理费（如有）
- 违约金条款（如提前解约）
- 技术支持等级（标准支持 vs 专属客户经理）
- 是否存在最低月费（Minimum Monthly Fee）
- 接入方式（直连 vs 第三方网关附加服务费）
为了拿到准确报价/成本，你通常需要准备以下信息：
- 预估月均交易量与总金额
- 目标市场国家（仅限哥伦比亚？）
- 业务模式（B2C电商、订阅制、数字服务等）
- 网站或App流量情况
- 是否已有支付服务商
- 期望的结算周期与时效
- 技术团队对接能力说明
常见坑与避坑清单
- 未设置有效IP白名单：Efecty可能限制回调来源IP，导致通知失败，务必按文档配置。
- 忽略签名算法一致性：接口请求需用HMAC-SHA256等加密方式签名，前后端算法必须一致。
- 未处理异步通知丢失：Webhook可能因网络问题未送达，应定期轮询状态接口补单。
- 超时时间设置不合理：支付码一般有效期24-72小时，过长易被滥用，过短影响转化。
- 未校验回调数据真实性：必须验证签名与商户ID，防止伪造支付成功通知。
- 忽视本地合规要求：哥伦比亚要求保留交易记录至少5年，涉及GDPR类似法规。
- 测试不充分即上线：建议模拟各种异常场景（重复通知、网络中断、参数错误）。
- 依赖单一支付方式：建议同时接入Baloto、PSE等其他本地支付渠道，分散风险。
- 未监控结算延迟：定期比对Efecty对账单与实际到账金额，及时发现差异。
- 忽略语言本地化：支付页面与短信提示应使用西班牙语，避免理解偏差。
FAQ（常见问题）
- Efecty现金收款接口文档企业连锁门店详细解析 靠谱吗/正规吗/是否合规？
是的，Efecty是哥伦比亚合法注册的支付服务机构，受Superintendencia Financiera de Colombia监管，广泛用于公共服务与电商场景。 - Efecty现金收款接口文档企业连锁门店详细解析 适合哪些卖家/平台/地区/类目？
主要适合：
- 目标市场为哥伦比亚的中国跨境卖家
- 自建站或本地化电商平台（如TiendaNube）
- 销售中低价商品（50,000 - 2,000,000 COP）
- 家电、手机配件、家居、时尚服饰等类目 - Efecty现金收款接口文档企业连锁门店详细解析 怎么开通/注册/接入/购买？需要哪些资料？
需提供：
- 公司营业执照（或DBA）
- 法人身份证或护照
- 哥伦比亚税号（NIT），或可通过代理机构办理
- 对公银行账户信息
- 网站/App基本信息
- 技术联系人与运维邮箱 - Efecty现金收款接口文档企业连锁门店详细解析 费用怎么计算？影响因素有哪些？
费用通常基于交易金额比例收取，也可能含固定手续费。具体取决于交易量、行业类别、结算频率等因素。详细计价需联系官方或合作网关获取正式报价单。 - Efecty现金收款接口文档企业连锁门店详细解析 常见失败原因是什么？如何排查？
常见原因：
- 请求签名错误 → 核对密钥与加密逻辑
- IP不在白名单 → 提交白名单申请
- 参数缺失或格式错误 → 参照接口文档逐项检查
- 支付超时未完成 → 查看订单生命周期设置
- 回调地址不可达 → 使用公网可访问URL并开启日志监控 - 使用/接入后遇到问题第一步做什么？
首先查看API返回码与错误描述；其次检查请求日志与Webhook接收情况；然后登录Efecty商户后台查看订单状态；最后联系技术支持并提供Transaction ID、Timestamp、Request Payload等信息。 - Efecty现金收款接口文档企业连锁门店详细解析 和替代方案相比优缺点是什么？
对比 Baloto： Efecty门店更密集，尤其在中小城市；Baloto部分站点营业时间较短。
对比 PSE（在线银行转账）： Efecty无需网银，适合无卡人群；但PSE实时到账更快。
对比信用卡： Efecty转化率高但结算慢；信用卡即时确认但拒付率较高。 - 新手最容易忽略的点是什么？
一是忽视回调安全验证，导致虚假支付入账；二是未做沙箱全流程测试；三是不了解哥伦比亚节假日对结算的影响（如独立日、宗教节日可能导致延迟）。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业