Efecty现金收款API接入教程商家独立站详细解析
2026-02-24 3
详情
报告
跨境服务
文章
Efecty现金收款API接入教程商家独立站详细解析
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的线下现金支付网络，适合无银行卡用户通过便利店、超市等网点完成付款。
- 支持独立站接入其 API 收款接口，实现订单状态同步与自动化对账。
- 主要面向在拉美市场销售、尤其是针对哥伦比亚消费者的中国跨境卖家。
- 需技术对接 API 并配置回调（Webhook），确保订单状态实时更新。
- 资金结算周期较长（通常3-7个工作日），且需依赖本地合作银行或支付服务商归集资金。
- 合规要求高：需具备当地注册实体或通过持牌支付机构代理接入。
Efecty现金收款API接入教程商家独立站详细解析 是什么
Efecty 是哥伦比亚领先的非银行支付网络，提供广泛的线下现金收款服务。消费者可通过 Efecty 合作的便利店、药店、超市等数千个网点以现金支付账单或在线购物订单。
现金收款API 指的是 Efecty 提供给电商平台或独立站的技术接口，允许商家系统与其支付网关进行数据交互，包括创建支付订单、查询支付状态、接收支付成功通知等功能。
商家独立站 通常指使用 Shopify、ShopBase、自建站等平台搭建的 DTC（Direct-to-Consumer）网站。接入 Efecty API 可让哥伦比亚买家在结账时选择“Efecty 现金支付”，生成唯一支付码后到线下网点缴费完成交易。
关键名词解释
- API 接口：应用程序编程接口，用于两个系统间的数据通信。此处指商家系统与 Efecty 支付系统的连接通道。
- Webhook 回调：当用户完成现金支付后，Efecty 主动向商家服务器发送支付结果通知，用于自动标记订单为已付款。
- 支付网关：处理支付请求的中间层服务，负责加密、路由和验证交易信息。
- 本地收单：由当地金融机构或支付机构作为商户入网主体，完成资金清算的过程。Efecty 不直接对接境外企业，通常需本地收单方参与。
- 支付凭证（Código de Pago）：生成的条形码或数字代码，消费者凭此在 Efecty 网点支付现金。
它能解决哪些问题
- 痛点：哥伦比亚信用卡渗透率低 → 价值：覆盖超60%无卡人群，扩大目标客户群体。
- 痛点：PayPal 或国际信用卡拒付率高 → 价值：现金支付不可逆，降低欺诈与争议风险。
- 痛点：本地化支付方式缺失 → 价值：提升转化率，增强消费者信任感。
- 痛点：传统银行转账效率低 → 价值：Efecty 网点多、操作便捷，缩短支付路径。
- 痛点：订单状态人工核对耗时 → 价值：API 实现自动化对账，减少运营成本。
- 痛点：资金回流困难 → 价值：通过合作银行或支付服务商实现外汇结算（需第三方支持）。
- 痛点：缺乏本地支付品牌背书 → 价值：Efecty 品牌认知度高，提高下单意愿。
怎么用/怎么开通/怎么选择
一、确认是否符合接入条件
- 目标市场为哥伦比亚，且主要客户为个人消费者（B2C）。
- 拥有可开发调试的技术团队或外包资源，能处理 API 对接。
- 已部署 HTTPS 安全协议的独立站，支持动态生成订单编号与金额。
- 具备本地合作方（如注册公司、代理收单机构）或通过聚合支付服务商间接接入。
二、获取 Efecty 商户资质（常见做法）
- 联系 Efecty 官方或其授权合作伙伴（如 dLocal、Paddle、Rapyd、Checkout.com）提交商户资料。
- 提供企业营业执照、税务登记、法人身份证明、网站域名及隐私政策链接。
- 签署服务协议，明确责任划分与结算周期。
- 获得测试环境 API Key、商户 ID 和回调地址配置权限。
三、技术对接流程
- 阅读 Efecty 提供的 API 文档（通常为西班牙语 + 英文），了解认证方式（如 OAuth、HMAC-SHA256）、请求格式与错误码。
- 在后台系统中集成 Create Payment Request 接口，传入订单号、金额、货币（COP）、过期时间、返回URL等参数。
- 接收 Efecty 返回的 Pago Código 和二维码，展示给用户并提示前往线下网点支付。
- 配置 Webhook URL，用于接收支付成功/失败的通知（建议启用签名验证防止伪造）。
- 在收到通知后更新订单状态，并触发发货流程。
- 进入生产环境前，在沙箱环境中完成全流程测试（含超时、重复通知等异常场景）。
四、上线后运维管理
- 定期检查 Webhook 是否正常接收消息，设置失败重试机制。
- 监控支付成功率、平均支付时长、退款请求等指标。
- 与本地合作方保持沟通，及时处理结算延迟或争议订单。
- 保留完整的日志记录，满足财务审计与合规审查要求。
费用/成本通常受哪些因素影响
- 交易手续费率（按笔或按比例，取决于合同谈判）
- 是否通过第三方支付平台（如 dLocal）接入，叠加服务费
- 月交易量规模，大额可能享受费率优惠
- 结算频率（T+3, T+5, T+7）与币种转换成本
- 是否有最低月费或年费
- 技术支持等级（是否包含专属客户经理）
- 是否需要定制化开发或额外安全认证
- 退款处理费用（如有）
- 汇率加价点差（由收单行或支付网关设定）
- 本地合规备案成本（如需设立实体）
为了拿到准确报价/成本，你通常需要准备以下信息：
- 预计月均交易笔数与总金额
- 商品类目（高风险类目可能被拒或加收费用）
- 网站流量来源与转化路径说明
- 已有支付方式分布情况
- 是否已有本地银行账户或收单通道
- 技术对接能力评估（能否自主开发）
常见坑与避坑清单
- 未核实本地收单要求：Efecty 不直接服务外国企业，必须通过本地实体或持牌机构代理，否则无法开通。
- 忽略 Webhook 验证机制：未校验通知来源可能导致虚假支付状态更新，造成误发货行为。
- 未设置订单有效期：Efecty 支付码通常72小时内有效，超时应自动关闭订单并释放库存。
- 缺乏多语言支持：支付页面和错误提示应提供西语版本，避免用户困惑。
- 忽视对账差异：实际到账金额可能因汇率波动、手续费扣除而少于订单金额，需建立差异调节机制。
- 跳过沙箱测试：直接上线可能导致接口调用失败、数据格式错误等问题影响用户体验。
- 未监控支付完成率：生成支付码不等于完成付款，部分用户会放弃支付，需设置提醒或营销挽回。
- 过度依赖单一渠道：仅支持 Efecty 可能错失其他支付偏好用户，建议组合 Baloto、PSE、Nequi 等本地方式。
- 忽略消费者教育：应在结账页清晰说明“如何使用 Efecty 支付”，附上示例图与常见问题。
- 未留存完整交易日志：发生争议时无法提供证据链，影响与合作方的责任界定。
FAQ（常见问题）
- Efecty现金收款API靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚央行认可的支付服务机构，合规运营多年。但中国卖家需通过本地注册实体或持牌支付机构间接接入，自行直连不符合监管要求。 - Efecty现金收款API适合哪些卖家/平台/地区/类目？
适用于面向哥伦比亚消费者的独立站卖家，尤其适合低价高频、大众消费品类目（如3C配件、时尚饰品、家居用品）。高风险类目（成人、博彩、虚拟商品）通常受限。 - Efecty现金收款API怎么开通/注册/接入/购买？需要哪些资料？
需通过 Efecty 官方或其合作支付网关申请。常见所需材料包括：企业营业执照、法人身份证、网站域名、业务描述、预计交易量、技术对接能力说明。最终接入需本地收单方审核。 - Efecty现金收款API费用怎么计算？影响因素有哪些？
费用结构由合约决定，通常包含交易手续费（固定+浮动）、月费、结算费、汇率加价等。具体费率取决于交易规模、行业风险、合作模式（直连或聚合）等因素，以官方报价为准。 - Efecty现金收款API常见失败原因是什么？如何排查？
常见原因包括：API 认证失败（密钥错误）、参数格式不符（如金额非整数）、Webhook 地址不可达、订单超时未支付、本地系统维护等。建议查看 Efecty 返回的 error_code，结合日志分析请求内容。 - 使用/接入后遇到问题第一步做什么？
首先确认问题类型：若为技术故障（如接口不通），检查 API 密钥、HTTPS 证书、请求头格式；若为支付状态不同步，核查 Webhook 是否接收到通知并正确处理；若涉及资金未到账，联系本地收单方或支付服务商提供交易流水号进行追踪。 - Efecty现金收款API和替代方案相比优缺点是什么？
对比 Baloto：功能相似，覆盖率接近，可并行接入；
对比 PSE（网银转账）：Efecty 更适合无网银用户，但 PSE 实时到账更快；
对比 Nequi/DaviPlata（电子钱包）：Efecty 不依赖智能手机，触达更广人群，但操作步骤更多；
综合建议：组合使用多种本地支付方式以最大化覆盖。 - 新手最容易忽略的点是什么？
一是忽视本地合规准入门槛，误以为可直接签约；二是未做好消费者引导，导致支付码生成后用户不知如何操作；三是缺乏自动化对账机制，依赖人工核对效率低下且易出错。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业