Efecty现金收款API接入教程商家独立站全面指南
2026-02-24 3
详情
报告
跨境服务
文章
Efecty现金收款API接入教程商家独立站全面指南
要点速读（TL;DR）
- Efecty 是哥伦比亚主流的现金支付网络，允许消费者在线下单后通过线下网点用现金付款。
- 支持独立站卖家接入其 API 实现订单与支付状态自动同步，提升本地转化率。
- 主要适用于面向哥伦比亚消费者销售的中国跨境商家，尤其适合中低价商品。
- 接入需技术开发能力，建议有本地合作方或支付网关服务商协助对接。
- 需注意订单有效期、资金结算周期、拒付争议处理机制等运营细节。
- 不支持退款原路返回现金，需通过银行转账或其他方式完成。
Efecty现金收款API接入教程商家独立站全面指南 是什么
Efecty 是哥伦比亚领先的非银行支付网络，为无银行卡或偏好现金支付的人群提供线上购物支付服务。用户在电商平台选择 Efecty 支付后，系统生成唯一付款码或账单号，消费者凭此在 Efecty 全国超万家线下网点（如便利店、药店、邮局）以现金完成支付。
API 接入 指商家通过调用 Efecty 官方提供的应用程序接口（Application Programming Interface），将该支付方式集成到自有独立站（Shopify、自建站等）的技术过程。成功接入后，可实现：
- 订单创建时自动生成 Efecty 支付凭证
- 实时接收支付成功/失败回调通知
- 自动更新订单状态，减少人工对账成本
关键词解释
- 现金收款：指消费者使用实体货币完成交易，区别于信用卡、电子钱包等数字支付方式。在拉美市场占比高，尤其在中低收入群体中普及。
- API 接入：系统间数据交互的技术通道。用于连接独立站与第三方支付机构，实现订单、支付状态、金额等信息自动化传输。
- 独立站：指卖家自主搭建并运营的电商网站（如基于 Shopify、WooCommerce 或自研系统），不依赖 Amazon、Mercado Libre 等第三方平台。
- 支付网关：介于商户和支付机构之间的技术中间层，负责加密传输、协议转换、风控校验等功能。部分服务商已预集成 Efecty，可降低接入门槛。
它能解决哪些问题
- 痛点：哥伦比亚消费者信用卡渗透率低 → 价值：覆盖更广人群，提高转化率
- 痛点：依赖国际信用卡导致拒付率高 → 价值：本地化支付降低风控拦截概率
- 痛点：PayPal 在拉美使用受限 → 价值：提供替代性主流本地支付选项
- 痛点：手动确认现金付款效率低 → 价值：API 回调自动标记已付款订单
- 痛点：错过未及时支付的订单 → 价值：设置有效时限（通常24-72小时），避免库存锁定过久
- 痛点：跨境支付手续费高 → 价值：本地现金结算，规避部分国际通道费用
- 痛点：缺乏本地信任感 → 价值：展示“可在附近门店付款”增强购买信心
- 痛点：资金回款路径复杂 → 价值：统一结算至本地代理账户或指定外币户
怎么用/怎么开通/怎么选择
步骤 1：确认业务适配性
检查是否符合以下条件：
- 目标市场包含哥伦比亚
- 独立站具备技术开发资源或已有支付集成经验
- 接受较长的资金结算周期（通常 T+3 至 T+7 工作日到账）
- 有能力处理非即时退款流程
步骤 2：获取 Efecty 商户资质
直接申请需在哥伦比亚注册实体公司，并提交：
- 营业执照（当地法人主体）
- 银行账户证明（本地开户）
- 税务登记文件（RUT）
- 网站及商品信息审核材料
中国卖家常见做法：通过已持牌的本地支付服务商或收单代理间接接入，由其作为名义商户承担合规责任。
步骤 3：选择接入方式
- 直连 Efecty API：需阅读官方文档，自行开发接口，适合大型企业或技术团队充足者。
- 通过聚合支付网关：如PagueloFacil、PayU Latam、Dlocal、Paddle等已集成 Efecty 的平台，只需配置即可启用，开发量小。
- 使用 SaaS 建站工具插件：部分支持拉美市场的 Shopify 第三方支付 App 内含 Efecty 选项。
步骤 4：技术对接核心流程
- 注册并获取 API Key 和商户 ID（由 Efecty 或代理提供）
- 在独立站支付流程中添加 Efecty 选项
- 调用
/create-payment接口发送订单信息（金额、订单号、客户手机号等） - 接收 Efecty 返回的参考码（reference code）和二维码
- 展示给用户用于线下支付
- 配置 Webhook 地址接收支付结果回调（IPN - Instant Payment Notification）
- 验证签名后自动更新订单状态
步骤 5：测试与上线
- 使用沙箱环境进行全流程测试（创建订单→生成码→模拟支付→接收通知）
- 确保 Webhook 可被公网访问且返回 200 状态码
- 监控前100笔交易的人工核对情况
- 正式切换为生产环境密钥
步骤 6：日常运营与对账
- 每日导出 Efecty 提供的结算报表（CSV/PDF）
- 比对内部订单系统中的“已支付”状态
- 处理异常订单（如超期未付、重复支付）
- 跟进退款请求并执行非现金返还流程
费用/成本通常受哪些因素影响
- 月交易 volume（交易笔数或总金额）
- 单笔交易金额区间（阶梯费率）
- 是否通过代理/中间服务商（加价可能性）
- 技术支持服务是否包含在套餐内
- 是否有最低月费或年费承诺
- 汇率转换成本（若结算为 COP 哥伦比亚比索）
- 退款处理手续费（如有）
- Webhook 通知失败后的手动查询成本
- 是否需要额外购买防欺诈模块
- 合同谈判能力及合作关系深度
为了拿到准确报价，你通常需要准备以下信息：
- 预计月均交易笔数与GMV
- 目标国家与币种
- 现有技术架构（是否使用Shopify、自研系统等）
- 是否已有本地公司或银行账户
- 历史支付渠道表现数据（拒付率、成功率）
常见坑与避坑清单
- 未设置订单有效期：导致库存长期占用，建议设定24-72小时过期规则。
- 忽略Webhook签名校验：易被伪造支付通知，造成虚假发货。
- 未监控回调失败：网络问题可能导致通知丢失，应定期主动查询待支付订单状态。
- 误以为支持即时到账：实际结算有延迟，需做好现金流规划。
- 未告知用户支付地点：应在支付页面明确提示“可在 Efecty 合作门店付款”，并提供查询链接。
- 退款流程不透明：现金无法原路退回，需提前说明退款方式（如 PayPal、银行转账）。
- 忽视语言本地化：支付页面、短信通知应使用西班牙语。
- 过度依赖单一本地支付方式：建议同时接入 PSE（网银转账）、Baloto 等互补渠道。
- 未保留支付凭证：要求用户提供付款小票照片作为争议依据。
- 跳过沙箱测试：直接上线易出现格式错误或签名异常导致失败。
FAQ（常见问题）
- Efecty现金收款API接入教程商家独立站全面指南 靠谱吗/正规吗/是否合规？
Efecty 是哥伦比亚合法注册的支付服务机构，受金融监管机构 Superintendencia Financiera de Colombia 监督。但中国卖家直接接入需通过合规代理或本地实体，否则存在法律风险。 - Efecty现金收款API接入教程商家独立站全面指南 适合哪些卖家/平台/地区/类目？
适合面向哥伦比亚市场的独立站卖家，尤其是中低价电子产品、时尚配件、家居用品类目。不适合高单价、急需发货或对账期敏感的商品。 - Efecty现金收款API接入教程商家独立站全面指南 怎么开通/注册/接入/购买？需要哪些资料？
中国卖家通常无法直接注册。需通过已接入 Efecty 的支付服务商（如 Dlocal、PayU）开通账户，提供企业营业执照、法人身份证、网站域名、产品类目说明等资料。 - Efecty现金收款API接入教程商家独立站全面指南 费用怎么计算？影响因素有哪些？
费用结构由合作的服务商决定，一般包含交易手续费（百分比+固定费）、月费、结算费等。具体取决于交易量、金额、是否含汇率服务等因素，需索取正式报价单。 - Efecty现金收款API接入教程商家独立站全面指南 常见失败原因是什么？如何排查？
常见原因包括：API 密钥错误、订单金额超出限额、Webhook 地址不可达、用户未在有效期内付款、手机号格式不符。排查方法：查看日志、测试沙箱、联系技术支持获取响应码说明。 - 使用/接入后遇到问题第一步做什么？
首先确认是否收到 Efecty 官方或服务商的技术文档；其次检查 API 请求参数、HTTPS 证书、Webhook 回调地址可用性；最后联系服务商客服并提供订单号、时间戳、错误截图。 - Efecty现金收款API接入教程商家独立站全面指南 和替代方案相比优缺点是什么？
对比 Baloto：功能类似，覆盖率相近，费率可能不同；
对比信用卡：Efecty 转化更高但到账慢；
对比 PayPal：Efecty 更本地化，但无内置纠纷机制；
建议组合使用多种支付方式以最大化覆盖。 - 新手最容易忽略的点是什么？
一是未设置订单过期机制，导致库存僵化；二是未做 Webhook 签名校验，存在安全漏洞；三是未向用户清晰说明“如何找到 Efecty 门店”，影响支付完成率。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业