REST API v1
モバイルトップアップAPI：161か国のプリペイド携帯電話に自動送信
サーバー、アプリ、またはeコマースプラットフォームから直接552のオペレーターと4,330の商品に接続します。MobileTopupの同じ価格で、額面価格の平均35%安く、1つのキーですぐに開始できます。
- ベースURL
- /api/v1
- 形式
- JSON
- 認証
- X-Api-Key
- レート制限
- キーあたり1分間に300回
ビジネス向けの最も手頃なトップアップAPI
表示されている最低価格と同じ
APIの価格は完全に一致します。すべての商品は額面価格の30%以上安く、送信手数料はありません。 例：フィリピン Globe 50 PHP（価値 $0.78）、API価格 $0.54（30% 額面以下）。
承認なしで即時開始
初回のクレジットチャージ後にダッシュボードからAPIキーを作成できます。契約や最小注文は不要です。
一度にグローバルカバレッジ
161か国と552のオペレーターに、同じシンプルなプロセスで通話料金とデータバンドルを送信できます。
二重支払いの心配なし
注文番号を参照フィールドに添付すれば、同じリクエストが複数回来ても、一度だけ処理し、元の結果を返します。
失敗した場合即座にクレジット返金
オペレーターがチャージを拒否した場合、支払い金額は即座にクレジットとして返金され、明確なエラーコードが返されます。
領収書付きの完全な記録
APIで送信されたチャージは、領収書、チャージコード、オペレーター参照番号とともにダッシュボードの履歴に表示されます。
エンドポイント
プロセス：国、オペレーター、製品を選択し、チャージを送信し、受信したチャージコードを使用してステータスと領収書を確認します。
はじめに
- ステップ 1
新規登録
1つのアカウントトークンで登録。メールや書類は不要です。
- ステップ 2
クレジットを追加
USDT、USDC、BTC、ETHを含む12の方法でクレジットを追加。初回チャージでは金額に応じたボーナスクレジットを獲得できます。
- ステップ 3
APIキーを作成
ダッシュボードでAPIキーを生成。完全なキーは一度だけ表示されるので、直接サーバーの環境変数に保存してください。
- ステップ 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 FAQ
誰がAPIを使用できますか？
MobileTopupのメンバーなら誰でも。アカウントトークンだけで1分でサインアップできます。初回のクレジットチャージが処理された後、ダッシュボードでAPIキーをすぐに生成できます。申請や承認は必要ありません。
APIの価格は表示されているものと同じですか？
はい、同じです。ダッシュボードからトップアップを送信する場合と同じ商品、同じ価格、同じルールです。すべての商品は額面価格の30%以上安く（平均35%の節約）、送信時の追加手数料はありません。支払いはアカウントのクレジットから直接差し引かれます。
重複注文はどのように防止されますか？
トップアップを送信する際に注文IDを参照として含めてください。ネットワークの問題で重複リクエストが発生した場合、最初のリクエストのみを処理し、その結果を後続の試行に返します（"duplicate": true）。
レート制限はありますか？
各キーは1分あたり300リクエストを許可します。これを超えるとHTTP 429が返され、Retry-After（秒数）が表示されます。バルクリクエストは適切に間隔を空けてください。
トップアップが失敗した場合どうなりますか？
オペレーターがトップアップを拒否した場合、支払いは即座にクレジットとして返金されます。レスポンスのエラーコードは自動処理のために一貫しています。
APIキーはどのように保護されていますか？
キーはハッシュ化されて保存され、生成時に一度だけ表示されます。キーを再生成すると、以前のキーは直ちに無効になります。キーはサーバー側でのみ使用することをお勧めします。