核心用法
CreditWithBleon 是面向尼日利亚市场的数字产品充值 API，主要提供话费、流量及教育类产品的购买服务。开发者需通过多步骤认证流程获取会话令牌，使用钱包余额完成即时支付。
认证流程：采用分阶段手机号验证机制，新用户需完成 OTP → 设置 PIN → 完善资料 → 邮箱验证四步；老用户设备识别后可直接输入 PIN。提供 Node.js 辅助脚本管理会话状态与设备 ID 生成。
充值流程：所有订单需先标准化手机号（normalize），预测运营商（predict），获取实时套餐列表（active 状态），确认余额充足后提交订单。trx_id 必须唯一生成，禁止硬编码或复用。
特色功能：
- 联系人管理：支持保存常用号码，通过名称快速充值（如"给 Mum 买流量"）
- 通知偏好：细粒度控制 12 类消息渠道（邮件/站内信），涵盖订单、充值、退款、营销等
- 智能推荐：基于
recent-phones实现"重复上次充值"快捷操作
显著优点
1. 本地化深度：尼日利亚四大运营商实时状态检测，自动识别网络前缀，避免跨网错误
2. 支付体验：钱包支付即时到账，无需跳转，适合代理/高频场景
3. 状态追踪：订单状态机清晰（pending_payment → order_received → completed/failed），支持轮询查询
4. 安全设计：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 混用）|