Efecty现金取现API接入教程企业Marketplace平台怎么开通

2026-02-24 2

详情

报告

跨境服务

文章

Efecty现金取现API接入教程企业Marketplace平台怎么开通

要点速读（TL;DR）

Efecty是哥伦比亚主流的现金支付网络，支持消费者在线下单后线下现金付款，适合无银行卡用户。
其API支持企业Marketplace平台接入，实现订单与支付状态实时同步。
开通需完成企业注册、KYC认证、技术对接及测试环境验证。
现金取现功能需用户在Efecty网点完成支付，资金结算有T+1至T+3延迟。
API文档由Efecty官方提供，建议通过本地合规服务商协助接入以降低沟通成本。
主要适用于面向哥伦比亚市场的B2C电商平台或自营独立站。

Efecty现金取现API接入教程企业Marketplace平台怎么开通是什么

Efecty 是哥伦比亚领先的非银行支付网络，为没有银行账户或信用卡的用户提供“线上下单、线下现金支付”服务。用户在电商平台选择Efecty支付后，系统生成条码或参考号，用户凭此在Efecty全国超8000个服务点用现金完成付款。

现金取现API 实际指Efecty提供的支付网关接口（Payment Gateway API），允许企业级电商平台（如Marketplace）自动创建支付订单、查询支付状态、接收回调通知，实现全流程自动化。

企业Marketplace平台 指具备多商户入驻能力的电商系统，如自建平台或SaaS型市场，需集成本地化支付方式以提升转化率。

它能解决哪些问题

场景： 哥伦比亚消费者信用卡渗透率低 → 价值： 覆盖现金支付人群，提升订单转化。
场景： 手动核销现金付款订单效率低 → 价值： API自动回传支付状态，减少人工对账。
场景： 用户因不信任第三方支付放弃下单 → 价值： 使用本地知名支付品牌增强信任感。
场景： 多平台订单分散管理难 → 价值： 统一对接Efecty，集中处理所有Marketplace子商户支付请求。
场景： 支付失败或重复结算风险高 → 价值： 通过唯一交易ID和状态回调机制确保一致性。
场景： 结算周期不透明 → 价值： 明确的资金清算规则（通常T+1起）便于现金流规划。
场景： 国际支付网关本地覆盖率不足 → 价值： 补足拉美市场最后一公里支付能力。

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

企业Marketplace平台开通Efecty API接入流程

确认业务资格：企业需在哥伦比亚注册实体或通过本地代理公司申请；若为跨境平台，需证明有哥伦比亚用户流量。
联系Efecty商务团队：访问官网提交合作意向表单，或通过支付服务商（如Paddle、dLocal、Checkout.com）间接接入。
准备企业资料：包括公司营业执照、法人身份证明、税务登记号（NIT）、银行账户信息、网站URL及商品类目说明。
完成KYC审核：Efecty将进行企业背景调查，可能要求补充财务报表或运营数据。
获取测试环境权限：通过审核后获得沙箱（Sandbox）账号、API Key、Secret Token 及文档链接。
技术对接与调试：
- 集成API创建支付订单（POST /payments）
- 设置Webhook接收支付成功/失败回调
- 在沙箱中模拟用户支付流程并验证状态同步
- 确保订单金额、币种（COP）、有效期（通常24-72小时）正确传递
上线审批：提交测试报告，Efecty技术团队验收通过后分配生产环境密钥。
正式启用：在平台前端开放Efecty支付选项，并监控首周交易成功率与结算情况。

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

企业年营业额规模
月均交易笔数与平均订单金额
是否使用第三方聚合支付网关（如dLocal）作为中介
结算频率（每日/每周）
退款率水平
是否有定制化开发需求（如多语言支持、特殊字段传递）
是否包含欺诈风控附加服务
汇率转换成本（若结算为美元）
本地合规咨询与代理服务费（如有）

为了拿到准确报价，你通常需要准备以下信息：
- 预计月交易量与GMV
- 目标用户所在地区分布
- 平台技术架构（是否已有支付网关中间层）
- 是否支持移动端H5/APP支付
- 是否需要发票自动开具集成

常见坑与避坑清单

未核实企业注册地要求：部分国际平台误以为可纯离岸操作，实际Efecty倾向本地注册企业。
忽略支付时效设置：未设置合理过期时间导致订单长期挂起，影响库存管理。
回调地址未备案IP白名单：生产环境无法接收通知，造成对账缺失。
未处理部分支付场景：Efecty不支持分次支付，需前端明确提示用户一次性结清。
缺少异常订单监控机制：如用户重复生成订单但仅支付一单，需系统去重。
忽视语言本地化：支付页面跳转时仍为英文，降低转化率。
未配置自动取消未支付订单：占用库存资源，影响履约效率。
跳过沙箱全面测试：直接上线导致支付失败率飙升。
未与财务系统打通：结算文件格式不兼容，增加人工处理成本。
未关注节假日影响：Efecty网点在周末或节日关闭，延长实际到账时间。

FAQ（常见问题）

Efecty现金取现API接入教程企业Marketplace平台怎么开通靠谱吗/正规吗/是否合规？
是的，Efecty受哥伦比亚金融监管局（Superintendencia Financiera de Colombia）监管，为企业提供合法现金代收服务，符合当地反洗钱法规。
适合哪些卖家/平台/地区/类目？
主要适用于面向哥伦比亚消费者的B2C电商平台，尤其是电子消费品、时尚服饰、家居用品等高频零售类目。自建站、SaaS商城、多商户Marketplace均可接入。
怎么开通/注册/接入/购买？需要哪些资料？
需通过官网或合作支付网关提交企业资料，包括公司注册文件、法人身份证、银行账户、网站信息、业务模式说明等。具体清单以Efecty合同要求为准。
费用怎么计算？影响因素有哪些？
费用结构由Efecty根据企业资质谈判确定，通常包含交易手续费（按比例收取）和可能的固定月费。影响因素包括交易量、行业风险等级、结算周期等。
常见失败原因是什么？如何排查？
常见原因：
- API密钥错误或权限未激活
- 订单金额超出限额
- 回调地址不可达
- 用户未在有效期内完成现金支付
排查方法：检查日志中的错误码、确认沙箱与生产环境切换正确、验证Webhook响应状态码为200。
使用/接入后遇到问题第一步做什么？
首先查看Efecty提供的开发者文档中的错误代码表；其次登录商户后台检查交易状态；若仍无法解决，通过官方支持邮箱或服务商通道提交工单，并附上请求ID、时间戳和截图。
和替代方案相比优缺点是什么？
对比PSE（网银直连）、Nequi（移动钱包）、DaviPlata：
优点：覆盖无银行账户人群最广，接受度高；
缺点：需线下支付，存在T+1以上结算延迟；不适合高单价即时发货场景。
新手最容易忽略的点是什么？
忽略支付完成后的用户引导——应立即发送含条码的短信/邮件；以及未设置订单状态自动更新逻辑，导致客服重复跟进已支付订单。