승인 후 영업팀이 접근 권한을 활성화한 파트너는 API를 사용할 수 있습니다. 파트너 대시보드에서 읽기 전용 또는 주문 가능 키를 만드세요. 모든 구매는 선불 USD 지갑을 사용합니다.
API 빠른 시작
계정 승인 후 영업팀에서 가격을 지정하고 API 접근을 활성화합니다. 파트너 대시보드에서 키를 만드세요. 읽기 전용 키로는 주문할 수 없습니다. 계정의 구매 권한도 활성화되어야 합니다.
https://simvoro.com/api/partner/v1모든 요청에 서버 측 bearer 키를 사용하세요. 브라우저 코드나 URL에 키를 넣지 마세요. 파트너 대시보드에서 키를 폐기할 수 있습니다.
Authorization: Bearer YOUR_API_KEY| 메서드 | 엔드포인트 | 결과 |
|---|---|---|
| GET | /products?destination=japan | 지정된 USD 가격과 상품 ID입니다. 목적지 slug로 필터링하고 cursor로 페이지를 이동합니다. |
| GET | /balance | 지갑 잔액, 예약된 금액 및 사용 가능한 USD입니다. |
| GET | /transactions | 지갑 거래와 nextCursor입니다. |
| GET | /orders | 파트너 주문 요약과 nextCursor입니다(페이지당 50건). |
| POST | /orders | 자금을 예약하고 eSIM 한 개를 주문합니다. 주문 권한이 있는 키가 필요합니다. |
| GET | /orders/{orderId} | 주문 상태, 마지막 동기화 기준 데이터 사용량 및 발급 후 설치 정보입니다. |
주문 생성
Idempotency-Key에 UUID를 보내세요. 시간 초과나 연결 오류 후에도 같은 UUID를 재사용하세요. 고객이 확인한 가격을 보내고 수신 기기가 eSIM을 지원하며 통신사 잠금이 해제되었는지 확인하세요. 실제 가격이 변경되면 409 PRICE_CHANGED가 반환됩니다. 실제 운영 API이므로 접수된 구매에는 실제 지갑 자금이 사용됩니다.
POST /api/partner/v1/orders
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: 83c77d9f-395f-4ff0-8ed6-c461bda46559
{"productId":"PRODUCT_ID_FROM_CATALOG","expectedPrice":"2.25","deviceConfirmed":true}201 응답에는 orderId와 esim이 포함됩니다. esim.status와 esim.failure를 확인하세요. 10초 간격으로 주문을 조회하세요. 자금은 먼저 예약되고 eSIM 발급이 확인되면 차감됩니다. 재요청 시 실패한 주문이 반환될 수도 있습니다. 공급업체 처리 결과가 불확실하면 원래 주문을 대조하는 동안 자금이 계속 예약됩니다. 설치 정보는 비공개이며 발급 확인 후에만 표시됩니다.
금액은 USD 십진수 문자열입니다. 목록은 items와 nextCursor를 반환하며 nextCursor가 null이 될 때까지 계속 조회하세요. 한도는 키당 분당 120개 요청 및 사용자당 분당 10회 구매 시도입니다. 429 응답의 Retry-After를 따르세요. 주요 오류: 401 잘못된 키, 403 권한 없음, 402 잔액 부족, 404 접근할 수 없는 주문, 409 가격 또는 멱등성 충돌, 503 서비스 이용 불가. 다시 구매하기 전에 원래 주문을 조회하세요.
요청에 포함할 내용
- 플랫폼 소개와 주요 고객층
- 월 예상 물량
- 제공하려는 여행지
- 시스템에 필요한 기능(예: eSIM 주문 및 고객에게 QR 코드 표시)
파트너 신청
신청서를 보내 주시면 저희 팀이 신청 내용에 관해 연락드려요.