테스트와 운영을 위한 홍콩(+852) SMS OTP 수신

+852 번호는 왜 정규화하기 쉬운가요?

홍콩은 폐쇄형 번호 체계를 사용합니다. 모든 가입자 번호는 8자리이고, 지역 번호가 없으며, 제거할 트렁크 접두사도 없습니다. 따라서 현지 사용자가 입력하는 번호는 E.164에서 +852 뒤에 오는 8자리와 같습니다. 휴대폰 번호 대역은 흔히 5, 6, 9로 시작합니다.

사람들은 보통 8자리를 4자리씩 두 묶음으로 쓰므로, 가입 양식은 검증 전에 공백과 하이픈을 제거해야 합니다. 표준 문자열 +852XXXXXXXX를 저장하고 이 값으로 비교하며, 형식 변환은 표시할 때만 하세요. 길이가 고정되어 있어 간단한 길이 검사로도 대부분의 오타를 잡을 수 있지만, 번호 대역 검증을 위해서는 제대로 된 전화번호 라이브러리를 함께 사용하세요.

홍콩의 인증 문자는 어떤 언어를 사용하나요?

중국어와 영어가 모두 공용어이고, 일상 구어는 광둥어이며, 이곳의 중국어 표기는 번체자를 사용합니다. 서비스는 계정의 로캘에 따라 코드를 영어 또는 번체 중국어로 보낼 수 있고, 중국어 문자로 된 메시지는 유니코드 SMS로 전송됩니다.

QA를 위한 실용적인 시사점이 두 가지 있습니다. 첫째, 주변 단어가 아니라 숫자 패턴을 매칭해서 코드를 추출하면 두 템플릿 모두에서 파서가 동작합니다. 둘째, 자사 제품이 현지화된 메시지를 보낸다면 템플릿 편집기에서만이 아니라 수신 측에서도 번체 중국어 버전이 올바르게 표시되는지 확인하세요.

팀들은 왜 홍콩 경로에서 가입 테스트를 하나요?

홍콩은 많은 아시아태평양 기업의 지역 거점이며, 이곳 사용자는 해외 앱과 중국 본토 대상 앱의 계정을 모두 갖고 있는 경우가 많습니다. 이런 조합 덕분에 현지화, 국경 간 온보딩, 지원 흐름을 점검하기에 유용한 시장입니다.

현재 스냅샷에서 홍콩에는 3,600개 이상의 서비스가 표시됩니다. 자주 쓰이는 서비스로는 WhatsApp, WeChat, LINE, Signal, Alibaba, Telegram, Google(Gmail & YouTube), Facebook, Instagram, LinkedIn, Uber, Airbnb, Netflix, AliExpress, Amazon이 있습니다. 결제와 지갑 제품도 여기서 테스트하는데, 홍콩 온보딩 화면의 전화번호 단계가 깨지면 고객은 거래를 시작하기도 전에 멈추기 때문입니다. 실시간 이용 가능 여부는 하루 중 바뀌므로 실행 시점에 읽으세요.

국가 `hk`로 홍콩 OTP API 흐름은 어떻게 진행되나요?

or_live_로 시작하는 Bearer 키로 https://otproute.com/api/v1에 인증하세요. 한 계정은 키를 최대 10개, 웹훅 엔드포인트를 최대 5개까지 가질 수 있습니다.

1. 이름을 ID로 매핑하기 위해 실행마다 한 번씩 GET /api/v1/services와 GET /api/v1/countries를 읽습니다.
2. 실시간 가격을 위해 GET /api/v1/prices?country=hk&service=<id>를 조회합니다.
3. POST /api/v1/activations에 {"service": "wechat", "country": "hk"}를 보냅니다.
4. 테스트 중인 흐름에 +852 번호를 입력합니다.
5. activation.sms_received 이벤트에서 코드를 받거나, 대신 몇 초마다 GET /api/v1/activations/{id}를 폴링합니다.
6. activation.expired 또는 activation.cancelled가 오면 테스트를 코드 없음으로 표시하고 넘어갑니다.

X-OTPRoute-Signature 헤더(<t>.<raw body>에 대한 HMAC-SHA256)를 검증하고 오래된 타임스탬프는 거부하세요. 연동 가이드가 각 호출을 차례로 설명합니다.

비개발자는 어떻게 홍콩 인증 번호를 받나요?

대시보드에서 OTP Gateway를 열고 홍콩과 서비스를 선택한 뒤, 표시된 가격을 확인하고 주문하세요. 번호를 앱에 복사한 다음 활성화 카드를 지켜보면, 코드가 수신되는 즉시 거기에 나타납니다. 지원 담당자가 CI가 사용하는 것과 같은 경로에서 고객 신고를 재현할 때 유용합니다.

+852 코드가 나타나지 않으면 어떻게 하나요?

활성화에 20분을 모두 주세요. SMS가 도착하지 않거나 일찍 취소하면 요금은 자동으로 지갑으로 돌아가며, 코드가 도착했을 때만 비용을 내기 때문입니다. 그다음에는 다음을 확인하세요.

• 일부 서비스처럼 가상 번호를 거부하는지 확인합니다.
• 나중에 다시 시도하거나 다른 서비스 경로를 이용합니다.
• +852 뒤의 8자리가 앱에 모두 전달되었는지 확인합니다. 불필요한 앞자리 0을 끼워 넣는 양식은 번호를 깨뜨립니다.
• 빠른 재주문 반복은 피하세요. 같은 결과가 되풀이되기 쉽습니다.

홍콩 장기 회선이 있나요? 청구는 어떻게 이루어지나요?

OTP Route에는 셀프서비스 장기 +852 번호가 없습니다. 전용 번호는 미국과 캐나다에서만 월 $1.95부터 제공되며 가상 번호 페이지에 설명되어 있습니다. 홍콩 회선이 필요하면 [email protected]으로 이메일을 보내세요. 제공 가능 여부는 현지 규정에 따라 달라집니다.

그 밖의 모든 것은 선불 USD 지갑에서 사용한 만큼만 내는 방식이며, 카드 또는 USDT/USDC로 충전하고 충전마다 PDF 인보이스가 발급됩니다. 개발 계정에는 요청 시 모의 번호를 제공하는 샌드박스 모드를 사용할 수 있습니다. 각 서비스의 약관과 이용 정책을 따라 주세요.

자주 묻는 질문

현지 SIM 카드 없이 홍콩 SMS OTP를 받을 수 있나요?

네. OTP Route는 선택한 서비스용 일회용 +852 번호를 발급하며, 코드는 대시보드와 웹훅으로 전달됩니다.

홍콩 번호에서 트렁크 접두사를 제거해야 하나요?

아니요. 홍콩에는 트렁크 접두사가 없으므로 현지 8자리를 +852 바로 뒤에 붙이면 됩니다.

홍콩의 API 국가 ID는 무엇인가요?

가격 조회 쿼리와 활성화 본문에서 hk를 사용하세요.

코드가 중국어로 오나요, 영어로 오나요?

서비스와 계정의 언어 설정에 따라 둘 다 가능합니다. 두 템플릿 모두에서 동작하도록 숫자를 패턴으로 파싱하세요.

테스트용 +852 번호는 얼마인가요?

코드당 $0.20부터이며, 서비스별 실시간 가격은 GET /api/v1/prices에서 가져오고 주문 전에 대시보드에도 표시됩니다.

WeChat이나 다른 서비스가 아무것도 보내지 않으면 환불받을 수 있나요?

네. 20분 안에 SMS를 받지 못했거나 직접 취소한 활성화는 지갑으로 전액 환불됩니다.

홍콩으로의 OTP 라우팅은 CI 파이프라인에 적합한가요?

웹훅이나 적당한 폴링을 사용하고 만료를 정상 결과로 처리한다면 적합합니다. CI 파이프라인 문서를 참고하세요.

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