Efecty现金取现接口文档开发者APP应用费率说明

2026-02-24 4

详情

报告

跨境服务

文章

Efecty现金取现接口文档开发者APP应用费率说明

要点速读（TL;DR）

Efecty 是哥伦比亚主流的本地现金支付方式，支持消费者通过线下网点以现金完成交易。
其 现金取现接口 允许电商平台或支付网关集成 Efecty 支付能力，生成可在线下单、线下付款的订单凭证。
开发者可通过官方提供的 API 接口文档 实现系统对接，需关注订单状态回调、有效期管理等关键逻辑。
用户在 APP 或网页端下单后，会获得条码或参考号，在指定门店（如D1、Alkosto）用现金支付。
资金结算周期通常为 T+3 到 T+7 工作日，具体取决于商户合同条款。
费率结构非公开透明，需与 Efecty 官方或合作收单机构协商确定，通常包含交易手续费和可能的固定月费。

Efecty现金取现接口文档开发者APP应用费率说明是什么

Efecty 是哥伦比亚领先的电子支付网络，主要提供现金支付解决方案，覆盖全国数万家零售网点。跨境卖家通过集成 Efecty 现金取现接口，可让哥伦比亚消费者选择“线上下单 + 线下现金支付”的方式完成购买。

关键词解释：

现金取现接口：实为“现金支付生成接口”，指商户系统调用 Efecty 提供的 API 创建一笔待支付订单，返回可用于线下支付的凭证（如条形码、参考码）。
接口文档：由 Efecty 或其技术合作伙伴提供的开发指南，包含请求地址、参数说明、签名规则、回调机制、错误码等，用于系统对接。
开发者APP：部分情况下指 Efecty 为开发者提供的沙箱环境入口、密钥管理后台或测试工具集合，并非面向消费者的移动应用。
应用费率说明：指使用该支付方式所产生的费用结构说明，包括每笔交易手续费、月费、退款处理费等，通常不对外公开，需签订合作协议后获取。

它能解决哪些问题

痛点：拉美市场信用卡渗透率低 → 价值：覆盖无银行卡人群，提升转化率。
痛点：消费者对在线输卡信息不信任 → 价值：支持纯现金支付，增强信任感。
痛点：本地化支付方式缺失影响排名 → 价值：接入本地主流支付渠道，符合平台（如Mercado Libre）推荐要求。
痛点：订单因支付失败流失 → 价值：延长支付有效期（通常72小时），降低弃单率。
痛点：缺乏稳定清关资金证明 → 价值：现金支付记录可作为真实交易凭证辅助通关。
痛点：收款账户受限 → 价值：无需买家银行账户，仅需手机号和身份信息即可下单。
痛点：技术对接复杂 → 价值：标准化 API 文档降低开发成本，支持异步通知自动更新订单状态。

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

常见接入流程（步骤化）

确认业务资质：拥有可在哥伦比亚合法经营的电商主体或通过第三方平台销售，具备基本风控能力。
联系 Efecty 或合作支付服务商：直接访问 Efecty 官网提交商务申请，或通过已集成 Efecty 的支付网关（如PayU Latam、Dlocal、Paddle）开通。
签署合作协议：明确服务范围、结算周期、违约责任、数据使用权限等内容。
获取测试环境接入信息：包括测试API地址、商户ID、密钥（API Key / Secret）、回调URL配置要求。
开发与联调：按照官方接口文档实现订单创建、状态查询、回调接收等功能，重点验证签名算法和异常处理。
上线审批与生产密钥发放：完成测试后提交上线申请，获得生产环境密钥并配置正式域名。

注：实际流程以 Efecty 或其授权合作伙伴的最新指引为准。

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

商户所属行业类目（高风险类目费率更高）
月均交易 volume（交易量越大议价空间越大）
是否使用第三方支付网关（中间商加价）
结算货币（COP vs USD）及换汇方式
退款频率与处理方式
是否有定制化技术支持需求
合同约定的账期长度（越短通常费率越高）
是否包含欺诈监控或反洗钱合规服务
是否涉及多国统一接入（区域套餐）

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

公司注册信息与经营范围
预计月交易笔数与金额
目标市场国家（是否仅限哥伦比亚）
网站/App流量数据
历史支付渠道使用情况
技术团队对接能力说明
期望的结算周期

常见坑与避坑清单

未设置有效回调监听：导致订单状态无法自动更新，需人工核销，增加运营负担 —— 建议部署可靠的服务器端 webhook 接收程序并做日志留存。
忽略支付有效期：Efecty 订单通常72小时内有效，超时未付需重新生成 —— 应在前端提示用户时限并在后台定时清理过期订单。
签名算法实现错误：造成请求被拒 —— 严格按照文档示例进行 HMAC-SHA256 或其他指定算法编码。
未做充分沙箱测试：直接上线导致交易失败 —— 必须模拟各种成功、失败、重复通知场景。
忽视本地合规要求：未按哥伦比亚法规收集用户身份证号（CC）或手机号 —— 需确保前端表单包含必要字段。
依赖单一支付服务商：若中间商中断服务影响全量订单 —— 建议保留直接对接 Efecty 的选项或备选通道。
误读“现金取现”含义：以为是提现功能而非支付方式 —— 明确其本质是消费者用现金向平台付款。
未监控对账文件：错过结算差异 —— 定期比对 Efecty 提供的每日结算报告与内部订单系统。

FAQ（常见问题）

Efecty现金取现接口文档开发者APP应用费率说明靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚金融监管局（Superintendencia Financiera de Colombia）认可的支付服务机构，其现金支付网络广泛用于公用事业缴费、电商购物等场景，合法合规运营。
Efecty现金取现接口文档开发者APP应用费率说明适合哪些卖家/平台/地区/类目？
主要适用于面向哥伦比亚消费者的中国跨境卖家，尤其是销售消费电子、家居用品、服装鞋包等实物商品的独立站或第三方平台店铺。不适合B2B大额交易或虚拟服务类目（可能受限）。
Efecty现金取现接口文档开发者APP应用费率说明怎么开通/注册/接入/购买？需要哪些资料？
需通过 Efecty 官方或其授权支付网关申请。常见所需资料包括：企业营业执照、法人身份证明、银行账户信息、网站/App介绍、预计交易规模、KYC 表格填写。技术对接需提供回调URL、IP白名单（如有）等。
Efecty现金取现接口文档开发者APP应用费率说明费用怎么计算？影响因素有哪些？
费率不公开，一般为每笔交易收取固定费率+小额附加费，也可能有月租。影响因素包括交易量、行业风险、结算周期、是否通过中间商等。具体计费方式以合同约定为准。
Efecty现金取现接口文档开发者APP应用费率说明常见失败原因是什么？如何排查？
常见原因：API签名错误、参数缺失、回调地址不可达、超出每日限额、用户信息格式不符（如身份证位数错误）。排查建议：查看返回错误码、检查请求日志、对照接口文档逐项验证、使用测试环境复现。
使用/接入后遇到问题第一步做什么？
首先确认问题是技术层面（如接口不通、状态不同步）还是商务层面（如结算延迟、费率争议）。技术问题应查阅接口文档中的错误代码表，并联系技术支持提供请求ID、时间戳、完整报文；商务问题应联系客户经理协调处理。
Efecty现金取现接口文档开发者APP应用费率说明和替代方案相比优缺点是什么？
替代方案如 PSE（网银转账）、Baloto（另一现金支付网络）、Nequi（电子钱包）。
优点：Efecty 网点更密集，用户体验成熟；
缺点：接入流程较长，费率谈判门槛较高，不如 Baloto 普及于中小城市。
新手最容易忽略的点是什么？
一是误以为“现金取现”是卖家提现功能，实则为买家支付方式；二是未设置自动对账机制，导致财务核销困难；三是忽略用户支付后的通知设计，造成客服压力上升。