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