充值接口是权益数卡面向平台方开放的数字权益供货能力。开发者只需接入下单、查询、回调三个核心接口，即可在自己的 App、小程序、公众号或后台系统内完成影视会员、话费、加油卡等虚拟商品的销售与自动履约，无需自建上游供应链。
什么是充值接口
充值接口本质上是一层标准化的供货协议：平台方提交「商品编号 + 充值账号 + 自定义订单号」，权益数卡在后台完成上游采购与充值，并把结果通过异步回调推送给平台方。整个过程对终端用户是透明的，用户只感知到「下单后几分钟内会员到账」。
与传统人工代充相比，接口模式解决了三个问题：一是履约自动化，不再需要客服手动复制账号去上游下单；二是价格实时，商品价格与库存由接口返回，避免报价与成本脱节；三是可对账，每笔订单都有唯一流水号与状态，财务可按日核对。
接口能做什么
- 商品查询：拉取可售商品列表、面额、当前价格与库存状态，支持按品类筛选。
- 下单直充：提交充值账号（手机号、QQ号、会员账号等）后由上游直接充值到账。
- 卡密提货：批量获取兑换码/卡密，适用于分销、礼品与线下渠道。
- 订单查询：按平台方订单号或系统流水号查询实时状态，支持批量查询。
- 异步回调：充值成功后主动推送结果，附带签名，避免轮询带来的延迟与压力。
支持的核心品类
| 品类 | 代表商品 | 履约方式 | 参考时效 |
|---|---|---|---|
| 视频影音 | 爱奇艺、腾讯视频、优酷、芒果TV、哔哩哔哩 | 直充 / 卡密 | 分钟级 |
| 音乐音频 | QQ音乐、网易云音乐、酷狗、喜马拉雅 | 直充 / 卡密 | 分钟级 |
| 话费流量 | 移动、联通、电信及虚拟运营商 | 直充 | 分钟级至小时级 |
| 加油出行 | 中石化、中石油加油卡、打车券 | 卡密 / 直充 | 分钟级 |
| 餐饮生活 | 美团、饿了么、星巴克、瑞幸、肯德基 | 卡密 | 实时 |
完整商品清单与实时价格请通过商品查询接口获取，或在服务项目查看品类概览。
典型接入场景
App 与小程序
在会员中心或积分商城嵌入充值入口，用户下单后自动到账，减少人工客服成本。
电商与 ERP
对接自有订单系统，将虚拟商品与实物订单一并管理，统一发货与售后流程。
企业福利平台
为员工积分兑换提供后端供货，支持批量下单与集中开票。
对接流程
- 提交资料：提供企业主体信息与业务场景说明，完成账号开通。
- 获取密钥：在控制台获取 AppKey / Secret，配置回调地址与 IP 白名单。
- 沙箱联调：使用测试环境验证下单、查询、回调三条链路，核对签名与幂等逻辑。
- 小额验证：生产环境用最小面额商品跑通真实订单，确认到账时效。
- 正式上线：开启限流与告警，按业务量评估是否需要预充值额度。
技术要点
签名与验签
请求参数按字典序拼接后使用 Secret 做 HMAC 摘要，回调同样携带签名，平台方必须验签后再处理业务，防止伪造通知。
幂等与重试
以平台方订单号作为幂等键，重复提交返回首次结果而非重复扣款；网络超时场景应查询订单状态而不是直接重试下单。
限流与降级
接口按账号维度限流，建议平台方在本地做队列与熔断，上游抖动时降级为「稍后到账」提示，避免用户重复支付。
常见问题
充值接口支持哪些商品品类？
覆盖视频影音会员、音乐会员、话费流量、加油卡、餐饮外卖券、商超卡券、游戏点卡等主流数字权益品类。具体 SKU 与价格以接口实时返回的商品列表为准，支持按品类、面额、运营商筛选。
接口对接需要多长时间？
标准接口对接通常 1 至 3 个工作日：获取密钥与文档半天，沙箱联调 1 天，生产验证半天。若已有订单与支付体系，只需接入下单、查询、回调三个接口即可完成闭环。
直充和卡密两种方式怎么选？
直充由用户提交账号后由上游直接充值到账，体验好、无需手动兑换，适合 App、小程序等自有场景；卡密为批量提货兑换码，适合分销、礼品与线下渠道。两者可在同一账号内并存。
充值失败会退款吗？
会。下单后若上游返回失败或超时未到账，系统按订单状态自动回滚余额，并在回调中返回失败原因。平台方也可通过订单查询接口主动核对，避免重复发货。
是否支持对账与发票？
支持。提供按日/按月的订单明细导出与对账文件，充值记录可按订单号、时间、商品维度核对；采购与技术服务费用可开具增值税发票。
