튀니지(+216) SMS 인증: 개발자를 위한 체크리스트

+216 번호를 주문하기 전 사전 점검 체크리스트에는 무엇이 있어야 하나요?

이 목록을 한 번만 훑어 보면 대부분의 튀니지 테스트 실행이 순조롭게 진행됩니다.

• API 키 준비. 개발자 콘솔에서 Bearer 키를 만드세요. 라이브 키는 or_live_로 시작합니다.
• 지갑 충전. OTP Gateway는 선불 USD 잔액에서 차감되며, 스크립트에서 GET /api/v1/balance로 확인할 수 있습니다.
• 웹훅 접근 가능. HTTPS 엔드포인트를 등록하고 시크릿을 저장하며, 타임스탬프 검사를 통과하도록 서버 시계가 정확한지 확인하세요.
• 가격 확인. 테스트하려는 서비스에 대해 GET /api/v1/prices?country=tn&service=<id>를 호출하세요.
• 전화번호 필드 테스트. 자체 양식이 8자리 튀니지 국내 번호와 붙여 넣은 +216 국제 번호를 모두 받는지 확인하세요.
• 관대한 파서. 아랍어, 프랑스어, 영어 메시지 본문에서 코드 추출이 동작하는지 확인하세요(아래 참고).
• 약관 검토. 서비스의 규칙과 OTP Route의 이용 정책(Acceptable Use Policy)에 따라 본인의 제품을 테스트하거나 본인의 정당한 계정을 운영하는 것이어야 합니다.

튀니지 번호는 E.164로 어떻게 표기하나요?

튀니지는 폐쇄형 번호 체계를 쓰며 모든 가입자 번호가 8자리이고 국내 접두번호가 없으므로, 국가번호를 붙이기 전에 제거할 것이 없습니다. E.164 형식은 +216 뒤에 8자리 숫자가 오는 것이 전부입니다. 현지 사람들은 번호를 xx xxx xxx처럼 묶어 쓰는 경우가 많으므로, 정규화할 때 공백, 점, 하이픈을 제거하세요. 앞자리 숫자의 고정 목록으로 검증하지 마세요. 직접 만든 범위 표보다 길이 검사와 신뢰할 수 있는 전화번호 라이브러리가 더 안전합니다.

튀니지 인증 문자는 어떤 언어로 오나요?

아랍어가 공용어이고 일상에서는 튀니지 아랍어를 쓰며, 프랑스어는 비즈니스, 행정, 많은 앱에서 흔합니다. 그래서 한 번의 테스트에서도 발신자와 기기 로케일에 따라 프랑스어, 영어, 아랍어로 코드를 받을 수 있습니다.

아랍어 메시지는 유니코드 SMS로 전송되며 숫자 주변에 오른쪽에서 왼쪽으로의 방향 표시가 들어 있을 수 있습니다. 보이지 않는 표시를 제거한 뒤 4~8자리 ASCII 숫자의 첫 연속 구간을 잡는 정규식이라면 세 언어 모두에서 동작합니다. 팀은 보통 모로코, 알제리와 함께 프랑스어권 북아프리카 출시를 위해, 오른쪽에서 왼쪽으로 쓰는 레이아웃의 현지화 QA를 위해, 또는 유럽에 사는 튀니지 고객을 대상으로 하기 때문에 튀니지를 테스트 매트릭스에 추가하며, 테스트용 +216 번호는 이 모든 경우를 포괄합니다.

단계별 안내: API로 튀니지 OTP 받기

실시간 스냅샷에는 튀니지용으로 1,700개가 넘는 서비스가 등록되어 있으며, Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail & YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Uber 등이 포함됩니다. 가용 여부는 하루 중에도 바뀌므로, 실행이 시작될 때 OTP 라우팅 로직이 GET /api/v1/services와 GET /api/v1/countries에서 읽도록 하세요.

1. POST /api/v1/activations에 {"service": "facebook", "country": "tn"}를 보내고 활성화 id를 저장합니다.
2. 반환된 번호를 테스트 중인 앱에 입력하고 코드를 요청합니다.
3. 웹훅에서 activation.sms_received를 처리합니다. X-OTPRoute-Signature(타임스탬프, 점, 원본 본문의 HMAC-SHA256)를 검증하고, 오래된 타임스탬프는 거부하며, 이미 처리한 활성화 id의 중복은 무시합니다.
4. 웹훅이 없다면 분당 300건 제한을 충분히 밑돌게 유지하면서 GET /api/v1/activations/{id}를 폴링합니다.
5. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel을 호출합니다.

모든 필드는 API 문서에 나와 있고, 파이프라인에 연결하는 방법은 CI 테스트 가이드에서 볼 수 있습니다.

단계별 안내: 대시보드에서

1. 이메일과 6자리 코드 또는 Google 로그인으로 계정을 만들고 TOTP 2단계 인증을 켜세요.
2. 카드 또는 USDT/USDC로 잔액을 충전하세요.
3. 튀니지를 선택한 다음 서비스를 고르고 표시된 가격을 확인하세요.
4. 주문하고 +216 번호를 복사한 뒤, 대상 앱에서 코드를 요청하세요.
5. 튀니지 코드가 나타나면 바로 대시보드에서 복사해 테스트 중인 가입을 마치세요.

문제 해결: +216 코드가 끝내 오지 않으면?

각 활성화는 20분 동안 유지되며 코드가 도착한 경우에만 비용을 냅니다. 제한 시간이 지나거나 취소하면 전액이 지갑으로 돌아갑니다.

• 아무것도 도착하지 않음: 제한 시간이 끝날 때까지 기다린 다음, 테스트가 허용한다면 나중에 또는 다른 서비스 경로로 다시 시도하세요.
• 서비스가 번호를 거부함: 일부 서비스는 가상 번호를 거부하며, 이 경우는 환불로 처리됩니다.
• 웹훅은 조용한데 대시보드에는 코드가 보임: 서명 검증이 실패하고 있을 가능성이 큽니다. 다시 직렬화한 JSON이 아니라 원본 본문과 비교하고 시계 오차를 확인하세요.
• 연속으로 여러 번 실패: 백오프를 추가하세요. 짧은 간격으로 재주문하는 것은 거의 도움이 되지 않습니다.

튀니지의 장기 회선, 결제, 샌드박스

튀니지의 셀프서비스 장기 번호는 없습니다. Dedicated Number는 미국과 캐나다 제품으로 월 $1.95부터입니다. 지속적으로 사용할 +216 회선이 필요하면 [email protected]으로 이메일을 보내 주세요. 제공 여부는 현지 규정에 따라 달라집니다.

지갑은 월 이용료 없이 쓴 만큼 결제하며, 충전마다 PDF 인보이스가 이메일로 발송됩니다. 개발 계정은 샌드박스 모드를 요청할 수 있으며, 시뮬레이션된 번호와 코드로 잔액을 쓰지 않고 연동을 검증할 수 있습니다.

자주 묻는 질문

튀니지 SIM 없이 튀니지 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway의 +216 번호를 사용하고, 대시보드 또는 SMS 인증 API와 웹훅으로 코드를 수집하세요.

튀니지 번호에는 제거해야 할 국내 접두번호가 있나요?

아니요. 튀니지 번호는 국내 접두번호 없이 8자리이므로 E.164 형식은 +216에 그 숫자를 붙이면 됩니다.

튀니지 OTP API의 국가 id는 무엇인가요?

가격 쿼리와 POST /api/v1/activations 요청 본문에서 tn을 사용하세요.

튀니지 인증 번호는 얼마인가요?

코드당 $0.20부터이며, 정확한 금액은 서비스에 따라 다르고 주문 전에 대시보드와 가격 엔드포인트에 표시됩니다. 가격을 참고하세요.

파서가 아랍어 OTP 메시지에서 실패합니다. 무엇을 바꿔야 하나요?

유니코드 방향 표시를 제거하고 주변 단어 대신 숫자 시퀀스를 매칭하세요. 그러면 같은 규칙이 아랍어, 프랑스어, 영어 본문 모두에서 동작합니다.

나중에 로그인하려고 +216 번호를 보유할 수 있나요?

셀프서비스로는 불가능합니다. Gateway 번호는 코드 한 건만 처리하며, 즉시 이용 가능한 장기 회선은 미국과 캐나다에만 있습니다.

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