Efecty现金收款API接入教程跨境卖家本地电商收费标准

2026-02-24 3

详情

报告

跨境服务

文章

Efecty现金收款API接入教程跨境卖家本地电商收费标准

要点速读（TL;DR）

Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后到线下网点用现金付款。
跨境卖家可通过接入 Efecty API 实现本地化收款，提升拉美市场转化率。
接入需通过支持该方式的本地支付网关或收单机构，非直接对接。
费用结构通常包括交易手续费、结算周期、拒付风险分担等，具体以合作方合同为准。
主要适用于在拉美（尤其哥伦比亚）销售实体商品的中国跨境电商卖家。
常见坑：未核实API文档版本、忽略对账逻辑、未配置回调通知处理机制。

Efecty现金收款API接入教程跨境卖家本地电商收费标准是什么

Efecty 是哥伦比亚广泛使用的现金支付服务网络，覆盖超1万家线下支付点（便利店、药店、超市等）。消费者在线选择 Efecty 支付后，系统生成付款码或账单号，用户凭码在指定网点以现金完成支付。

现金收款API接入 指跨境电商平台或独立站通过技术接口（API）与支持 Efecty 的支付服务商集成，实现订单创建、状态同步、支付结果回调等功能。

本地电商收费标准 指针对在拉美本地市场开展电商业务的卖家所适用的费率体系，通常由当地收单机构或支付网关制定，包含交易费、提现费、争议处理费等。

关键名词解释

API：应用程序编程接口，用于系统间数据交互。例如创建支付请求、查询支付状态。
支付网关：连接商户网站与银行/支付网络的技术中介，如 PagoFacil、PayU Latam、RedPagos 等。
收单机构（Acquirer）：负责处理本地支付结算的金融机构或持牌支付公司。
回调通知（Webhook）：支付成功后，支付网关主动向卖家服务器发送支付结果的技术机制。
结算周期：从交易完成到资金到账的时间，常见为 T+3 到 T+7 工作日。

它能解决哪些问题

痛点：哥伦比亚超60%人群无信用卡，仅支持线上卡支付导致转化率低 → 价值：提供现金支付选项，扩大客群。
痛点：买家担心跨境支付安全不愿下单 → 价值：使用本地信任品牌 Efecty 提升信任感。
痛点：传统银行转账难追踪、对账复杂 → 价值：API自动回传支付状态，订单自动更新。
痛点：本地竞品支持多种现金支付方式 → 价值：补齐本地化体验短板，增强竞争力。
痛点：手动确认打款效率低、易出错 → 价值：自动化订单履约流程。
痛点：缺乏本地支付合规能力 → 价值：通过持牌网关合规收单，降低法律风险。

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

由于 Efecty 不直接开放给境外商户接入，必须通过其合作的本地支付网关或收单机构间接集成。以下是典型接入流程：

选择支持 Efecty 的支付服务商：如 PayU Colombia、PagoFacil、Mercado Pago（部分区域）、DLocal 等，确认其提供 Efecty 接入能力。
注册商户账户：提交企业营业执照、法人身份证明、网站信息、SKU 类型等资料，完成KYC审核。
获取API文档与测试环境：登录服务商后台，下载 Efecty 相关的 API 接口文档，申请沙箱账号用于开发调试。
技术对接：
- 调用“创建订单”接口，传入金额、货币（COP）、商品信息、返回URL等参数。
- 接收并解析支付网关返回的付款码或账单号，展示给用户。
- 配置 Webhook 回调地址，接收支付成功/失败通知。
测试全流程：在沙箱环境中模拟生成订单、线下支付、回调通知、订单状态变更等场景。
上线审批与生产切换：提交测试报告，申请启用生产环境 API 密钥，正式上线。

注意：部分服务商要求提供本地实体公司或税务登记号，中国卖家可通过代理或合资模式满足要求，具体以服务商政策为准。

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

商户所属行业类目（高风险类目费率更高）
月交易 volume（交易量越大议价空间可能越高）
是否使用统一结算货币（USD vs COP）
结算频率（T+1 vs T+7）
是否有退款/争议历史记录
是否需要多语言客服支持
是否包含欺诈检测模块
是否使用增值功能（如分期付款）
支付网关的品牌溢价（如 DLocal、PayU）
是否涉及第三方通道费（如 Efecty 自身收取小额服务费）

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

预计月均交易笔数与金额
销售类目（如电子产品、服饰、虚拟商品等）
目标国家（是否仅限哥伦比亚）
网站/APP流量来源与反欺诈措施说明
是否已有本地公司主体
期望的结算周期与币种

常见坑与避坑清单

误以为可直接对接 Efecty：Efecty 不对境外商户开放直连，必须通过本地持牌网关。
忽略回调验证机制：未校验签名或重复通知，导致虚假发货。
未处理支付超时：Efecty 订单通常有24-72小时有效期，过期未付需关闭订单。
对账不自动化：依赖人工比对交易流水，易遗漏或重复结算。
KYC材料不完整：缺少营业执照翻译件、银行对账单等导致审核延迟。
未监控支付成功率：未设置异常报警，影响用户体验和GMV。
忽视本地合规要求：如未按哥伦比亚税法开具电子发票（DIAN认证），可能被暂停服务。
使用过时API版本：服务商升级接口后未及时适配，导致调用失败。
未测试边缘场景：如网络中断、用户中途放弃支付、重复生成订单等。
忽略用户指引设计：未清晰展示付款码使用说明，导致支付失败投诉。

FAQ（常见问题）

Efecty现金收款API接入教程跨境卖家本地电商收费标准靠谱吗/正规吗/是否合规？
是的，Efecty 是哥伦比亚合法运营的支付网络，与多家银行和电信运营商合作。通过持牌支付网关接入属于合规路径，但需确保服务商具备当地收单资质。
适合哪些卖家/平台/地区/类目？
主要适合面向哥伦比亚消费者的中国跨境卖家，尤其是独立站、B2C电商平台。常见类目包括消费电子、家居用品、时尚服饰等实物商品。虚拟商品、成人用品、博彩类通常受限。
怎么开通/注册/接入/购买？需要哪些资料？
需通过支持 Efecty 的支付网关（如 PayU、DLocal）注册商户账户。一般需要：
- 公司营业执照（中英文）
- 法人身份证或护照
- 银行账户信息（对公户）
- 网站/App URL 及隐私政策链接
- SKU 示例及业务描述
- KYC 表格（由服务商提供）
费用怎么计算？影响因素有哪些？
无统一标准，费用由支付网关制定。通常包含交易手续费（按比例+固定费）、结算费、争议处理费等。影响因素包括交易量、类目风险、结算周期、是否使用风控工具等，具体以合同约定为准。
常见失败原因是什么？如何排查？
常见原因：
- API密钥错误或权限不足
- 参数格式不符（如金额单位应为分）
- 回调地址无法访问（防火墙限制）
- 订单超时未支付
- 用户输入付款码错误
排查方法：查看API日志、检查HTTP响应码、确认Webhook配置、联系服务商技术支持。
使用/接入后遇到问题第一步做什么？
首先检查API调用日志和Webhook接收记录，确认请求参数与响应内容。若无法定位，立即联系支付服务商的技术支持团队，并提供订单号、时间戳、错误代码等信息。
和替代方案相比优缺点是什么？
对比 Baloto：同为哥伦比亚现金支付，覆盖相似，费率接近，可根据网关支持情况选择。
对比信用卡：Efecty 覆盖无卡人群，但结算慢、有拒付风险；信用卡即时到账但渗透率低。
对比PSE（银行转账）：PSE 实时到账但需网银操作，Efecty 更适合线下习惯人群。
新手最容易忽略的点是什么？
一是回调通知的安全验证（必须验证签名防止伪造）；二是订单状态机设计，需明确“待支付”“已支付”“已过期”之间的转换逻辑；三是本地化用户提示，需用西班牙语清晰说明支付步骤。