OTP 라우팅 API로 중국(+86) 가입 절차 검증하기

중국 시장에는 왜 별도의 인증 테스트 계획이 필요할까요?

중국은 세계 최대 규모의 모바일 생태계 중 하나이며, 그 상당 부분이 서구 팀이 먼저 테스트하는 글로벌 앱이 아닌 자국 플랫폼 안에서 돌아갑니다. 현지 SIM 카드는 실명제 규정에 따라 등록되기 때문에, 현지 서비스는 전화번호를 강한 신원 신호로 취급하며 어떤 번호를 받아줄지에 대해서도 대체로 더 엄격합니다.

QA 엔지니어가 중국 경로를 생각할 때 고려할 점은 다음과 같습니다.

• 국경 간 커머스. Alibaba와 AliExpress의 판매자와 구매자는 가입하거나 계정 정보를 바꿀 때 전화번호를 확인하므로, 마켓플레이스 팀은 해당 메시지가 처음부터 끝까지 어떻게 흘러가는지 직접 보고 싶어 합니다.
• 중국어 문구. 중국 내 발신처의 코드는 보통 간체 중국어로 도착하며, 발신자 이름이 【】 괄호 안에 맨 앞에 오는 경우가 많습니다. 영어 단어 "code"를 찾는 파서는 이런 메시지를 놓칩니다.
• 인코딩. 중국어 텍스트는 유니코드 SMS로 전송되므로, 메시지 본문은 UTF-8로 저장하고 주변 문자와 무관하게 숫자만 뽑는 패턴으로 추출하세요.

실제 경로에 +86 번호로 테스트하면 고객이 겪기 전에 이 세 가지 문제를 모두 발견할 수 있으며, 실제 중국 통신사 경로로 이어지는 OTP 라우팅이 힘을 발휘하는 지점도 바로 여기입니다.

+86 휴대폰 번호는 어떻게 저장해야 하나요?

중국 본토 휴대폰 번호는 11자리이며 1로 시작합니다. 국내에서 트렁크 0과 지역번호를 붙여 거는 일반 전화와 달리 휴대폰에는 트렁크 접두사가 전혀 없으므로, E.164 형식은 +86 뒤에 11자리를 그대로 붙이면 됩니다.

나중에 디버깅 시간을 줄여 주는 정규화 습관은 다음과 같습니다.

• 공백과 하이픈을 제거하세요. 사용자는 번호를 3-4-4 묶음으로 입력하는 경우가 많습니다.
• 저장하기 전에 맨 앞의 0086 또는 86을 +86으로 바꾸고, 휴대폰 번호 앞에 0을 붙이지 마세요.
• 정규화한 뒤 길이를 검증하세요. 휴대폰은 국내 번호 11자리여야 하며 그 이상은 안 됩니다.

E.164 형식의 표준 컬럼을 하나만 두고, 표시할 때만 가장자리에서 형식을 입히세요. 활성화에서 반환되는 번호는 이미 이 표준 형태를 따르므로, 자체 정규화 로직의 단위 테스트용 픽스처로 쓰기에 편리합니다.

현재 중국 경로로 코드를 보내는 앱에는 어떤 것이 있나요?

중국 경로는 현재 1,300개가 넘는 서비스를 지원합니다. 실시간 스냅샷 기준으로 인기 있는 서비스는 WeChat, Alibaba, AliExpress, Microsoft & Outlook, LinkedIn, Telegram, WhatsApp, Google (Gmail & YouTube), TikTok, Amazon, Discord, ChatGPT (OpenAI), Claude 등입니다.

사용 가능 여부는 통신사 파트너가 용량을 추가하고 줄이면서 하루 중에도 달라지므로, 이 목록은 출발점으로만 보세요. 테스트 매트릭스에 서비스 ID를 하드코딩하지 말고 GET /api/v1/services와 GET /api/v1/countries를 호출해 현재 상태를 확인하세요.

국가 ID cn의 API 흐름은 어떻게 되나요?

Developer 콘솔에서 Bearer 키(접두사 or_live_)를 만들고 클라이언트가 https://otproute.com/api/v1을 가리키게 하세요. 일반적인 중국 OTP API 실행은 아래와 같고, 같은 단계로 지원되는 어떤 서비스든 중국 SMS OTP 메시지를 수신할 수 있습니다.

1. GET /api/v1/prices?country=cn&service=wechat로 테스트하려는 조합의 실시간 가격을 조회합니다.
2. 본문 {"service": "wechat", "country": "cn"}과 함께 POST /api/v1/activations를 보내고, 반환된 activation id를 보관합니다.
3. 테스트 대상 제품의 가입 양식에 +86 번호를 입력합니다.
4. 웹훅으로 activation.sms_received를 받거나, 웹훅이 없다면 몇 초 간격으로 GET /api/v1/activations/{id}를 확인합니다.
5. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel을 호출해 예약된 금액을 바로 해제합니다.

웹훅 요청에는 t=<unix>,v1=<hex> 형식의 X-OTPRoute-Signature가 담겨 있습니다. 엔드포인트 시크릿으로 <t>.<raw body>에 대한 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하며, 오래된 타임스탬프는 버리세요. 계정당 최대 키 10개, 웹훅 엔드포인트 5개, 분당 요청 300건을 쓸 수 있으며, 전체 레퍼런스는 API 문서에 있습니다.

코딩 없이도 중국 번호를 주문할 수 있나요?

네. 프로덕트 매니저와 지원 담당자도 대시보드에서 모든 과정을 처리할 수 있습니다.

1. OTP Gateway를 열고 중국을 선택한 뒤 서비스를 고릅니다.
2. 주문 전에 표시되는 가격을 확인합니다.
3. 인증할 앱에 +86 번호를 복사해 넣습니다.
4. 활성화 카드를 지켜보세요. 메시지가 도착하는 즉시 문자 내용이 표시됩니다.

같은 20분 유효 시간과 환불 규칙이 적용되므로, 현지화된 온보딩 화면을 수동으로 점검할 때 앱이 아무 문자도 보내지 않더라도 비용이 들지 않습니다.

중국 인증번호가 오지 않으면 어떻게 해야 하나요?

아무 반응이 없는 경우는 대개 연동이 잘못된 것이 아니라 서비스가 해당 번호로의 발송을 거절했거나 경로가 혼잡한 것입니다. 차분히 순서대로 점검해 보세요.

• 유효 시간을 끝까지 두세요. 일부 발신처는 자체 일정에 따라 재시도합니다.
• 해당 서비스가 가상 번호를 받아주는지 확인하세요. 실명제가 적용되는 플랫폼은 받지 않는 경우가 많고, 자동 환불은 바로 그런 경우를 위해 있습니다.
• 잠시 후에 다시 시도하거나, 같은 시나리오를 다른 서비스 경로로 시험해 보세요.
• 짧은 간격으로 계속 재주문하지 마세요. 요청 제한만 소진되고 결과는 거의 바뀌지 않습니다.

재시도 설계에 대해서는 OTP 전송 실패 줄이기 가이드에서 더 자세히 다룹니다.

+86 번호를 장기간 보유할 수 있나요? 요금은 어떻게 청구되나요?

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

비용은 선불 USD 지갑 하나로 관리되며, 월 청구나 선택해야 할 요금제는 없습니다. 중국 테스트는 이 잔액에서 차감되고, 카드 또는 USDT/USDC로 충전하며, 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 자세한 내용은 요금 페이지에 있고, 미국·캐나다 회선은 가상 번호 소개에서 설명합니다. 연동 작업에는 샌드박스 모드를 요청하세요. 시뮬레이션 번호와 코드를 반환하므로 지갑 잔액을 쓰지 않고도 파이프라인을 실행해 볼 수 있습니다.

자주 묻는 질문

중국 SIM 없이 WeChat이나 Alibaba 가입 절차를 테스트할 수 있나요?

OTP Route에서 해당 서비스용 +86 번호를 주문하고 대시보드나 API로 코드를 확인할 수 있습니다. 일부 플랫폼은 가상 번호를 거부하는데, 이 경우 활성화는 자동으로 환불됩니다.

OTP Route API에서 중국의 국가 ID는 무엇인가요?

국가 ID가 필요한 곳에는 어디든 cn을 사용하세요. 예를 들어 GET /api/v1/prices?country=cn&service=<id>처럼 씁니다.

중국 인증 문자는 영어로 오나요?

중국 내 발신처는 보통 간체 중국어로 보내고, 글로벌 앱은 영어나 계정에 맞는 언어로 보내는 경우가 많습니다. 코드 추출은 키워드가 아니라 숫자를 기준으로 구현하세요.

+86 활성화는 얼마 동안 유지되나요?

20분입니다. 그 전에 SMS가 오지 않거나 먼저 취소하면 결제 금액 전액이 지갑으로 돌아옵니다.

중국 인증 번호로 반복 로그인을 할 수 있나요?

아니요. 활성화 한 건은 코드 하나를 받고 끝나므로, 다음 달에 다시 인증해야 하는 계정이 아니라 가입과 온보딩 테스트에 적합합니다.

+86 번호를 사용할 때 지켜야 할 규칙이 있나요?

각 플랫폼의 약관과 OTP Route 이용 정책(Acceptable Use Policy)을 따르세요. 이 제품은 자사의 인증 절차를 테스트하고 합법적인 비즈니스 계정을 운영하기 위한 것이며, 대량 가입용이 아닙니다.

CI 작업에서 중국 번호를 무료로 쓸 수 있나요?

요청하면 개발 계정을 샌드박스 모드로 전환할 수 있으며, 시뮬레이션 번호와 코드가 반환되어 SMS 인증 API 테스트를 무료로 처음부터 끝까지 실행할 수 있습니다.

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