캄보디아 OTP API와 +855 인증 번호

Q: API에서 캄보디아의 국가 ID는 무엇인가요?

GET /api/v1/prices와 POST /api/v1/activations의 본문에서 kh를 사용하세요.

캄보디아 테스트에는 일회용 번호와 장기 회선 중 무엇이 맞나요?

이후 모든 것이 달라지므로 먼저 이 결정부터 하세요. OTP Route는 두 가지 상품을 판매하는데, 현재 캄보디아를 지원하는 것은 그중 하나뿐입니다.

OTP Gateway — 인증 한 건을 위해 확보되는 +855 번호입니다. 서비스를 고르면 플랫폼이 번호를 배정하고, 처음 도착한 코드가 내 것이 됩니다. 가입 QA, 일회성 로그인 확인, 현지화된 온보딩 화면이 캄보디아 입력을 받는지 점검하는 데 적합합니다. OTP Gateway 개요를 참고하세요.
전용 번호(Dedicated Numbers) — 계속 갱신하며 보유하는 회선으로 월 $1.95부터 시작하고, 수신 SMS, 발신 SMS, 브라우저 통화를 지원합니다. 셀프서비스로는 미국과 캐나다에서만 판매됩니다.

셀프서비스로 쓸 수 있는 장기 +855 회선은 없습니다. 프로젝트에 정말 필요하다면 [email protected]으로 이메일을 보내 사용 사례를 설명해 주세요. 마련할 수 있는지는 현지 규정에 따라 다르므로 약속이 아니라 문의로 생각하세요. 임시 번호와 전용 번호 비교 글에서 +855 프로젝트에 어느 쪽이 맞는지 살펴볼 수 있습니다.

캄보디아 인증 번호로 어떤 서비스를 처리할 수 있나요?

캄보디아의 라이브 스냅샷에는 1,700개 넘는 서비스가 올라와 있습니다. 팀들이 가장 많이 찾는 서비스로는 Telegram, Facebook, WhatsApp, Google (Gmail & YouTube), TikTok, Instagram, LINE, WeChat, Zalo, Viber, ChatGPT (OpenAI), Shopee, Lazada가 있습니다.

이 구성은 메시징 앱과 지역 쇼핑 플랫폼이 나란히 쓰이는 시장의 특성을 보여 줍니다. 그래서 동남아시아 제품 팀은 같은 국가 코드로 여러 흐름을 한 번에 점검할 수 있습니다. 통신사 경로가 갱신되면서 이용 가능 여부는 하루 중에도 바뀌므로, API는 고정된 카탈로그 대신 조회하는 순간에 주문 가능한 항목을 알려 줍니다.

캄보디아 OTP API 흐름은 처음부터 끝까지 어떻게 동작하나요?

모든 호출은 개발자 콘솔에서 발급받은 or_live_ 접두사의 Bearer 키와 함께 https://otproute.com/api/v1로 보냅니다. 캄보디아의 국가 ID는 kh입니다.

GET /api/v1/services와 GET /api/v1/countries를 호출해 이름을 ID에 매핑하고, 둘 다 캐시하세요.
GET /api/v1/prices?country=kh&service=<id>로 원하는 경로의 현재 가격과 이용 가능 여부를 확인합니다.
본문 {"service": "telegram", "country": "kh"}로 POST /api/v1/activations를 호출해 주문합니다. 활성화 ID와 +855 번호가 반환됩니다.
그 번호를 자사 앱의 인증 단계에 입력합니다.
activation.sms_received 웹훅으로 코드를 받거나 GET /api/v1/activations/{id}를 폴링합니다.

웹훅 전송에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 <t>.<raw body>의 HMAC-SHA256을 다시 계산해 상수 시간 방식으로 비교하고, 오래된 타임스탬프는 버리세요. 캄보디아 테스트 스위트는 최대 키 10개와 웹훅 엔드포인트 5개에 트래픽을 분산할 수 있으며, 계정 전체 한도는 분당 300건입니다. 페이로드 세부 내용은 API 문서에 있습니다.

대시보드에서 테스트용 +855 번호 주문하기

지원팀과 프로덕트 매니저도 코드 없이 같은 결과를 얻을 수 있습니다.

로그인하고 OTP Gateway 페이지를 엽니다.
캄보디아를 고른 다음 인증하려는 서비스를 선택합니다.
화면에 표시된 가격을 확인하고 주문을 확정합니다.
확인 중인 앱이나 웹사이트에 +855 번호를 복사해 넣습니다.
활성화 카드를 지켜보세요. SMS가 전달되면 문자 내용과 추출된 코드가 그곳에 나타납니다.

코드가 나타나기 전에 마음이 바뀌면 활성화를 취소하세요. 금액이 지갑으로 환불됩니다.

+855 번호 형식과 크메르어 메시지 읽기

캄보디아 번호는 현지에서 트렁크 프리픽스 0과 함께 쓰며, 예를 들어 휴대폰은 0xx xxx xxx로 표기됩니다. E.164에서는 맨 앞의 0이 사라지고, 저장 값은 +855 뒤에 국내 번호를 붙인 형태이며 휴대폰은 보통 8자리 또는 9자리입니다. 시스템 경계에서 정규화하세요. 공백, 하이픈, 트렁크 0을 제거한 뒤 +855를 앞에 붙이면 조회, 중복 제거, 웹훅 매칭이 모두 하나의 표준 문자열로 동작합니다.

공용어는 크메르어이며 고유한 유니코드 문자를 씁니다. 일부 서비스는 숫자 주변에 크메르어 문구를 넣어 코드를 보내고, 다른 서비스는 기본적으로 영어를 쓰며, 같은 앱도 계정 로캘에 따라 달라질 수 있습니다. 주변 문구를 매칭하지 말고 숫자 패턴으로 코드를 추출하고, 로그와 데이터베이스가 UTF-8을 올바르게 저장하는지 확인하세요.

팀들이 +855를 찾는 이유는 보통 태국, 베트남 같은 이웃 국가와 함께하는 지역 출시, 크메르어 현지화 QA, 캄보디아 SIM으로 가입한 고객 지원입니다.

캄보디아 코드가 끝내 오지 않으면 어떻게 되나요?

규칙은 간단합니다. 전달된 코드에 대해서만 요금을 냅니다. 20분 안에 아무것도 오지 않거나 먼저 취소하면 청구 금액 전액이 자동으로 지갑에 환불됩니다.

코드가 늦을 때는 이렇게 하세요.

1분 만에 취소하지 말고 창이 끝날 때까지 기다리세요. 일부 발신자는 메시지를 대기열에 쌓아 둡니다.
서비스가 가상 번호를 허용하는지 확인하세요. 일부는 거부하며, 환불이 존재하는 이유가 바로 이것입니다.
나중에 다시 시도하거나 같은 테스트에 다른 서비스 경로를 써 보세요.
짧은 간격으로 반복 주문하지 마세요. 재시도 간격을 두고 활성화 ID를 매번 로그에 남기세요.

크메르 시장 테스트 실행을 안정적으로 유지하는 재시도 습관은 OTP 전송 실패 줄이기 글에 더 정리되어 있습니다.

캄보디아 인증 요금 결제와 샌드박스 테스트

OTP Route의 OTP 라우팅은 월 요금이나 선택할 요금제 없이 하나의 선불 USD 지갑으로 운영됩니다. 카드 또는 USDT/USDC 스테이블코인으로 충전하며, 잔액을 충전할 때마다 재무팀이 쓸 PDF 인보이스가 이메일로 발송됩니다. 현재 요금은 요금 페이지에서 확인하세요.

CI 파이프라인을 실제 번호에 연결하기 전에 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 시뮬레이션된 번호와 코드가 반환되어 자금을 쓰지 않고도 연동을 처음부터 끝까지 실행할 수 있습니다. 게이트웨이는 자사 제품과 계정에만 사용하고, 각 서비스의 약관을 따르며, OTP Route의 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요.

자주 묻는 질문

현지 SIM 없이 우리 앱의 캄보디아 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 +855 번호를 주문해 가입 폼에 입력하고, 대시보드나 API로 코드를 읽으면 됩니다.

API에서 캄보디아의 국가 ID는 무엇인가요?

GET /api/v1/prices와 POST /api/v1/activations의 본문에서 kh를 사용하세요.

캄보디아 번호는 맨 앞의 0을 포함해 저장해야 하나요?

아니요. 트렁크 0을 제거하고 E.164 형식으로 +855에 국내 번호를 붙여 저장하세요. 0은 현지 형식으로 표시할 때만 다시 붙이세요.

+855 번호를 몇 달 동안 유지할 수 있나요?

셀프서비스 상품으로는 불가능합니다. 장기 전용 번호(Dedicated Numbers)는 미국과 캐나다에서 제공됩니다. 캄보디아는 [email protected]으로 문의할 수 있지만 가능하다는 보장은 없습니다.

코드는 크메르어로 오나요, 영어로 오나요?

서비스와 계정의 언어 설정에 따라 다릅니다. 고정된 문구에 의존하지 말고 숫자를 파싱하세요.

SMS가 실패하면 요금이 부과되나요?

아니요. 20분 창이 닫힐 때까지 코드가 오지 않은 활성화는 지갑으로 전액 환불됩니다.

비용을 쓰지 않고 테스트할 방법이 있나요?

네. 요청하시면 개발 계정을 샌드박스로 전환해 시뮬레이션된 번호와 코드를 받을 수 있습니다.

서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.

캄보디아(+855) 인증 코드에 맞는 경로 고르기