Efecty现金收款接口文档开发者跨境电商费率说明

2026-02-24 3

详情

报告

跨境服务

文章

Efecty现金收款接口文档开发者跨境电商费率说明

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后线下现金付款。
跨境卖家通过接入 Efecty 收款接口 可支持拉美买家使用本地化支付方式，提升转化率。
接口需由具备开发能力的团队或第三方支付服务商协助对接，涉及 API 文档调用与订单状态回调处理。
费用结构通常包含交易手续费、结算周期、汇率损益等，具体以合作收单机构或支付网关报价为准。
主要适用于在拉美市场（尤其是哥伦比亚）销售实物商品的中国跨境电商卖家。
合规性依赖于收单方资质及反洗钱风控流程，建议通过持牌支付服务商接入。

Efecty现金收款接口文档开发者跨境电商费率说明是什么

Efecty 现金收款 是哥伦比亚广泛使用的非银行现金支付系统，用户可在电商平台选择 Efecty 作为支付方式，生成付款码后前往其遍布全国的数万家代理点（如便利店、超市、药店）以现金完成支付。

接口文档 指 Efecty 或其合作支付网关提供的技术文档，包含 API 调用规则、参数说明、签名机制、异步通知地址配置等，供开发者将 Efecty 支付选项集成至独立站或平台系统中。

开发者 指负责实现支付功能对接的技术人员或技术团队，需理解 RESTful API、HTTPS 加密通信、JSON 数据格式、Webhook 回调处理等基本技能。

跨境电商费率说明 指使用该支付方式所产生的各项成本解释，包括但不限于：交易手续费率、结算货币、资金到账时间、退款政策、失败交易是否收费等。

它能解决哪些问题

痛点：拉美客户不愿绑定信用卡 → 提供现金支付选项，降低支付门槛。
痛点：信用卡拒付率高 → 现金预付减少欺诈和拒付风险。
痛点：本地支付覆盖率低 → 接入 Efecty 提升在哥伦比亚市场的支付渗透率。
痛点：独立站转化率偏低 → 增加本地信任支付方式，提高下单完成率。
痛点：缺乏拉美收单能力 → 通过集成本地支付网关间接实现收单支持。
痛点：资金回笼慢 → 明确结算周期和到账逻辑，便于现金流管理。
痛点：技术对接不透明 → 查阅标准接口文档可评估开发工作量和技术复杂度。
痛点：费用结构模糊 → 清晰的费率说明有助于核算订单毛利与定价策略。

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

由于 Efecty 不直接向中国跨境电商开放直连接口，通常需通过以下路径实现接入：

选择支持 Efecty 的跨境支付服务商：确认该服务商已在哥伦比亚拥有收单合作，并提供 Efecty 接口封装服务（例如：Paga+、Dlocal、Checkout.com、Pexly 等）。
注册商户账户：提交企业营业执照、法人身份证明、网站信息、SKU 示例、预计交易量等资料完成 KYC 审核。
获取 API 接入权限：通过服务商后台申请 Efecty 支付渠道开通，获取商户 ID、密钥（API Key / Secret）、测试环境 endpoint 地址。
查阅接口文档：下载服务商提供的 Efecty 集成文档，重点关注：
- 创建支付会话（Create Payment Session）
- 生成付款参考号（Reference Code）
- 异步通知（Webhook）配置与验签逻辑
- 订单状态查询接口
开发与联调：在沙箱环境中模拟用户选择 Efecty 支付、跳转至支付页面、接收支付成功回调等全流程。
上线与监控：切换至生产环境，设置交易日志记录与异常报警机制，定期核对结算报表。

注意：Efecty 本身不提供多语言开发者文档，实际文档由中间支付网关提供，语言通常为英文或西班牙语。

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

商户所属行业类目（高风险类目费率更高）
月均交易金额与笔数（量大可能有议价空间）
结算币种（COP vs USD）及换汇方式
是否使用服务商的自动换汇与提现服务
支付成功率与争议率（影响风控评级）
是否有退款或逆向交易发生
是否产生对账差异或人工干预费用
服务商是否收取月费或通道接入费
资金结算周期（T+1、T+3、T+7 影响资金占用成本）
是否包含欺诈识别、3D Secure 验证等附加服务

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

公司注册地与运营主体国家
目标市场（如仅哥伦比亚或覆盖多个拉美国家）
销售平台类型（独立站、Magento、Shopify、自研系统）
月均订单量与平均客单价
主营产品类目（如电子产品、服饰、健康美容等）
期望结算频率与币种
历史支付渠道使用情况与拒付率数据

常见坑与避坑清单

未验证服务商是否真实支持 Efecty → 要求提供已上线客户的案例或测试账号验证。
忽略 Webhook 回调延迟 → Efecty 实际到账通知可能存在数小时延迟，需设置轮询查询机制避免发货错误。
未处理用户未及时付款场景 → 设置合理的订单有效期（通常 24-72 小时），超时自动取消。
误读费率结构 → 注意区分“每笔固定费 + 百分比”、“仅百分比”、“失败交易是否收费”等细节。
缺少对账工具 → 建议导出每日结算报告并与内部订单系统匹配，防止漏单或错结。
忽视本地合规要求 → 哥伦比亚对跨境服务征税（如 IVA），需确认税务责任归属。
使用过期接口版本 → 关注服务商发布的 API 版本更新公告，及时升级。
未做多语言支付页适配 → 确保跳转后的 Efecty 支付页面支持西班牙语且信息清晰。
忽略客户投诉路径 → 明确告知买家如何查询付款状态，提供参考码输入入口。
未设置风控规则 → 对高频下单、同一 IP 多订单等行为进行监控，防范羊毛党或洗钱风险。

FAQ（常见问题）

Efecty现金收款接口文档开发者跨境电商费率说明靠谱吗/正规吗/是否合规？
Efecty 是哥伦比亚合法运营的支付网络，合规性取决于你所使用的收单方是否具备当地金融牌照。建议选择持有 MSB 或与持牌机构合作的跨境支付服务商，确保资金路径合法。
Efecty现金收款接口文档开发者跨境电商费率说明适合哪些卖家/平台/地区/类目？
适合面向哥伦比亚消费者销售实物商品的中国跨境电商卖家，尤其适用于独立站、自建站。不适合虚拟商品、订阅服务或高风险类目（如博彩、成人用品）。
Efecty现金收款接口文档开发者跨境电商费率说明怎么开通/注册/接入/购买？需要哪些资料？
需通过支持 Efecty 的支付网关开通，一般需要企业提供营业执照、法人身份证、银行账户证明、网站链接、产品截图、业务描述等材料完成 KYC 审核。
Efecty现金收款接口文档开发者跨境电商费率说明费用怎么计算？影响因素有哪些？
费用由支付服务商制定，通常按交易金额比例收取，可能叠加固定费用。影响因素包括交易量、类目、结算周期、币种、退款率等，具体以合同约定为准。
Efecty现金收款接口文档开发者跨境电商费率说明常见失败原因是什么？如何排查？
常见原因包括：买家未在有效期内完成现金支付、系统未接收到回调通知、订单重复创建、签名验证失败。排查方法：检查 Webhook 是否正常接收、核对签名算法、查看服务商后台交易状态、确认订单时效设置。
使用/接入后遇到问题第一步做什么？
首先登录支付服务商后台查看交易详情与日志，确认是前端跳转问题、API 调用错误还是回调异常；其次对照接口文档检查参数格式与加密方式；最后联系技术支持并提供请求 ID、时间戳、错误代码等信息。
Efecty现金收款接口文档开发者跨境电商费率说明和替代方案相比优缺点是什么？
对比 PSE（网银转账）、Nequi（电子钱包）、Baloto（另一现金支付网络）：
优点：Efecty 网点密集，用户认知度高；
缺点：需线下付款，存在付款延迟；相比电子钱包速度慢。Baloto 与其高度重合，常被同时接入以扩大覆盖。
新手最容易忽略的点是什么？
一是忽视回调延迟导致提前发货；二是未设置订单过期机制造成库存锁定；三是未保留付款凭证（参考码）供买家查询；四是未测试沙箱环境中的完整流程就上线生产。