Efecty现金取现接口文档开发者APP应用收费标准
2026-02-24 3
详情
报告
跨境服务
文章
Efecty现金取现接口文档开发者APP应用收费标准
要点速读(TL;DR)
- Efecty 是哥伦比亚主流的线下现金支付网络,支持买家通过便利店、代理点等渠道用现金付款,卖家可通过其API接入实现本地化收款。
- “现金取现接口”通常指Efecty为商户提供的用于生成现金支付凭证(含条码、参考号等)的技术接口,买家凭此在网点支付现金。
- 开发者需调用Efecty官方提供的API文档完成订单创建、状态查询、回调通知等对接流程。
- APP应用指集成该接口的电商平台或独立站移动端,需符合Efecty安全与数据规范。
- 收费模式多为按笔计费+可能的服务费,具体费用结构需与Efecty或其合作收单机构/支付网关协商确定。
- 中国跨境卖家使用时建议通过已签约的第三方支付服务商接入,避免直接对接带来的合规与技术门槛。
Efecty现金取现接口文档开发者APP应用收费标准 是什么
Efecty现金取现接口文档开发者APP应用收费标准是指中国跨境卖家在面向哥伦比亚市场销售时,若希望支持当地消费者使用Efecty进行线下现金支付,需要通过技术对接其支付系统,并了解相关开发、使用及费用规则的一整套操作指南与成本说明。
关键词解释
- Efecty:哥伦比亚领先的非银行支付网络,覆盖超3万家线下网点(如Alkosto、D1、Éxito等),用户可凭支付代码在门店以现金完成交易。
- 现金取现接口:实为现金支付接口,允许商户系统生成唯一的支付参考码(reference code)和条形码,供买家线下支付。并非“取现”功能,而是“收现”入口。
- 接口文档:由Efecty或其授权合作伙伴提供的API技术文档,包含请求地址、参数格式、签名方式、回调机制、错误码等,用于系统对接。
- 开发者APP应用:指卖家自建或委托开发的电商APP、小程序、H5页面等前端应用,需集成Efecty支付模块以触发接口调用。
- 收费标准:指每笔通过Efecty完成的现金支付所收取的服务费用,通常包括固定手续费、汇率服务费、退款处理费等,具体由收单方制定。
它能解决哪些问题
- 痛点:哥伦比亚信用卡渗透率低(不足30%)→ 价值: 支持现金支付显著提升转化率,覆盖更广人群。
- 痛点:国际卡支付拒付率高 → 价值: 现金支付为预付费模式,资金到账后结算,降低欺诈与争议风险。
- 痛点:本地支付方式缺失影响排名 → 价值: 接入Efecty有助于提升在拉美电商平台(如Mercado Libre)的店铺权重。
- 痛点:缺乏技术对接能力 → 价值: 通过标准化API文档可实现自动化订单同步与状态更新。
- 痛点:资金回款周期长 → 价值: 部分服务商提供T+1或T+3结算,优于传统电汇。
- 痛点:语言与合规障碍 → 价值: 合作支付网关提供中文支持与本地合规适配。
- 痛点:无法追踪支付状态 → 价值: API支持异步通知(webhook),实时获取支付成功/失败状态。
- 痛点:客户因无支付方式放弃下单 → 价值: 增加Efecty选项可提升平均客单价与复购率。
怎么用/怎么开通/怎么选择
常见接入流程(适用于中国跨境卖家)
- 确认业务需求:明确是否主营哥伦比亚市场,目标平台是独立站还是本地电商平台。
- 选择接入方式:
- 若使用Mercado Pago、Dlocal、PagSeguro等全栈支付服务商,检查其是否已集成Efecty;
- 若自研系统,需通过服务商申请Efecty通道权限。
- 注册商户账户:在选定的支付网关平台完成企业认证(需营业执照、法人身份证、银行账户等)。
- 获取API文档:登录服务商后台下载Efecty接口文档,包含生产环境地址、测试沙箱、密钥分配等信息。
- 技术开发与联调:
- 开发人员根据文档实现订单创建接口调用;
- 配置Webhook接收支付结果通知;
- 在沙箱环境中完成模拟支付测试。
- 上线与监控:切换至正式环境,开启首单监控,确保支付凭证正确生成并可被门店识别。
注意:Efecty不直接对中国卖家开放直连,必须通过具备本地收单资质的持牌支付机构或聚合服务商接入。
费用/成本通常受哪些因素影响
- 月交易笔数与总金额(交易量越大议价空间越高)
- 单笔手续费定价模式(固定费率 vs. 阶梯计价)
- 是否包含货币转换服务(COP兑USD/CNY汇率加点)
- 支付网关平台的基础服务费或年费
- 退款处理是否收费及频率
- 结算周期(T+1比T+7成本更高)
- 是否需要定制化开发支持(如多仓库映射、发票生成)
- 是否有欺诈监控或风控附加服务费
- 合同签约主体为境内公司还是境外子公司
- 是否使用服务商提供的虚拟哥伦比亚银行账户
为了拿到准确报价,你通常需要准备以下信息:
- 预计月均订单量与GMV
- 目标国家(仅哥伦比亚 or 多国)
- 销售渠道(独立站、APP、Marketplace)
- 技术支持能力(是否有开发团队)
- 期望结算币种(COP, USD, CNY)
- 是否需要发票自动化处理
- 历史拒付率数据(如有)
常见坑与避坑清单
- 误以为Efecty支持“提现”功能:实际为“现金收款”,不能用于卖家取款,谨防理解偏差导致沟通失误。
- 忽略支付时效限制:Efecty支付码通常有效期为24-72小时,超时未付需重新生成订单,系统应自动关闭过期订单。
- 未设置可靠Webhook回调:依赖页面跳转判断支付状态易丢失数据,必须启用服务器间通知机制。
- 未做西班牙语用户提示:支付成功页、短信指引应使用本地语言,减少客诉。
- 直接联系Efecty官网寻求合作:其主要服务本地企业,中国卖家难以通过审核,建议优先考察Dlocal、Pagsmile、Checkout.com等成熟通道。
- 忽视对账文件格式差异:Efecty结算单可能为CSV或XML,需提前确认字段定义(如reference ID、fee amount)以便财务核销。
- 未测试条码可读性:生成的条形码需保证打印清晰、尺寸合规,否则门店扫码失败。
- 忽略反洗钱KYC要求:部分服务商会在大额交易时要求补充资金来源证明,应提前备档。
- 默认所有网点均可支付:不同连锁店(如Alkosto与D1)支持范围略有差异,应在前端提示推荐网点。
- 未建立异常订单处理流程:如出现“已付未通知”情况,需有申诉通道与人工核查机制。
FAQ(常见问题)
- Efecty现金取现接口靠谱吗/正规吗/是否合规?
是正规支付方式,Efecty受哥伦比亚金融监管局(Superintendencia Financiera de Colombia)监督,合规运营。但中国卖家须通过合法持牌支付机构接入,确保跨境资金流合规。 - Efecty现金取现接口适合哪些卖家/平台/地区/类目?
适合主攻哥伦比亚市场的跨境卖家,尤其是独立站、SHEIN类快时尚、3C电子、家居大件等高价商品类目。平台端常见于Mercado Libre Colombia,自营APP也可集成。 - Efecty现金取现接口怎么开通/注册/接入/购买?需要哪些资料?
需通过第三方支付服务商开通,一般需要:营业执照、法人身份证、银行开户证明、网站/App截图、业务描述及预期交易规模。个人卖家通常无法申请。 - Efecty现金取现接口费用怎么计算?影响因素有哪些?
费用由合作收单方制定,常见为每笔固定费用+汇率服务费。影响因素包括交易量、结算周期、是否含换汇、是否有额外风控服务等,具体以合同为准。 - Efecty现金取现接口常见失败原因是什么?如何排查?
常见原因:支付码过期、门店系统故障、买家输入错误参考号、Webhook未收到回调。排查步骤:查日志确认接口返回码 → 核对支付链接有效性 → 联系服务商查对账单 → 提供reference code人工验证。 - 使用/接入后遇到问题第一步做什么?
立即查看API调用日志与错误码,确认请求参数与签名是否正确;同时登录支付服务商后台查看交易状态;若仍无法解决,提交工单并附上request_id、timestamp、reference_code等关键信息。 - Efecty现金取现接口和替代方案相比优缺点是什么?
对比PSE(在线银行转账):Efecty无需网银,更适合无卡人群,但需出门支付;对比Baloto:两者定位相似,覆盖率接近,建议同时接入;对比信用卡:Efecty无拒付风险,但到账慢1-2天。 - 新手最容易忽略的点是什么?
一是未设置自动过期订单清理机制,导致库存被长期锁定;二是未做本地化支付引导,用户不知道去哪里支付;三是忽略对账自动化,手工核销效率低易出错。
相关关键词推荐
关联词条
活动
服务
百科
问答
文章
社群
跨境企业

