Efecty现金收款API接入教程开发者连锁门店费率说明
2026-02-24 2
详情
报告
跨境服务
文章
Efecty现金收款API接入教程开发者连锁门店费率说明
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的现金支付网络，支持消费者在线下单后在实体网点用现金付款。
- 跨境卖家可通过 API 接入 实现与 Efecty 支付系统的自动对接，完成订单状态同步和支付确认。
- 主要适用于面向 哥伦比亚本地消费者 的电商平台或独立站，尤其适合无银行卡用户群体。
- 费用结构通常包括交易手续费、结算周期成本及可能的失败重试成本，具体以合同约定为准。
- 接入需提供企业资质、技术文档对接能力，并通过 Efecty 或其合作支付网关的技术验证。
- 常见坑：回调地址配置错误、订单时效超时、身份信息不一致导致支付失败。
Efecty现金收款API接入教程开发者连锁门店费率说明 是什么
Efecty 是哥伦比亚领先的非银行现金支付服务提供商，拥有超过 3,000 家线下连锁门店（如 Droguerías Similares、Éxito 超市等），允许消费者在线生成支付单据后，前往任意网点以现金完成支付。
现金收款API接入 指跨境电商平台或独立站开发者通过调用 Efecty 提供的 RESTful API 接口，实现以下功能：
- 创建支付订单
- 获取支付二维码或参考码
- 接收支付成功/失败的异步通知（Webhook）
- 查询交易状态
开发者：指负责系统集成的技术人员或第三方技术服务商，需具备基本的 HTTP 请求处理、JSON 解析、签名验签和日志记录能力。
连锁门店：Efecty 合作的实体零售网络，覆盖城市广泛，是其现金收单能力的基础。
费率说明：指使用 Efecty 收单服务所需支付的服务费比例或固定费用，通常由平台方或支付服务商在合同中明确，影响最终结算金额。
它能解决哪些问题
- 痛点：拉美消费者银行卡渗透率低 → 价值：拓展无卡人群市场，提升转化率。
- 痛点：本地支付方式缺失 → 价值：增强本地化体验，提高信任度。
- 痛点：跨境信用卡拒付率高 → 价值：降低支付风控风险，减少争议。
- 痛点：资金回笼慢 → 价值：T+1~T+3 结算（视合作模式），优于部分传统渠道。
- 痛点：人工对账效率低 → 价值：API 自动同步交易状态，减少运营成本。
- 痛点：缺乏本地支付凭证 → 价值：提供门店支付小票作为履约依据，便于售后追溯。
- 痛点：清关需真实付款证明 → 价值：Efecty 支付记录可作为合规资金流凭证。
怎么用/怎么开通/怎么选择
步骤 1：确认业务适配性
- 目标市场是否为哥伦比亚？
- 销售类目是否被 Efecty 允许（如禁售虚拟商品、赌博相关）？
- 是否有本地注册主体或通过合规支付服务商接入？
步骤 2：选择接入方式
- 直接接入：向 Efecty 官方提交申请，获取 API Key、Secret 及技术文档（适合大型平台）。
- 间接接入：通过已集成 Efecty 的支付网关（如 PayU Latam、Dlocal、Paddle）开通（适合中小卖家）。
步骤 3：准备企业资料
- 公司营业执照（或个体工商户证明）
- 法人身份证件
- 网站域名及隐私政策链接
- 预计月交易量与单笔金额范围
- 银行账户信息（用于结算）
步骤 4：技术对接
- 阅读官方 API 文档（通常包含 endpoints、认证方式、参数列表）。
- 实现 创建订单接口（POST /payments），携带订单号、金额、用户信息、回调 URL。
- 处理返回的
referenceCode或二维码，展示给用户。 - 配置 Webhook 回调地址，接收支付成功/失败通知（需支持 HTTPS 并能验证签名）。
- 实现 查询接口（GET /payments/{id}）用于状态补全。
- 记录所有请求与响应日志，便于排查问题。
步骤 5：测试与上线
- 使用沙箱环境进行全流程测试（生成订单 → 网点支付模拟 → 接收回调）。
- 确保订单状态在支付成功后正确更新。
- 申请生产环境权限并切换正式 API 地址。
步骤 6：监控与维护
- 设置异常交易报警机制。
- 定期核对结算报表与平台订单数据。
- 关注 Efecty 发布的接口变更公告。
费用/成本通常受哪些因素影响
- 月均交易笔数与总交易额
- 单笔交易金额区间（阶梯定价常见）
- 是否通过第三方支付网关接入（中间商会加价）
- 结算货币（COP vs USD）及换汇成本
- 退款频率与处理成本
- 技术支持等级（标准支持 or VIP 专属）
- 合同谈判能力（大客户可议价）
- 是否存在最低月费或年费
- 逾期未结算的资金占用成本
- API 调用频次是否超出免费额度
为了拿到准确报价/成本，你通常需要准备以下信息：
- 公司基本信息与经营类目
- 预估首月及未来 6 个月交易量
- 平均订单金额（AOV）
- 希望使用的结算周期（T+1/T+3/T+7）
- 是否已有技术团队支持 API 对接
- 是否需要多语言客服支持
常见坑与避坑清单
- 未设置有效 Webhook 回调地址：导致无法自动更新订单状态，建议部署前在沙箱测试通知接收。
- 用户姓名或证件号填写错误：Efecty 要求实名匹配，否则门店拒绝收款，前端应做格式校验。
- 订单有效期设置过短：一般默认 24-72 小时，超时未支付需重新下单，影响用户体验。
- 忽略签名验证：回调通知可能被伪造，必须按文档验证 HMAC-SHA256 签名。
- 未处理异步延迟：门店录入现金支付后，系统同步有延迟（最长可达 1 小时），不应立即判定失败。
- 使用 HTTP 而非 HTTPS 回调地址：Efecty 多数要求加密传输，否则回调失败。
- 未保留支付凭证：建议引导用户上传门店小票，应对后续争议。
- 忽视本地合规要求：哥伦比亚数据保护法（Law 1581/2012）要求妥善处理用户个人信息。
- 技术文档版本过旧：每次升级前确认当前使用的是最新版 API 文档。
- 未建立对账机制：每日导出 Efecty 结算报告并与内部订单比对，防止漏结。
FAQ（常见问题）
- Efecty 现金收款API接入靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚金融监管局（Superintendencia Financiera de Colombia）认可的支付服务机构，合法运营多年，被 Mercado Libre、AliExpress 等平台采用，合规性较强。但需确保自身业务符合当地反洗钱（AML）要求。 - Efecty 现金收款API接入适合哪些卖家/平台/地区/类目？
主要适用于：
- 目标市场为哥伦比亚的中国跨境卖家
- 独立站或自建电商平台
- 销售实物商品（禁售虚拟币、数字内容、成人用品等）
- 客群包含无银行卡或偏好现金支付的人群 - Efecty 现金收款API接入怎么开通/注册/接入/购买？需要哪些资料？
流程如下：
① 联系 Efecty 官方或其授权支付网关（如 Dlocal）
② 提交企业营业执照、法人身份证、网站信息、银行账户
③ 签署服务协议
④ 获取测试账号与 API 文档
⑤ 完成技术对接并上线
所需资料详见上文“步骤 3”。 - Efecty 现金收款API接入费用怎么计算？影响因素有哪些？
费用通常为每笔交易收取一定比例（如 3%-6%）加固定费用（如 1,000 COP），也可能按月打包计费。具体取决于交易量、行业风险等级、结算周期等因素。最终以合同约定为准，建议索取详细费率表。 - Efecty 现金收款API接入常见失败原因是什么？如何排查？
常见原因：
- 回调地址不可达（检查服务器防火墙）
- 用户信息不匹配（核对姓名拼写、身份证号）
- 订单已过期（提醒用户及时支付）
- API 密钥无效（确认环境与密钥对应）
排查方法：查看 API 返回码、检查日志、联系技术支持提供 transaction ID。 - 使用/接入后遇到问题第一步做什么？
首先检查：
- API 请求参数是否符合文档规范
- 是否收到 Webhook 通知且已正确响应 200 状态码
- 日志中是否有错误代码或签名验证失败记录
若无法定位，收集请求时间、订单号、referenceCode、完整报文，联系 Efecty 技术支持或支付网关客服。 - Efecty 现金收款API接入和替代方案相比优缺点是什么？
对比 Baloto：两者均为哥伦比亚主流现金支付方式，覆盖率相近；Efecty 门店略多，但 Baloto 在部分地区更普及。
对比信用卡：Efecty 转化率更高但结算慢，信用卡即时到账但拒付风险大。
对比 PSE（网银转账）：PSE 成功率高但依赖银行账户，Efecty 更普惠。 - 新手最容易忽略的点是什么？
一是忽视 订单有效期管理，未提示用户及时支付；二是忘记 Webhook 签名验证，存在安全漏洞；三是没有建立 人工复核机制 应对系统延迟导致的状态不同步。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业