폴란드(+48) 인증 코드: 체크리스트, API 단계, 문제 해결

사전 점검: 폴란드 가입을 테스트하기 전에 무엇이 필요한가요?

이 목록을 한 번 훑어 두면 첫 폴란드 주문은 별 탈 없이 지나가는 편입니다.

1. 자격 증명. 개발자 콘솔에서 Bearer 키를 생성하세요(or_live_로 시작). 스테이징, CI, 프로덕션용 키를 따로 쓰면 교체가 수월합니다.
2. 식별자. 폴란드는 pl입니다. 서비스 ID는 표시 이름을 하드코딩하지 말고 GET /api/v1/services에서 가져오세요.
3. 자금. 지갑을 충전하세요. 가격은 주문 전에 확인할 수 있습니다.
4. 전달 대상. HTTPS 웹훅을 등록하고 시크릿은 소스 코드 저장소에 두지 마세요. 인바운드 트래픽이 막혀 있다면 폴링도 가능합니다.
5. 요청 한도. API는 계정당 분당 300건을 허용하므로 병렬 스위트는 그에 맞게 조절하세요.
6. 범위. 자사 제품, 자사 회사 또는 고객사에 속한 계정만 인증하고, 각 서비스의 약관과 우리의 허용 사용 정책(Acceptable Use Policy)을 따르세요.

파이프라인에 관해서는 CI 파이프라인에서의 SMS OTP 테스트를 참고하세요.

현재 어떤 서비스가 +48 번호로 코드를 보내나요?

OTP 라우팅 측면에서 폴란드는 카탈로그에서 폭넓은 항목 중 하나로, 2,300개가 넘는 서비스를 다룹니다. 현재 스냅샷의 인기 서비스로는 Facebook, Instagram, TikTok, WhatsApp, Telegram, Viber, Signal, Snapchat, Discord, X (Twitter), LinkedIn, Google (Gmail & YouTube), Amazon, AliExpress, Uber, Netflix가 있습니다.

이 목록은 약속이 아니라 출발점으로 보세요. 어떤 경로든 가용성은 하루 동안 바뀌므로, 주문하기 전마다 가격 엔드포인트에 해당 조합을 물어보세요.

폴란드 OTP API의 정확한 단계는 무엇인가요?

https://otproute.com/api/v1의 SMS 인증 API를 사용하는 자동화 테스트는 다음과 같이 동작합니다.

1. GET /api/v1/prices?country=pl&service=<id>로 폴란드에서 해당 서비스의 실시간 가격을 확인합니다.
2. POST /api/v1/activations에 {"service": "<id>", "country": "pl"}를 보내면 +48 번호와 활성화 ID가 반환됩니다.
3. 테스트가 가입 양식에 번호를 입력하고 SMS를 요청합니다.
4. 핸들러가 activation.sms_received를 받습니다. activation.expired나 activation.cancelled가 오면 해당 실행을 미전달로 표시합니다.
5. 웹훅이 없으면 코드가 나타나거나 유효 시간이 끝날 때까지 몇 초마다 GET /api/v1/activations/{id}를 읽습니다.
6. 테스트가 일찍 정리될 때는 POST /api/v1/activations/{id}/cancel을 호출합니다.

페이로드를 신뢰하기 전에 X-OTPRoute-Signature 헤더를 검증하세요. 헤더에는 t=<unix>,v1=<hex>가 들어 있고, v1은 엔드포인트 시크릿으로 서명한 <t>.<raw body>의 HMAC-SHA256입니다. 타임스탬프가 오래된 요청은 거부하고 핸들러는 활성화 ID에 대해 멱등성을 갖게 만드세요. 웹훅 보안 가이드에 검증 과정이 자세히 나와 있습니다.

API 없이 운영팀이 폴란드 번호를 주문할 수 있나요?

네. OTP Route 대시보드에서 OTP Gateway를 열고 폴란드를 선택한 뒤 서비스를 검색해 표시된 가격을 확정하세요. 주문 후 폴란드 인증 번호를 앱의 인증 화면에 복사하고 활성화 카드를 지켜보면, SMS를 받는 즉시 문자 내용이 거기에 나타납니다. 설치할 것은 없으며, 같은 지갑으로 브라우저와 API를 모두 결제합니다.

폴란드 번호와 메시지는 무엇이 달라 다루기 까다로운가요?

폴란드는 국내 접두 번호가 없는 폐쇄형 번호 체계를 사용합니다. 휴대전화든 유선이든 모든 번호는 +48 뒤에 9자리입니다. 덕분에 검증이 반가울 만큼 엄격해집니다. 국내 번호 9자리로 줄어들지 않는 입력은 거부하고, 사용자가 세 자리씩 묶어 넣은 공백과 대시를 제거하며, +48과 9자리를 하나의 E.164 문자열로 저장하세요. 앞에 붙은 0은 보존해야 할 접두 번호가 아니라 오타입니다.

계정 언어가 폴란드어이면 인증 메시지가 폴란드어로 도착하는 경우가 많습니다. ą, ę, ł, ż 같은 문자는 GSM 7비트 알파벳에 속하지 않으므로, 폴란드어 OTP 문자를 직접 보낸다면 세그먼트가 짧아질 것을 예상하고 템플릿이 실제 휴대폰에서 표시되는 대로 테스트하세요. 수신한 코드를 파싱할 때는 숫자를 기준으로 삼고 주변 단어는 무시하세요.

여기서 테스트하는 흔한 이유는 폴란드 시장에 진출하는 제품, 폴란드어 흐름의 현지화 QA, 중부 유럽 전역의 비즈니스 계정을 관리하는 지역 팀, 그리고 다른 EU 국가에 사는 폴란드어 사용자가 고객인 앱입니다.

문제 해결: +48 코드가 오지 않는 이유는 무엇인가요?

• 유효 시간이 아직 남아 있습니다. 결론을 내리기 전에 20분 전체를 기다리세요. 코드가 도착한 경우에만 비용이 청구됩니다.
• 서비스가 가상 번호를 거부할 수 있습니다. 일부 플랫폼은 그렇게 하며, 이때는 자동 환불로 전액이 지갑에 돌아옵니다.
• 경로가 혼잡합니다. 나중에 다시 시도하거나 다른 서비스 경로를 테스트하세요.
• 테스트가 반복 실행 중입니다. 몇 초마다 다시 주문하면 요청 한도가 소진되므로 백오프를 추가하세요.

더 많은 패턴은 OTP 전달 실패 줄이기에 모아 두었습니다.

폴란드에도 전용 번호가 있나요? 결제는 어떻게 하나요?

셀프 서비스 상품으로는 없습니다. 전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다에서만 월 $1.95부터 제공됩니다(From $1.95/month). 폴란드 장기 회선을 원하면 [email protected]으로 이메일을 보내 문의하세요. 가능 여부는 현지 규정이 결정하므로 제공을 약속하지는 않습니다.

결제는 하나의 선불 USD 지갑으로 이루어집니다. 요금제도 월 사용료도 없고, 카드 또는 USDT/USDC로 충전하며, 충전마다 PDF 청구서가 이메일로 발송됩니다. 개발자는 개발 계정의 샌드박스 모드를 요청해, 연동을 구축하는 동안 시뮬레이션된 번호와 코드를 받을 수 있습니다. 실시간 요금은 요금을 참고하세요.

자주 묻는 질문

팀에 +48 SIM이 없다면 폴란드 가입 흐름을 어떻게 테스트하나요?

OTP Gateway에서 테스트용 +48 번호를 주문해 흐름에서 사용하세요. 코드는 대시보드에 나타나고 웹훅으로 보낼 수 있습니다.

OTP Route API 호출에서 폴란드의 국가 코드는 무엇인가요?

pl이며 POST /api/v1/activations와 가격 조회 모두에서 사용합니다.

폴란드 전화번호는 몇 자리인가요?

+48 뒤에 국내 번호 9자리이며 접두 0은 없습니다. 길이가 고정되어 있어 서버 측 검증이 간단합니다.

폴란드 SMS OTP를 받는 데 비용이 얼마인가요?

요금은 코드당 $0.20부터이며 서비스에 따라 다릅니다. 주문 전에 대시보드와 가격 엔드포인트에서 정확한 금액을 확인할 수 있습니다.

폴란드 활성화가 빈 채로 만료되면 손해를 보나요?

아니요. 코드 없이 끝난 활성화나 직접 취소한 활성화는 전액이 지갑으로 환불됩니다.

실서비스 전에 폴란드 흐름 전체를 시뮬레이션할 수 있나요?

네. 개발 계정에 샌드박스 모드를 요청하면 지갑 잔액을 쓰지 않고 시뮬레이션된 번호와 코드를 받을 수 있습니다.

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