Efecty现金收款接口文档开发者本地电商详细解析

2026-02-24 3

详情

报告

跨境服务

文章

Efecty现金收款接口文档开发者本地电商详细解析

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后线下现金付款。
面向中国跨境卖家，接入 Efecty 可提升本地化支付覆盖率，尤其适用于无银行卡人群。
需通过支付网关或本地收单机构对接 Efecty 接口，开发者需阅读官方 API 文档完成技术集成。
支持场景：B2C 跨境电商、本地电商平台、SaaS 系统在哥伦比亚的订单结算。
关键难点：语言障碍（西班牙语为主）、对账复杂、退款流程非实时、风控审核严格。
建议通过已集成 Efecty 的第三方支付服务商接入，降低开发与合规成本。

Efecty现金收款接口文档开发者本地电商详细解析是什么

Efecty 是哥伦比亚领先的现金支付服务网络，用户可在电商平台选择 Efecty 支付方式，生成付款码或账单后，在其遍布全国的超10万家线下网点以现金完成支付。该服务由Davivienda 银行支持运营，广泛用于水电费、话费、电商订单等场景。

现金收款接口 指 Efecty 提供的 API 接口，允许电商平台或支付网关系统与其进行数据交互，实现订单创建、状态查询、回调通知等功能。

开发者本地电商 指中国跨境卖家自建站或本地化平台的技术团队，需基于 Efecty 的接口文档完成技术对接，使系统支持该支付方式。

关键词解释

Efecty：哥伦比亚本地现金支付通道，非国际卡组织，不支持线上直接扣款。
现金收款接口：RESTful 或 SOAP 形式的 API 接口，用于生成支付凭证、接收支付结果。
接口文档：由 Efecty 或合作收单方提供的技术说明文件，包含请求参数、签名规则、回调机制、错误码等。
本地电商：指在目标市场（如哥伦比亚）注册实体、使用本地支付方式、适配本地消费习惯的电商模式。
开发者：负责系统对接的技术人员，需具备 API 调用、加密签名、异步回调处理能力。

它能解决哪些问题

痛点：哥伦比亚银行卡渗透率低 → Efecty 覆盖无银行账户人群，提升转化率。
痛点：国际信用卡拒付率高 → 现金支付无拒付风险，资金更安全。
痛点：本地消费者信任度不足 → 支持本地知名支付方式增强信任感。
痛点：支付方式单一导致流失 → 补充多元支付选项，适配本地购物习惯。
痛点：自建站支付闭环缺失 → 通过 API 接入实现订单-支付-通知全链路自动化。
痛点：对账困难 → 正确对接回调接口可实现自动对账，减少人工核对。
痛点：退款流程不透明 → 理解接口逻辑可设计清晰的退款触发与通知机制。
痛点：技术文档语言障碍 → 开发者需依赖翻译或本地合作伙伴理解西班牙语文档。

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

中国跨境卖家无法直接与 Efecty 签约，通常需通过以下路径实现接入：

选择支持 Efecty 的支付服务商：如PagueloFacil、PayU Latam、DLocal、Checkout.com 等已集成 Efecty 的国际支付网关。
注册商户账号：在选定服务商平台提交企业资料（营业执照、法人身份证、网站信息、业务描述等）。
申请开通 Efecty 支付方式：在服务商后台提交开通请求，部分需提供月交易量预估、KYC 补充材料。
获取 API 接入文档与密钥：服务商提供统一接入文档（含 Efecty 封装接口），分配商户 ID、API Key、回调 URL 配置权限。
技术对接：开发者根据文档调用支付创建接口，传入订单号、金额、货币（COP）、支付方式代码（如 efecty），生成付款链接或二维码。
配置异步回调（Webhook）：设置服务器接收 Efecty 支付成功/失败通知，更新订单状态，避免手动查单。
测试与上线：使用沙箱环境测试全流程，确认回调稳定后切换至生产环境。

若自行对接 Efecty 直连接口（极少见），需：

在哥伦比亚注册本地公司；
与 Efecty 官方签署合作协议；
获取原始 API 文档（西班牙语）；
自行处理 PCI DSS 合规、IP 白名单、签名加密（如 HMAC-SHA256）；
建立本地客服与对账团队。

提示：绝大多数中国卖家采用间接接入方式，通过支付网关简化流程，具体步骤以所选服务商实际页面为准。

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

商户所属行业类目（高风险类目费率更高）
月均交易 volume 与单笔平均金额
是否为新商户（初期可能有优惠或审核期）
结算周期（T+7、T+14 等影响资金占用成本）
币种转换需求（USD→COP 汇兑成本）
支付服务商收取的附加服务费（如技术支持、定制开发）
退款处理费用（部分服务商对退款收费）
是否使用增值服务（如反欺诈系统、多语言客服）
合同谈判能力（大客户可议价）
是否存在 chargeback 或异常交易惩罚机制

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

公司营业执照与法人身份证明
电商平台或独立站 URL
预计月交易笔数与金额
主要销售国家与商品类目
现有支付方式与拒付率数据
技术对接方式（API/插件/SDK）
是否需要多语言支持
结算货币与频率要求

常见坑与避坑清单

未配置 Webhook 回调：依赖手动查单导致发货延迟，建议强制启用并做好日志监控。
忽略支付有效期：Efecty 订单通常 24-72 小时内有效，超时未付需重新生成，系统应自动作废旧单。
回调验证缺失：未校验签名可能导致伪造通知，造成虚假发货。
未处理部分支付：Efecty 不支持分次支付，系统应锁定订单防止重复创建。
语言与时间格式错误：API 请求中城市、姓名等字段需符合西班牙语规范，避免乱码或拒单。
对账周期长：Efecty 结算到账可能延迟 3-7 天，财务需预留缓冲期。
退款流程不透明：现金退款通常原路返回网点，需告知用户凭身份证领取，客服应有 SOP。
忽视用户教育：应在支付页清晰说明“如何在 Efecty 网点付款”，附示例图。
测试不充分：未模拟支付失败、重复回调、网络超时等异常场景，上线后出现订单状态错乱。
选择无本地支持的服务商：出现问题无法及时沟通，建议优先选在拉美有办事处的服务商。

FAQ（常见问题）

Efecty现金收款接口文档开发者本地电商详细解析靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚金融监管局（Superintendencia Financiera）认可的支付网络，由 Davivienda 银行运营，合规性高。但中国卖家必须通过持牌支付机构接入，不可私自收集现金或伪造凭证。
Efecty现金收款接口文档开发者本地电商详细解析适合哪些卖家/平台/地区/类目？
适合：
- 主打哥伦比亚市场的中国跨境卖家
- 自建站（Shopify、Magento、定制站）或本地化电商平台
- 销售电子、服饰、家居等大众消费品
- 目标客群为中低收入、偏好现金支付的人群
不适合：高单价 B2B 交易、虚拟商品（易涉欺诈）、禁运品类。
Efecty现金收款接口文档开发者本地电商详细解析怎么开通/注册/接入/购买？需要哪些资料？
需通过支付网关（如 PayU、DLocal）开通，流程：
1. 注册服务商商户账号
2. 提交营业执照、法人身份证、网站信息
3. 填写业务问卷（类目、流量、客单价）
4. 签署协议并等待审核（通常 3-7 工作日）
5. 在后台申请启用 Efecty 支付方式
6. 获取 API 密钥与文档，开始技术对接。
Efecty现金收款接口文档开发者本地电商详细解析费用怎么计算？影响因素有哪些？
费用由支付服务商收取，通常为交易金额百分比 + 固定手续费，影响因素包括类目、交易量、结算周期、汇率服务等。具体费率需联系服务商获取报价单，以合同为准。
Efecty现金收款接口文档开发者本地电商详细解析常见失败原因是什么？如何排查？
常见原因：
- 参数错误（如金额格式、字符编码）
- 签名验证失败
- IP 未加入白名单
- 订单超时未支付
- 用户在网点付款时信息输入错误
排查方法：
1. 查看 API 返回错误码与日志
2. 核对请求参数是否符合文档规范
3. 检查 Webhook 是否正常接收
4. 联系服务商技术支持提供交易 ID 查询。
使用/接入后遇到问题第一步做什么？
第一步：记录完整请求与响应日志（含 timestamp、order_id、error_code）；第二步：登录服务商后台查看交易状态；第三步：联系其技术支持并提供日志证据，避免自行重试导致重复订单。
Efecty现金收款接口文档开发者本地电商详细解析和替代方案相比优缺点是什么？
对比 Baloto（另一现金支付方式）：
Efecty 优点：网点更多、操作更简便、年轻人接受度高
Baloto 优点：部分区域覆盖更广、退款流程略快
共同缺点：到账慢、无法即时确认支付、需线下操作
替代方案：PSE（网银转账）、Tarjeta de Débito/Crédito（银行卡），但覆盖率低于现金支付。
新手最容易忽略的点是什么？
最易忽略：
1. 未设置自动作废过期订单
2. 忽视回调安全性验证
3. 没有为客服提供 Efecty 支付指引话术
4. 未在前端清晰展示支付流程说明
5. 对账未做自动化匹配，依赖人工 Excel 核对。