사전 점검: +90 번호를 요청하기 전에 무엇을 준비해야 하나요?
튀르키예 테스트 계획을 실행하기 전에 짧은 체크리스트를 확인하면 낭비되는 활성화를 줄일 수 있습니다.
GET /api/v1/services로 앱의 서비스 id를 찾고,GET /api/v1/countries로 국가 idtr을 확인합니다.GET /api/v1/prices?country=tr&service=<id>를 호출해 해당 조합의 현재 가격과 주문 가능 여부를 확인합니다.GET /api/v1/balance로 지갑 잔액이 이번 실행을 감당하는지 확인합니다.- 웹훅 엔드포인트를 등록하고(계정당 최대 5개) 시크릿은 소스 저장소에 넣지 마세요.
- 전화번호 검증 라이브러리의 지역을 TR로 설정하고, 테스터에게 번호를 어떤 형식으로 다시 보여 줄지 정합니다.
- 테스트 환경에 튀르키예어 로케일을 적용하세요. 문자열 대소문자 버그는 여기서 가장 먼저 드러나는 경향이 있습니다.
튀르키예 전화번호 검증에서 맨 앞의 0이 문제가 되는 이유는 무엇인가요?
튀르키예 국내에서는 휴대전화 번호를 트렁크 접두사와 함께 0 5XX XXX XX XX처럼 씁니다. 국제 형식에서는 이 0이 사라지며, 표준 형태는 +90 뒤에 10자리 국내 번호가 오는 것이고 휴대전화 번호는 국가 코드 뒤에서 5로 시작합니다.
두 방식을 모두 받는 양식에는 정규화 단계가 필요합니다. 공백과 구두점을 제거하고, 지역이 TR이면 맨 앞의 0 하나를 떼어 낸 뒤, +90을 붙여 E.164(+905…)로 저장하세요. 저장 값에 트렁크 0을 남기면 같은 테스터가 데이터베이스에서 서로 다른 두 사용자처럼 보이게 됩니다. 튀르키예 사용자가 기대한다면 표시할 때만 국내 형식으로 보여 주세요.
튀르키예 인증 SMS는 파서에게 어떻게 보이나요?
공용어는 튀르키예어이며, 현지 발신자는 ç, ş, ğ, ı, ö, ü 같은 글자를 쓴 튀르키예어로 코드를 보냅니다. 국제 앱은 보통 기기나 계정의 언어를 따릅니다. 어느 쪽이든 주변 단어를 매칭하지 말고 숫자 패턴으로 코드를 추출하세요.
튀르키예어 로케일에는 잘 알려진 소프트웨어 함정도 있습니다. 소문자 i를 대문자로 바꾸면 점이 있는 İ가 되고, 대문자 I를 소문자로 바꾸면 점 없는 ı가 됩니다. 로케일에 민감한 대소문자 변환으로 문자열을 비교하는 코드는 튀르키예 사용자의 로그인이나 이메일 검사를 깨뜨릴 수 있습니다. +90 테스트는 이를 잡아내기 좋은 기회이며, 올바른 길이의 입력 마스크와 번역된 오류 메시지도 함께 점검할 수 있습니다. 관련 점검 항목은 모바일 앱 인증 가이드에서 다룹니다.
어떤 앱이 튀르키예 인증 번호로 코드를 보낼 수 있나요?
tr의 현재 스냅샷에는 WhatsApp, Telegram, Instagram, TikTok, X (Twitter), Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Netflix, AliExpress, Discord, ChatGPT (OpenAI), Amazon이 포함됩니다. 튀르키예 경로 전체로는 1,800개가 넘는 서비스에 닿습니다.
팀들은 튀르키예 제품 출시, 마케팅 시작 전 현지화 확인, 유럽 다른 지역에 사는 튀르키예어 사용 고객 지원을 위해 여기서 주문합니다. 가용 용량은 하루 동안 변하므로 테스트 설정에 고정 목록을 넣지 말고 실시간 가격 목록을 활용하세요.
API로 튀르키예 OTP를 요청하고 읽으려면 어떻게 하나요?
호출 순서는 짧습니다. 접두사가 or_live_인 Bearer 키로 {"service": "<id>", "country": "tr"}와 함께 POST /api/v1/activations를 보내세요. 반환된 +90 번호를 테스트 대상 앱에 입력합니다. SMS가 도착하면 OTP Route가 엔드포인트로 activation.sms_received를 보내고, 그 전에 시간 창이 닫히면 activation.expired가, 수동으로 중단하면 activation.cancelled가 전달됩니다.
이벤트를 신뢰하기 전에 X-OTPRoute-Signature 헤더로 서명을 다시 계산하세요. 타임스탬프, 점, 원본 요청 본문을 엔드포인트 시크릿으로 HMAC-SHA256 처리한 값입니다. 타임스탬프가 오래된 요청은 거부하고, 같은 활성화 id에 대해 반복 전송된 이벤트는 하나로 처리하세요. 인바운드 HTTP를 받을 수 없는 환경에서는 GET /api/v1/activations/{id} 폴링이 대안입니다. 웹훅 기반 OTP 수집 글과 개발자 허브에서 더 자세히 볼 수 있습니다.
코딩보다 클릭이 편하다면? 대시보드를 사용하세요
기술 직군이 아닌 팀원도 브라우저에서 같은 흐름을 따를 수 있습니다. 로그인해 자금을 충전하고, 서비스와 튀르키예를 선택한 뒤 +90 번호를 앱에 복사하세요. 수신된 SMS는 활성화 카드에 표시됩니다. 모든 임시 번호는 20분의 시간 창 동안 코드 한 개에 사용할 수 있습니다.
튀르키예 코드가 도착하지 않으면 어떻게 하나요?
- 실패로 판단하기 전에 20분을 모두 기다리세요.
- 앱이 가상 번호를 허용하는지 확인하세요. 일부는 거부하며, 자동 환불은 이런 경우를 위한 것입니다.
- 잠시 후 다시 시도하거나, 테스트에서 허용한다면 다른 서비스 경로로 시도하세요.
- 빠른 반복문으로 계속 주문하지 말고 재시도 간격을 두세요.
코드 없이 끝난 주문에는 비용이 들지 않습니다. 전액이 지갑으로 돌아가기 때문입니다.
결제, 샌드박스, 장기 번호
OTP Route는 요금제를 고를 필요 없는 선불 USD 지갑으로 운영됩니다. 카드와 USDT/USDC 충전을 모두 지원하며, 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 개발자는 개발 계정을 샌드박스로 전환해 달라고 요청할 수 있으며, 샌드박스는 자금을 쓰지 않고 종단 간 테스트를 할 수 있도록 시뮬레이션된 번호와 코드를 반환합니다.
셀프서비스로 쓸 수 있는 튀르키예 장기 번호는 없습니다. 필요한 팀은 [email protected]으로 이메일을 보낼 수 있으며, 가능 여부는 현지 규정에 따라 달라집니다. 유지하고 갱신하는 회선이 필요하다면 Dedicated Numbers가 미국과 캐나다에서 월 $1.95부터 제공됩니다.
자주 묻는 질문
튀르키예 SIM 카드 없이 우리 앱의 튀르키예 가입을 인증할 수 있나요?
네. OTP Gateway의 임시 +90 번호가 코드를 수신하며, 대시보드나 API로 확인할 수 있습니다.
튀르키예 번호를 맨 앞 0과 함께 저장해야 하나요?
아니요. +90 뒤에 10자리 국내 번호를 붙인 E.164 형식으로 저장하고, 국내 형식으로 표시할 때만 트렁크 0을 붙이세요.
튀르키예의 API 국가 id는 무엇인가요?
tr입니다. POST /api/v1/activations의 country 필드와 가격 조회에 전달하세요.
테스트용 +90 번호는 얼마인가요?
튀르키예 활성화는 코드당 $0.20부터 시작하며 앱마다 요금이 다릅니다. 주문 전에 대시보드와 GET /api/v1/prices에서 확인할 수 있습니다.
코드가 전달되지 않으면 어떻게 되나요?
20분 안에 SMS가 도착하지 않거나 활성화를 취소하면 청구된 금액 전액이 지갑으로 돌아갑니다.
나중에 로그인하려고 튀르키예 번호를 계속 보유할 수 있나요?
셀프서비스로는 불가능합니다. [email protected]으로 문의하되, 제공 여부는 현지 규정에 따라 달라진다는 점을 감안하세요.
번호 사용에 규칙이 있나요?
네. 튀르키예 번호는 본인 소유의 제품과 계정을 테스트하고 운영하는 용도이며, 각 앱의 약관과 OTP Route 허용 가능 사용 정책이 그대로 적용됩니다.
서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.