엔드포인트, 웹훅, 대시보드로 체코 SMS OTP 코드 수신하기

체코 OTP API는 어떤 엔드포인트를 사용하나요?

모든 호출은 https://otproute.com/api/v1에 대해 이루어지며 or_live_ 접두사의 Bearer 키로 인증합니다. 키는 Developer console에서 생성하고 계정당 최대 10개까지 보유할 수 있어, 스테이징·CI·로컬 노트북에 서로 다른 자격 증명을 주고 각각 독립적으로 폐기할 수 있습니다. 요청 제한은 계정당 분당 300건입니다.

일반적인 +420 테스트는 다음과 같이 진행됩니다.

1. 배포마다 한 번 GET /api/v1/countries와 GET /api/v1/services를 호출해 캐시합니다. 체코의 국가 id는 cz입니다.
2. 사용하려는 경로의 실시간 가격을 GET /api/v1/prices?country=cz&service=<id>로 조회합니다. 가격은 서비스와 재고에 따라 바뀝니다.
3. POST /api/v1/activations에 JSON 본문 {"service": "<id>", "country": "cz"}를 보내 activation을 만듭니다. 응답으로 activation id와, 테스트 중인 가입 양식에 입력할 번호를 받습니다.
4. 웹훅으로 기다리거나, 적당한 간격으로 GET /api/v1/activations/{id}를 읽어 코드를 기다립니다.
5. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel로 번호를 해제해 보류 금액이 바로 지갑으로 돌아오게 합니다.

대규모 테스트 묶음을 시작하기 전에 GET /api/v1/balance를 호출해 두면 지갑 잔액이 부족할 때 빠르게 실패 처리할 수 있습니다. 전체 레퍼런스는 문서에 있습니다.

+420 activation의 웹훅은 어떻게 검증하나요?

웹훅을 쓰면 폴링이 필요 없고 병렬 테스트 러너에도 잘 맞습니다. 엔드포인트 하나(Developer console에서 계정당 5개까지 허용)를 체코 흐름에 연결하고 activation.sms_received, activation.expired, activation.cancelled를 구독하세요.

모든 요청에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature 헤더가 포함됩니다. 변경되지 않은 요청 바이트로 <t>.<raw body> 문자열을 다시 만들고, 해당 엔드포인트의 시크릿으로 HMAC-SHA256을 계산한 뒤, 결과를 v1과 상수 시간 비교로 대조하세요. 타임스탬프가 오래되어 새 전달로 보기 어려운 요청은 버립니다. HMAC으로 OTP 웹훅 보호하기 가이드에서 핸들러를 한 줄씩 설명합니다.

이벤트는 activation id를 키로 다루고 핸들러를 멱등하게 만드세요. 재전송된 이벤트가 이미 완료로 표시된 activation을 발견하면 그냥 성공을 반환하면 됩니다. 공개 엔드포인트를 둘 수 없는 환경에서 실행되는 스크립트에는 GET /api/v1/activations/{id} 폴링이 여전히 유효한 대안입니다.

체코 번호로 코드를 보내는 서비스에는 무엇이 있나요?

체코 경로는 현재 1,700개가 넘는 서비스를 지원합니다. 최신 스냅샷에서 인기 있는 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber, ChatGPT (OpenAI)가 있습니다.

이 목록은 고정된 것이 아닙니다. 재고는 하루 동안 바뀌므로 코드에 고정 테이블을 넣지 말고 실행 시점에 API에서 가용 상태를 읽어야 합니다. 필요한 서비스가 한때 보이지 않더라도 나중에 다시 나타날 수 있고, 테스트 시나리오에 따라서는 인접한 중부 유럽 경로가 맞을 수도 있습니다.

체코 인증 번호는 어떻게 저장하고 파싱해야 하나요?

체코는 폐쇄형 번호 체계를 사용합니다. 국내 번호는 9자리이고 트렁크 접두사가 없어서, 국내 형식과 국제 형식의 차이는 앞의 +420뿐입니다. 그래서 정규화가 다른 많은 시장보다 간단하지만, 양식에는 여전히 공백, 00420 국제 접두사, 또는 9자리만 입력되는 경우가 들어옵니다. 구분 문자를 제거하고, 00을 +로 바꾸고, 없으면 +420을 붙인 뒤 결과를 E.164로 저장하세요.

체코 대상 앱의 코드는 보통 체코어나 영어로 도착합니다. 체코어에는 háček, čárka 같은 발음 구별 기호가 쓰이는데 일부 발신자는 메시지를 일반 문자 집합으로 유지하려고 이를 제거하므로, 파서는 문장 전체가 아니라 숫자 그룹을 찾아야 합니다.

팀들은 체코 고객을 위한 제품을 출시하거나, 체코어 온보딩 문구를 점검하거나, 지역 가입 흐름이 앞에 0이 없는 번호를 받아들이는지 확인하려고 +420 번호로 테스트합니다. QA 테스트 페이지에서 팀들이 이런 테스트를 구성하는 방법을 소개합니다.

체코 코드가 끝내 도착하지 않으면 어떻게 되나요?

일부 서비스는 가상 번호를 거부하고, 일부 경로는 특정 시간대에 느립니다. 놓친 코드에는 비용이 들지 않습니다. 20분 제한 시간 안에 SMS가 도착하지 않거나 먼저 취소하면 전액이 자동으로 지갑에 환불됩니다.

• 시도가 실패했다고 판단하기 전에 제한 시간이 끝날 때까지 기다리세요.
• 테스트 중인 서비스가 가상 번호를 허용하는지부터 확인하세요.
• 나중에 다시 시도하거나, 서비스가 지원하는 다른 국가 경로를 써 보세요.
• 시도 사이에 간격을 두세요. 짧은 간격으로 반복 주문하면 요청 제한만 소모되고 도움이 되는 경우가 드뭅니다.
• 모든 실패에 activation id를 로그로 남겨 실행 간 패턴을 확인할 수 있게 하세요.

개발자가 아닌 사람도 대시보드에서 +420 경로를 쓸 수 있나요?

네. 이메일과 6자리 이메일 코드(또는 Google 로그인)로 가입한 뒤 OTP Gateway를 열고, 서비스와 체코를 선택하고, 표시된 가격을 확인한 다음 주문하세요. 체코 인증 번호가 바로 나타나며, 이 번호를 앱에 붙여넣으면 SMS가 도착했을 때 같은 화면에 코드가 표시됩니다. 대시보드에서 취소하면 API 호출과 똑같이 금액이 지갑으로 돌아옵니다.

체코 장기 번호가 있나요? 결제는 어떻게 하나요?

현재 체코에는 셀프 서비스 장기 번호가 없습니다. 전용 번호(Dedicated Numbers)는 미국·캐나다 전용 상품으로 월 $1.95부터 시작하며, 수신·발신 SMS와 브라우저 통화를 지원합니다. 자세한 내용은 가상 번호를 참고하세요. 팀에서 지속적으로 쓸 +420 회선이 필요하다면 [email protected]으로 문의하세요. 제공 가능 여부는 현지 규정에 따라 다르며 보장되지 않습니다.

결제는 월 이용료도 요금제 선택도 없는 선불 USD 지갑 하나로 이루어집니다. 카드 또는 USDT/USDC로 충전하며, 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 연동 작업 중에는 요청 시 개발 계정을 샌드박스로 전환할 수 있어, 지갑 잔액을 쓰지 않고 시뮬레이션된 번호와 코드로 전체 흐름을 테스트할 수 있습니다. 계정 자체에는 TOTP 2단계 로그인도 사용할 수 있습니다.

자주 묻는 질문

체코 SIM 없이 앱의 체코 가입 흐름을 테스트할 수 있나요?

네. 테스트하려는 서비스에 맞춰 OTP Gateway에서 +420 번호를 주문해 앱에 입력하고, 대시보드, API 또는 웹훅으로 코드를 확인하세요.

OTP Route API에서 체코의 국가 id는 무엇인가요?

POST /api/v1/activations의 country 필드와 가격 조회에 cz를 사용하세요.

체코 인증 코드는 얼마인가요?

코드당 $0.20부터 시작하며, 서비스별 정확한 가격은 GET /api/v1/prices가 반환하고 주문 전에 표시됩니다. 코드가 도착한 경우에만 결제됩니다.

체코 번호에는 앞의 0이 필요한가요?

아니요. 체코 번호에는 트렁크 접두사가 없으므로 +420 뒤에 국내 9자리 숫자를 붙여 저장하세요.

+420 activation은 얼마 동안 열려 있나요?

20분입니다. 그 시간 안에 아무것도 도착하지 않으면 activation이 만료되고 지갑에 전액 환불됩니다.

체코 OTP 라우팅을 대량 계정 생성에 쓸 수 있나요?

아니요. OTP Route는 자사 제품을 테스트하고 정당한 자사 계정을 운영하기 위한 서비스입니다. 모든 +420 activation은 자사 제품이나 계정과 연결하고, 각 서비스의 약관과 OTP Route 이용 정책을 지키세요.

나중에 로그인할 때를 위해 같은 체코 번호를 유지할 수 있나요?

셀프 서비스 상품으로는 불가능합니다. 장기 전용 번호는 미국과 캐나다에만 있으며, 다른 시장은 지원팀에 이메일로 문의할 수 있습니다.

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