MobileTopup
註冊

REST API v1

手機充值API：自動發送至161國預付費門號

直接連接552家電信商與4,330項產品，從您的伺服器、應用程式或電商平台發送。同樣享有MobileTopup平均低於面額35%的價格，一組金鑰立即啟用。

免費註冊並生成金鑰儀表板內建API文件
基礎網址
/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

    儲值

    支援 USDT、USDC、BTC 和 ETH 等 12 種儲值方式。首次儲值可依金額獲得獎勵金。

  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