vigxo 大量採購 API

核發旅遊 eSIM，用程式。

一次 API 呼叫，就為一批同一方案的 eSIM 下單，按數量計價。每位旅客可以收到自己的安裝信，結果從狀態 URL 讀取。

開通要先有一次短溝通，不能自助開通。這樣報價和帳單條件才是真的，不是系統猜的數字。

簡單
一次帶 Idempotency-Key 的、已認證的 POST。這次呼叫收下訂單，並回傳一個 id。用同一個 Idempotency-Key 再請求一次，不會把這筆訂單再買一次。
非同步
核發在回 202 之後還會繼續。eSIM 準備好之後，GET 這個訂單，讀取每張的安裝資訊。不用做 webhook。
可控
訂單從你企業帳戶裡的預存餘額支付。每把金鑰可以選配每日和每月的支出上限。
按量計價
按你的數量報價，不是單獨買一張時的那個價格。

怎麼運作

POST https://vigxoesim.com/api/v1/bulk/orders
Authorization: Bearer <your API key>
Idempotency-Key: <unique per attempt>
Content-Type: application/json

{
  "planSlug": "<slug from GET /api/plans>",
  "quantity": 2,
  "locale": "en",
  "travelers": [
    { "name": "Ada Lovelace", "email": "ada@example.com" },
    { "name": "Grace Hopper", "email": "grace@example.com" }
  ]
}

202 { "orderId": "…", "status": "pending" }

GET https://vigxoesim.com/api/v1/bulk/orders/<orderId>

狀態回應裡會列出每一張已經準備好的 eSIM：暱稱、安裝資訊、到期時間。有旅客名單時，每人收到自己的安裝信，你收到一封彙總。沒有名單時，每封安裝信都寄到你的聯絡地址。

閱讀大量採購 API 參考