（13307期）Pay Bills – 尼日利亚话费流量即时充值

尼日利亚话费流量即时充值 尼日利亚话费流量充值 API，支持钱包余额支付、联系人管理与通知偏好设置 使用说明 核心用法 CreditWithBleon 是面向尼日利亚市场的数字产品充值 API，主要提供话费、流量及教育类产品的购买服务。开发者需通过多步骤认证流程获取会话令牌，使用钱包余额完成即时支付。 认证流程：采用分阶段手机号验证机制，新用户需完成 OTP → 设置 PIN → 完善资料 → 邮箱验证四步；老用户设备识别后可直接输入 PIN。提供 Node.js 辅助脚本管理会话状态与设备 ID 生成。 充值流程：所有订单需先标准化手机号（normalize），预测运营商（predict），获取实时套餐列表（active 状态），确认余额充足后提交订单。trx_id 必须唯一生成，禁止硬编码或复用。 特色功能： 联系人管理：支持保存常用号码，通过名称快速充值（如"给 Mum 买流量"） 通知偏好：细粒度控制 12 类消息渠道（邮件/站内信），涵盖订单、充值、退款、营销等 智能推荐：基于 recent-phones 实现"重复上次充值"快捷操作 显著优点 本地化深度：尼日利亚四大运营商实时状态检测，自动识别网络前缀，避免跨网错误 支付体验：钱包支付即时到账，无需跳转，适合代理/高频场景 状态追踪：订单状态机清晰（pendingpayment → orderreceived → completed/failed），支持轮询查询 安全设计：PIN 错误 5 次锁定 5 分钟，OTP 每小时限发 5 条，会话令牌持久化管理 潜在局限 地域限制：仅支持尼日利亚本地号码（+234） 汇率/定价：文档未说明货币汇率更新机制，国际开发者需注意 ₦ 结算 无 Webhook：订单状态需主动轮询，无服务端推送 文档缺口：缺少错误码完整列表、退款 SLA 时效说明 适合人群 尼日利亚本地生活服务平台开发者 跨境支付/汇款应用的增值服务商 需要集成话费流量充值的超级应用（Super App） 代理分销系统（Agent Network）搭建者 常规风险 | 风险点 | 说明 ||--------|------|| 会话令牌泄露 | Bearer Token 存储于本地 .session_token，多用户环境需隔离 || trx_id 重复 | 重复提交可能导致重复扣款或订单冲突，必须使用生成脚本 || 运营商状态 | 网络维护时（down 状态）下单会失败，需前置检查 || 余额不足 | 未检查余额直接下单会导致支付失败，建议先 GET /user/balance || 手机号格式 | 必须调用 normalize 接口，自行处理易错（如 0 前缀、+234 混用）| 原始说明 Purchase data, airtime, and digital products for Nigerian phone numbers instantly using wallet balance with network and plan validation.