테스트, 출시, 운영을 위한 캐나다 인증 코드

지금 캐나다 경로로 팀이 할 수 있는 일은 무엇인가요?

캐나다는 두 가지 상품이 지원합니다. OTP Gateway는 인증 코드 한 건을 위한 임시 +1 번호를 제공하며, 가입 테스트, 회귀 테스트, 일회성 계정 설정에 적합합니다. 전용 번호(Dedicated Numbers)는 갱신하는 동안 계속 보유하는 캐나다 회선으로, 수신 SMS, 발신 SMS, 브라우저 통화를 지원합니다.

QA 작업은 대부분 게이트웨이로 시작하고, 오래 쓰는 스테이징 로그인이나 지원 회선은 대개 전용 회선으로 옮겨 갑니다. 장단점은 임시 번호와 전용 번호 가이드에서 살펴볼 수 있습니다.

왜 하필 캐나다일까요? 미국에서 국경을 넘어오는 제품은 캐나다 출시에 별도의 점검이 필요하다는 사실을 종종 발견합니다. 프랑스어 화면, 주별 가격, 사용자가 등록한 번호에 지역별 위험 규칙을 적용하는 서비스 등이 그렇습니다. 실제 캐나다 인증 번호가 있으면 토론토나 몬트리올의 고객이 보기 전에 QA가 전화번호 입력란부터 환영 화면까지 전체 경로를 확인할 수 있습니다.

캐나다 게이트웨이 번호로 코드를 보내는 앱은 무엇인가요?

캐나다의 라이브 목록은 현재 3,600개 넘는 서비스에 걸쳐 있습니다. 인기 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Uber, Amazon, LinkedIn, Microsoft & Outlook, Discord, Signal, Airbnb, eBay, ChatGPT (OpenAI)가 있습니다.

이용 가능 여부는 하루 중에도 바뀌므로 어떤 목록이든 스냅샷으로 보시고, 특정 서비스를 중심으로 테스트 매트릭스를 만들기 전에 API에 현재 옵션을 물어보세요.

캐나다 OTP API는 처음부터 끝까지 어떻게 동작하나요?

요청은 https://otproute.com/api/v1로 보내며 개발자 콘솔에서 만든 or_live_로 시작하는 Bearer 키를 포함합니다. 일반적인 캐나다 테스트는 호출 다섯 번으로 이루어집니다.

1. GET /api/v1/services와 GET /api/v1/countries로 ID를 확인합니다. 캐나다는 ca입니다.
2. GET /api/v1/prices?country=ca&service=<id>로 실시간 가격을 읽습니다.
3. {"service": "<id>", "country": "ca"}로 POST /api/v1/activations를 호출합니다.
4. 엔드포인트에서 캐나다의 activation.sms_received 이벤트를 수신합니다. 공개 URL이 없는 스크립트는 대신 GET /api/v1/activations/{id}를 폴링할 수 있습니다.
5. 테스트가 일찍 중단되면 POST /api/v1/activations/{id}/cancel을 호출합니다.

엔드포인트로 오는 모든 요청에는 X-OTPRoute-Signature가 포함됩니다. HMAC-SHA256을 검증하고 오래된 타임스탬프는 버리세요. 더 자세한 내용은 OTP API 연동 가이드에 있습니다.

개발자가 아닌 동료도 +1 코드를 직접 주문할 수 있나요?

네. 로그인하고 OTP Gateway를 열어 캐나다와 서비스를 고른 뒤 표시된 가격을 확인하고 주문하세요. +1 번호가 바로 나타나며, 인증하려는 앱에 입력하면 같은 화면에 코드가 도착합니다. 지원 담당자와 그로스 마케터는 파이프라인이 아니라 계정 하나를 설정하면 될 때 이 방법을 씁니다. 앱이 발송이 느리더라도 취소하고 다시 주문하지 말고, 창이 닫힐 때까지 주문을 열어 두세요. 나중에 다시 시도하거나 다른 서비스 경로를 쓰는 편이 대개 더 많은 것을 알려 줍니다.

+1 캐나다 번호는 어떻게 저장해야 하나요?

캐나다는 미국과 북미 번호 체계(NANP)를 공유하므로, 모든 번호는 3자리 지역 번호와 7자리 국내 번호로 이루어집니다. 국내에서는 장거리 통화 앞에 1을 누르는 경우가 많은데, 이 숫자는 국가 코드와 같기 때문에 E.164에서는 +1 뒤에 10자리를 붙인 형태가 됩니다.

실무 팁 두 가지입니다.

• E.164 형식을 저장하고, 현지 표시 형식은 UI에서만 적용하세요.
• +1만 보고 국가를 추정하지 마세요. 제품이 캐나다와 미국 사용자를 다르게 취급한다면 지역 번호나 사용자가 선택한 국가를 사용하세요.

캐나다는 공식적으로 이중 언어 국가여서, 많은 서비스가 계정 언어에 따라 영어나 프랑스어로 코드를 보냅니다. 퀘벡에 출시한다면 두 템플릿을 모두 테스트하세요.

캐나다 전용 번호가 더 적합한 경우는 언제인가요?

같은 로그인이 계속 작동해야 한다면 전용 번호를 고르세요. 다시 인증해야 하는 스테이징 계정, SMS 복구가 필요한 팀 공용 로그인, 캐나다 지원 회선이 그런 경우입니다. 대시보드에서 월 $1.95부터 즉시 구매할 수 있고, 수신 메시지는 대시보드에 표시되며 number.sms_received가 웹훅으로 전송됩니다. 이용 기간은 선불이며 지갑에서 갱신되고 언제든 해지할 수 있습니다.

캐나다 코드는 어떻게 요금이 청구되나요?

월 요금이나 선택할 요금제 없이 하나의 선불 USD 지갑으로 모든 것을 처리합니다. 카드 또는 USDT/USDC로 충전하며, 충전이나 번호 구매마다 PDF 인보이스가 이메일로 발송됩니다. 게이트웨이 주문은 코드가 도착했을 때만 요금이 부과되므로, 실패한 시도는 시간 외에는 비용이 들지 않습니다. 전용 번호도 같은 잔액에서 갱신되어 QA 지출과 캐나다 지원 회선이 하나의 명세서에 담깁니다. 라이브 전에 개발 계정을 샌드박스로 전환해 달라고 요청하면 시뮬레이션된 번호와 코드가 반환됩니다. 자세한 내용은 요금 페이지에 있습니다.

자주 묻는 질문

캐나다 SIM 없이 우리 앱의 캐나다 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 국가 ca의 +1 번호를 주문해 앱에 입력하고, 대시보드나 웹훅에서 코드를 읽으면 됩니다.

캐나다 활성화는 얼마 동안 열려 있나요?

20분입니다. 그 안에 SMS가 오지 않거나 취소하면 결제 금액 전액이 자동으로 지갑에 환불됩니다.

코드가 끝내 오지 않으면 어떻게 해야 하나요?

창이 끝날 때까지 기다린 뒤 나중에 다시 시도하거나 다른 서비스 경로를 써 보세요. 가상 번호를 거부하는 서비스도 있으며, 짧은 간격으로 반복 주문해도 도움이 되는 경우는 드뭅니다.

캐나다 번호를 몇 달 동안 유지할 수 있나요?

네, 지갑에서 갱신되는 월 $1.95부터의 전용 번호(Dedicated Number)를 쓰면 됩니다. 게이트웨이 번호는 코드 한 건에만 쓰입니다.

캐나다 전용 번호는 발신 통화를 지원하나요?

앱이나 SIM 없이 브라우저에서 발신 통화를 할 수 있으며, 수신·발신 SMS도 지원합니다.

프랑스어 코드는 다르게 처리되나요?

아니요. OTP Route는 SMS를 발송된 그대로 전달하므로, 서비스가 사용하는 언어가 그대로 표시됩니다.

팀에서 API 키를 몇 개 만들 수 있나요?

계정당 키 최대 10개, 웹훅 엔드포인트 최대 5개이며 분당 요청 한도는 300건입니다.

번호 사용에는 어떤 규칙이 적용되나요?

각 서비스의 자체 약관과 OTP Route의 이용 정책(Acceptable Use Policy)이 적용됩니다. 번호는 자사의 정당한 제품과 계정을 테스트하고 운영하는 데 사용하세요.

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