vigxo 대량 구매 API

여행 eSIM을 발급하다. 프로그램으로.

API를 한 번 호출하면, 같은 요금제의 eSIM 여러 장을 수량 요금으로 주문합니다. 여행자마다 설치 메일을 받을 수 있고, 결과는 상태 URL에서 읽습니다.

이용은 짧은 대화 뒤에 열립니다. 화면에서 혼자 신청해 끝나는 방식이 아닙니다. 요금과 청구 조건을, 자동으로 짐작한 숫자가 아니라 실제 내용으로 맞추기 위해서입니다.

단순함
Idempotency-Key를 붙인 인증된 POST 하나입니다. 호출은 주문을 받아들이고 id를 반환합니다. 같은 키로 다시 호출해도, 그 주문이 또 구매되지는 않습니다.
비동기
발급은 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 레퍼런스 읽기