MobileTopup
注册

REST API v1

手机充值API：自动向161国预付费手机充值

直接连接552家运营商及4,330款产品，适用于您的服务器、应用或电商平台。同等MobileTopup低价（平均比面值低35%），一个密钥即刻启用。

免费注册并生成密钥仪表盘内查看API文档
基础URL
/api/v1
格式
JSON
认证
X-Api-Key
速率限制
每分钟每个密钥300次

最具性价比的企业级充值API

与页面同享最低价

API价格完全匹配。所有产品比面值低30%+且无发送手续费。 例如：菲律宾 Globe 50 PHP（价值 $0.78），API 价格 $0.54（低于面值 30%）。

无需审批，立即开始

首次充值后，注册并直接从仪表板创建您的 API 密钥。无需合同或最低订单。

全球覆盖，一步到位

通过相同的简单流程，向全球 161 个国家和 552 个运营商发送通话时间和数据套餐。

无需担心重复支付

将您的订单号附加到参考字段，即使同一请求出现两次，我们也只会处理一次并返回原始结果。

如果失败，立即退还余额

如果运营商拒绝充值，您的付款金额将立即退还为余额，并附上清晰的错误代码。

完整的记录与收据

通过 API 发送的充值会出现在您的仪表板历史记录中，附有收据、充值代码和运营商参考号。

接口端点

流程：选择国家、运营商和产品，发送充值，然后使用收到的充值代码检查状态和收据。

GET/v1/balance
GET/v1/countries
GET/v1/operators?country=PH
GET/v1/products?operator=PH-GB
POST/v1/recharges
GET/v1/recharges/{code}

入门指南

  1. 第1步

    注册

    仅需一个账户令牌即可注册。无需电子邮件或文件。

  2. 第2步

    充值余额

    通过 12 种方式充值，包括 USDT、USDC、BTC 和 ETH。首次充值可获得基于金额的奖励余额。

  3. 第3步

    创建API密钥

    在仪表板中生成 API 密钥。完整密钥仅显示一次，请直接保存到您的服务器环境变量中。

  4. 第4步

    发送充值

    通过 X-Api-Key 标头发送密钥，并 POST /v1/recharges 以发送充值。

发送充值（cURL）

curl -X POST https://mobiletopup.io/api/v1/recharges \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+639171234567","operator_id":"PH-GB","product_id":"ph-gb-a15c6dd","reference":"order-1042"}'

响应（201）

{ "ok": true, "data": {
  "code": "RC-7KQ2-M9XD-4PWA", "status": "completed",
  "phone": "+639171234567", "operator_id": "PH-GB",
  "receive": "50 PHP", "price": "0.54", "currency": "USD",
  "reference": "order-1042", "duplicate": false
} }

移动充值 API 常见问题

谁可以使用API？

任何MobileTopup会员。仅需账户令牌即可1分钟完成注册。首次充值成功后，仪表盘可立即生成API密钥，无需申请或审批。

API价格与页面显示一致吗？

完全一致。相同产品、相同价格、相同规则，与仪表盘充值完全一致。所有产品比面值低30%+（平均节省35%），发送时不额外收费。支付直接从账户余额扣除。

如何防止重复订单？

发送充值时包含您的订单ID作为参考。若因网络问题导致重复请求，仅处理首条并返回相同结果（"duplicate": true）。

是否有速率限制？

每个密钥每分钟允许300次请求。超额将返回HTTP 429及Retry-After（秒数）。批量请求请合理间隔时间。

充值失败会怎样？

若运营商拒绝充值，款项将立即退还至账户余额。响应中的错误代码保持恒定，便于自动化处理。

API密钥如何保障安全？

密钥经哈希存储且仅在生成时显示一次。重新生成会立即使旧密钥失效。建议仅限服务器端使用。

手机充值API：向161国自动发送话费与流量 | MobileTopup