Efecty现金收款API接入教程开发者跨境电商收费标准

2026-02-24 3

详情

报告

跨境服务

文章

Efecty现金收款API接入教程开发者跨境电商收费标准

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后线下现金付款，适合无银行卡用户。
跨境卖家可通过 API 接入 Efecty 收款功能，支持本地化支付，提升南美市场转化率。
API 接入需技术开发能力，涉及商户注册、资质审核、接口对接、测试上线等步骤。
费用结构通常包括交易手续费、结算周期、货币转换费，具体以支付网关或收单机构合同为准。
主要适用对象为面向哥伦比亚消费者的跨境电商平台或独立站卖家。
常见坑：未完成KYC验证、回调地址配置错误、未处理异步通知导致订单状态不同步。

Efecty现金收款API接入教程开发者跨境电商收费标准是什么

Efecty 是哥伦比亚广泛使用的现金支付服务网络，覆盖超 2 万家线下网点（如药店、便利店、超市），用户可在线生成支付单，线下用现金完成付款。该服务由Conecte公司运营，被众多电商平台集成作为本地支付方式之一。

现金收款API接入 指跨境商家通过技术接口（API）将 Efecty 支付选项集成到自己的电商平台或独立站中，使哥伦比亚买家在结账时可选择“Efecty 现金支付”选项，并获取唯一的支付码和付款截止时间。

开发者 在此指负责实现 API 对接的技术人员或团队，需具备基本的 HTTP 请求处理、JSON 解析、签名验证、异步回调接收等能力。

跨境电商收费标准 指使用 Efecty 收款服务所产生的费用构成，通常不直接向卖家公开定价，而是通过第三方支付网关（如 PPRO、Checkout.com、dLocal、PagaTodo 等）或本地收单机构提供服务并计费。

它能解决哪些问题

痛点：哥伦比亚信用卡渗透率低 → 价值： 提供现金支付选项，覆盖更广消费人群。
痛点：国际信用卡拒付率高 → 价值： 本地现金支付减少欺诈与拒付风险。
痛点：支付方式单一导致转化率低 → 价值： 增加本地信任感，提高下单成功率。
痛点：资金回款慢 → 价值： 部分服务商支持T+1或T+2结算，加快资金周转。
痛点：缺乏本地支付支持 → 价值： 提升本地化体验，增强品牌可信度。
痛点：手动核销订单效率低 → 价值： API 实现自动回调通知，订单状态实时同步。
痛点：无法追踪付款状态 → 价值： 可查询支付状态接口，便于售后与客服跟进。
痛点：合规性要求高 → 价值： 正规渠道接入符合当地金融监管要求。

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

由于 Efecty 不直接对境外中小卖家开放 API 接入，通常需通过国际支付网关或本地收单机构间接集成。以下是常见接入流程：

选择支持 Efecty 的支付服务提供商：确认其是否已在哥伦比亚持牌或合作，例如 dLocal、PagaTodo、Transbank（智利但覆盖拉美）、Mercado Pago 或 Stripe（通过PPRO代理）等。
注册商户账户：提交企业营业执照、法人身份证明、网站信息、预计交易量等资料完成 KYC 审核。
申请开通 Efecty 支付方式：在支付网关后台提交开通请求，部分需额外签署本地服务协议。
获取 API 凭据：包括商户ID、密钥（API Key / Secret）、终端号等，用于签名和身份认证。
开发对接 API：
- 调用“创建订单”接口，传入金额、币种（COP）、订单号、过期时间、回调URL等参数。
- 接收返回的支付链接或二维码，展示给用户。
- 配置 Webhook 回调地址，接收支付成功/失败通知（异步）。
- 实现状态查询接口，用于对账或补单。
测试与上线：使用沙箱环境测试全流程，确保回调处理正确，再切换至生产环境。

建议：若自建技术团队不足，可选用已集成 Efecty 的 SaaS 独立站系统（如 Tiendanube、Nuvemshop）或 ERP 平台（如 Linerunner）简化接入。

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

商户所属国家及注册地
月均交易笔数与交易总额（Volume Tier）
是否为新商户或已有稳定流水
结算币种（USD/COP）及汇率加价幅度
是否需要本地实体注册（如SAS公司）
支付网关的服务层级（标准版 vs 定制版）
是否包含反欺诈风控模块
结算频率（T+1, T+7 等）
是否有提前放款需求
退款处理费用

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

公司注册信息（营业执照扫描件）
法人身份证或护照
网站 URL 及产品类目
预计月交易量（笔数与金额）
目标市场（仅哥伦比亚还是多国）
技术支持联系方式（邮箱/电话）
历史交易流水（如有）
是否已有其他本地支付方式接入经验

常见坑与避坑清单

KYC 材料不全：哥伦比亚监管要求严格，务必提供完整的企业文件与法人信息。
回调地址不可达：Webhook 地址必须公网可访问且返回 200 状态码，否则无法更新订单状态。
未验证签名：所有来自 Efecty 或支付网关的回调通知应验证签名，防止伪造请求。
忽略支付有效期：Efecty 订单通常有 24-72 小时付款时限，超时未付需关闭订单。
未做对账机制：定期调用状态查询接口，避免因网络问题漏掉回调。
币种设置错误：必须使用哥伦比亚比索（COP），不能以美元发起交易。
未处理部分退款：Efecty 不支持部分退款，需整单取消或线下返还。
误判支付成功：仅当收到 Webhook 且状态为“PAID”时才算完成，页面跳转不代表已付款。
未监控失败率：高拒单率可能触发风控审查，影响后续接入其他本地支付方式。
依赖单一服务商：建议同时接入多个本地支付网关以分散风险。

FAQ（常见问题）

Efecty现金收款API接入教程开发者跨境电商收费标准靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚央行认可的支付网络，合规运营多年。但卖家需通过正规支付网关接入，避免使用非授权代理，以防资金安全风险。
适合哪些卖家/平台/地区/类目？
主要适用于面向哥伦比亚消费者的独立站、B2C电商平台卖家；常见类目包括电子产品、时尚服饰、家居用品等高单价商品；不适合成人用品、虚拟币、赌博类等受限行业。
怎么开通/注册/接入/购买？需要哪些资料？
需通过支持 Efecty 的支付网关注册商户账号，提供企业营业执照、法人身份证明、银行账户信息、网站信息等。具体材料依服务商而定，部分需哥伦比亚本地实体。
费用怎么计算？影响因素有哪些？
费用由支付网关收取，通常为每笔交易收取固定费率 + 固定手续费，另含货币转换费与结算费。具体取决于交易量、商户资质、结算周期等因素，需签订合同后明确。
常见失败原因是什么？如何排查？
常见原因包括：KYC审核未通过、回调地址无法访问、签名验证失败、订单金额异常、IP被风控限制。排查方法：检查日志、联系技术支持、确认Webhook配置、测试沙箱环境。
使用/接入后遇到问题第一步做什么？
首先查看支付网关提供的交易日志与错误代码，确认是前端展示、API调用失败还是回调未接收；然后联系服务商技术支持，并提供订单号、时间戳、请求/响应原文。
和替代方案相比优缺点是什么？
对比 Baloto：两者均为现金支付，Efecty 网点更多集中在城市，Baloto 覆盖更广但部分偏远地区响应慢。
对比信用卡：Efecty 拒付率低但结算周期较长；信用卡即时到账但拒付风险高。
对比 PSE（银行转账）：PSE 实时到账但需网银操作，用户门槛更高。
新手最容易忽略的点是什么？
一是忽视异步回调处理，导致订单状态不更新；二是未设置订单过期逻辑，造成库存占用；三是忘记申请生产环境权限，上线后无法生成有效支付单。