여행용 eSIM을 자체 제품에 담으세요
하나의 REST API로 자체 앱이나 웹사이트에서 eSIM을 판매하세요. 카탈로그를 검색하고, 주문하고, 바로 설치할 수 있는 eSIM을 자체 브랜드로 고객에게 제공할 수 있습니다.
eSIM의 전체 수명 주기를 자체 제품 안에서
요금제 선택부터 여행 중 데이터 충전까지, 고객이 거치는 모든 단계가 직접 제어하는 API 호출입니다.
카탈로그의 모든 요금제를 판매하세요
국가, 지역, 데이터, 기간으로 요금제를 필터링한 뒤 한 번의 호출로 고객 주문을 넣으세요. 모든 요금제는 실제로 지불하실 가격과 함께 반환됩니다.
- 국가, 지역, 데이터, 일수로 필터링
- 주문 금액은 선불 잔액에서 결제
- 멱등성 키로 안전하게 재시도
자체 흐름 안에서 eSIM을 전달하세요
주문이 처리되면 웹훅으로 또는 주문을 조회해 ICCID, LPA 활성화 문자열, QR 코드를 받습니다.
- 서명된 order.fulfilled 웹훅
- 바로 보여 주거나 이메일로 보낼 수 있는 PNG QR 코드
- 앱에서 원탭 설치를 위한 LPA 문자열
판매 후에도 여행자의 연결을 지키세요
데이터 충전 제공, 새 휴대폰으로 eSIM 이전, 대상 주문 환불, 인보이스 다운로드까지 모두 같은 API로 처리합니다.
- 계정에 맞춘 충전 가격
- 새 기기에 eSIM 재설치
- 주문별 환불과 PDF 인보이스
자신 있게 출시하는 데 필요한 모든 것
무료 샌드박스
테스트 키로 주문부터 eSIM, 웹훅까지 전체 흐름을 실행할 수 있습니다. 통신망을 호출하지도, 잔액을 쓰지도 않습니다.
서명된 요청
모든 요청은 HMAC-SHA256과 타임스탬프로 서명되며, 재전송된 요청은 거부됩니다. 키는 서버의 IP 주소에서만 쓰도록 제한할 수 있습니다.
재시도하는 웹훅
주문, eSIM, 충전, 잔액에 대한 서명된 이벤트를 백오프 방식으로 하루 넘게 재시도하며, 다시 보낼 수 있는 전송 로그를 제공합니다.
안전한 재시도
주문과 충전 요청에 Idempotency-Key를 보내세요. 24시간 안에 같은 요청이 반복되면 두 번 청구하지 않고 첫 번째 응답을 반환합니다.
OpenAPI 3.1 명세
명세를 Postman으로 가져오거나 타입이 지정된 클라이언트를 생성하세요. 문서의 curl, Node, Python 예제로 시작할 수도 있습니다.
범위가 지정된 키, 명확한 한도
키마다 읽기, 주문, 전체 권한을 부여하세요. 요청 한도는 키별로 적용되며, 인증된 모든 응답에 남은 한도가 표시됩니다.
문서 살펴보기
모든 엔드포인트에 복사해 쓸 수 있는 요청과 응답이 있습니다. 키로 서명하고 샌드박스를 대상으로 바로 시작하세요.
curl --request GET \
--url 'https://api.roamgo.net/api/partner/v1/plans?country=JP&minDays=7' \
--header 'Authorization: Roamgo-HMAC-SHA256 keyId=<KEY_ID>, ts=<UNIX>, sig=<SIGNATURE>'{
"plans": [{
"id": "cm...",
"name": "Japan · 10 GB · 30 days",
"region": "Japan",
"countries": ["JP"],
"dataAmountMB": 10240,
"validityDays": 30,
"yourPriceCents": 1840,
"currency": "USD"
}],
"page": 1,
"pageSize": 24,
"total": 18
}curl --request POST \
--url 'https://api.roamgo.net/api/partner/v1/orders' \
--header 'Authorization: Roamgo-HMAC-SHA256 keyId=<KEY_ID>, ts=<UNIX>, sig=<SIGNATURE>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <UNIQUE_KEY>' \
--data '{"planId":"cm_plan_id","quantity":1,"customerEmail":"traveler@example.com","externalRef":"BOOKING-49102"}'HTTP/1.1 202 Accepted
{
"order": {
"id": "cm_order_id",
"status": "PAID",
"customerEmail": "traveler@example.com",
"totalCents": 1840,
"currency": "USD"
}
}curl --request GET \
--url 'https://api.roamgo.net/api/partner/v1/esims/cm_esim_id/qr' \
--header 'Authorization: Roamgo-HMAC-SHA256 keyId=<KEY_ID>, ts=<UNIX>, sig=<SIGNATURE>' \
--output esim-qr.pngHTTP/1.1 200 OK
Content-Type: image/png
Cache-Control: private, max-age=3600curl --request POST \
--url 'https://api.roamgo.net/api/partner/v1/esims/cm_esim_id/topups' \
--header 'Authorization: Roamgo-HMAC-SHA256 keyId=<KEY_ID>, ts=<UNIX>, sig=<SIGNATURE>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <UNIQUE_KEY>' \
--data '{"topUpProviderPlanId":"tu_q3J9v0cX2mBf7Lr1sPz8Kd","externalRef":"BOOKING-49102-TOPUP-1"}'HTTP/1.1 201 Created
{
"topUp": {
"id": "cm_topup_id",
"status": "COMPLETED",
"priceCents": 480,
"currency": "USD"
}
}import crypto from "node:crypto";
// X-Roamgo-Signature: t=<unix>,v1=<hex>
export function verifyRoamgoSignature(rawBody: string, header: string, secret: string) {
const match = header.match(/^t=(\d+),v1=([0-9a-f]+)$/);
if (!match) return false;
const [, ts, v1] = match;
if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(`${ts}.${rawBody}`)
.digest("hex");
return crypto.timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(v1, "hex"));
}{
"id": "evt_8d…",
"type": "order.fulfilled",
"createdAt": "2026-09-30T09:14:02.118Z",
"livemode": true,
"data": {
"order": {
"id": "cm_order_id",
"status": "FULFILLED",
"items": [{
"esims": [{
"iccid": "8910…",
"lpaString": "LPA:1$...",
"status": "ISSUED"
}]
}]
}
}
}판매의 모든 단계를 위한 하나의 API
각 리소스에서 파라미터, 오류, 예제가 담긴 레퍼런스로 이동할 수 있습니다.
API를 연동하거나, 코드 없이 출시하세요
API는 판매 방법 중 하나일 뿐입니다. 아래 옵션도 같은 카탈로그, 잔액, 주문 처리 시스템으로 운영됩니다.
샌드박스에서 개발을 시작하세요
무료 파트너 계정을 만들고 대시보드에서 테스트 키를 생성한 뒤, 잔액을 충전하기 전에 QR 코드와 웹훅까지 포함한 전체 주문을 실행해 보세요.