이집트(+20) SMS 인증 흐름을 OTP Route API에 연결하기

이집트 OTP API 연동에는 실제로 어떤 요청이 필요한가요?

일곱 개의 엔드포인트면 충분하며 모두 https://otproute.com/api/v1 아래에 있고 or_live_ 접두사의 Bearer 키로 인증합니다. Developer console에서 환경마다 키를 하나씩 생성하세요. 계정당 최대 10개까지 보유할 수 있습니다.

1. GET /api/v1/services와 GET /api/v1/countries로 카탈로그를 불러옵니다. 이집트의 국가 id는 eg이며 거의 바뀌지 않으므로 캐시해도 됩니다.
2. 주문하기 전마다 GET /api/v1/prices?country=eg&service=<id>로 현재 가격과 가용 상태를 확인합니다. 재고는 하루 동안 바뀌므로 이 응답은 설정이 아니라 최신 데이터로 취급하세요.
3. {"service": "whatsapp", "country": "eg"} 같은 본문으로 POST /api/v1/activations를 호출해 activation을 만듭니다. 테스트 대상 화면에 입력할 activation id와 +20 번호를 받습니다.
4. 웹훅 또는 GET /api/v1/activations/{id} 호출로 코드를 가져옵니다.
5. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel로 주문을 해제해 자금이 바로 돌아오게 합니다.

각 테스트 묶음 시작 부분에서 GET /api/v1/balance를 간단히 호출하면 CI 작업이 중간에 실패하는 대신 일찍 멈출 수 있습니다. 요청 제한은 계정당 분당 300건이어서 여러 activation을 병렬로 폴링할 여유가 있습니다. 전체 요청 예시는 개발자 문서에 있습니다.

폴링 대신 서명된 웹훅으로 +20 코드를 받으려면 어떻게 하나요?

폴링은 로컬 테스트 하나에는 충분하지만, 파이프라인이 이집트 activation을 한꺼번에 많이 돌릴 때는 웹훅이 더 알맞습니다. Developer console에서 엔드포인트를 추가하고(계정당 5개) activation.sms_received를 구독하세요. 작업이 대기를 멈출 때를 알 수 있도록 activation.expired와 activation.cancelled도 함께 구독합니다.

모든 요청에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. <t>.<raw body> 문자열을 다시 만들고, 엔드포인트 시크릿으로 HMAC-SHA256을 계산하여 v1과 상수 시간 비교로 대조하세요. 타임스탬프가 오래된 것은 거부하고, 파싱했다가 다시 인코딩한 객체가 아니라 받은 그대로의 바이트를 해시하세요.

activation id를 멱등성 키로 쓰세요. 이벤트를 한 번만 저장하고, 반복된 것은 무시하며, 2xx를 빠르게 반환합니다. 웹훅 기반 OTP 캡처 가이드에서 큐를 사용하는 핸들러 버전을 설명합니다.

이집트 인증 번호로 코드를 보낼 수 있는 서비스에는 무엇이 있나요?

이집트의 실시간 스냅샷에는 전체 1,600개가 넘는 서비스가 올라 있습니다. 팀이 +20 번호로 자주 테스트하는 인기 서비스로는 WhatsApp, Facebook, Instagram, TikTok, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, Uber, Snapchat, Viber, imo, ChatGPT (OpenAI), Amazon, LinkedIn이 있습니다.

이 목록은 특정 시점의 모습일 뿐 약속이 아닙니다. 오전에 번호가 있던 서비스도 오후에는 부족할 수 있으며, 그래서 가격 엔드포인트가 비용과 함께 가용 상태도 알려 줍니다. 일부 서비스는 가상 번호를 아예 거부하기도 합니다. 그런 경우에는 아래에 설명한 환불 규칙이 적용됩니다.

앱은 이집트 휴대폰 번호를 어떻게 저장하고 검증해야 하나요?

이집트는 국가 코드 +20과 국내 트렁크 접두사 0을 사용합니다. 현지에서 휴대폰 번호는 01로 시작하는 11자리로 쓰고, 국제 형식에서는 0이 사라지고 +20 뒤에 10자리가 이어집니다. 몇 가지 습관으로 대부분의 버그를 피할 수 있습니다.

• E.164로만 저장하세요. 예: +201XXXXXXXXX. 표시용 형식은 렌더링 시점에 만듭니다.
• 사용자가 국가를 이집트로 설정해 둔 상태에서 01…을 입력하면 트렁크 0을 제거하세요. 그렇지 않으면 유효하지 않은 +2001… 값이 만들어집니다.
• 숫자를 정규화하세요. 아랍어 키보드를 쓰는 사용자는 아랍-인도 숫자를 입력할 수 있으므로, 검증 전과 입력한 OTP를 비교하기 전에 ASCII 숫자로 변환합니다.

공용어는 아랍어이므로 많은 서비스가 이집트 사용자에게 코드를 아랍어로 보내고, 다른 서비스는 기본적으로 영어를 씁니다. 정규식으로 코드를 추출한다면 영어뿐 아니라 오른쪽에서 왼쪽으로 쓰는 메시지 본문에도 테스트해 보세요.

운영 팀이 코드 작성 없이 이집트 번호를 주문할 수 있나요?

네. 모든 점검에 스크립트가 필요한 것은 아니며, 지원이나 그로스 담당자도 브라우저에서 같은 OTP Gateway를 쓸 수 있습니다.

1. 이메일과 6자리 코드, 또는 Google로 가입합니다.
2. 지갑을 충전하고 OTP Gateway를 엽니다.
3. 이집트와 서비스를 선택합니다. 확정하기 전에 가격이 표시됩니다.
4. +20 번호를 앱에 복사하고 화면에 코드가 나타나기를 기다립니다.

activation은 API 주문과 동일하므로 수동 점검과 자동화된 점검이 같은 방식으로 동작합니다.

+20 코드가 끝내 오지 않으면 어떻게 되나요?

각 activation은 20분 동안 열려 있습니다. 그 시간 안에 SMS가 도착하지 않거나 먼저 취소하면 전액이 자동으로 지갑에 환불되므로, 반응 없는 번호 때문에 비용이 드는 일은 없습니다.

코드가 계속 실패할 때는 다음을 확인하세요.

• 실패로 판단하기 전에 제한 시간이 끝날 때까지 기다리세요. 전달 시간은 서비스와 경로에 따라 다릅니다.
• 서비스가 가상 번호를 허용하는지 확인하세요. 일부는 거부하며, 어떤 경로를 선택해도 바뀌지 않습니다.
• 잠시 후에 다시 시도하거나, 테스트가 이집트 번호에 의존하지 않는다면 인접 경로를 써 보세요.
• 짧은 간격으로 재주문을 반복하지 마세요. 주문 사이 간격을 점점 늘리고 모든 activation id를 로그에 남기세요.

재시도 정책은 OTP 전달 실패 줄이기 글에서 더 자세히 다룹니다.

제품 팀은 왜 이집트 번호로 테스트하나요?

이집트는 아랍어권에서 가장 큰 시장 중 하나이므로 제품을 아랍어로 현지화하는 팀이 가장 먼저 찾는 곳입니다. 실제 +20 번호는 에뮬레이터가 건너뛰는 부분, 즉 국가 선택기, 트렁크 0 처리, 아랍어 SMS 템플릿, 코드 입력 화면의 오른쪽에서 왼쪽 레이아웃을 시험합니다.

지역 운영 팀도 릴리스 후 이집트 고객의 가입 흐름이 여전히 작동하는지 확인하는 데 OTP 라우팅을 사용하며, 해외에 거주하는 이집트 사람들을 대상으로 하는 회사는 +20 번호가 국외에서도 받아들여지는지 점검합니다.

이집트 장기 회선이 있나요? 결제는 어떻게 이루어지나요?

이집트에는 셀프 서비스 장기 번호가 없습니다. 전용 회선은 미국·캐나다 전용 상품으로 월 $1.95부터입니다. 이집트 회선을 계속 쓰고 싶다면 [email protected]으로 이메일을 보내세요. 현지 규정상 가능한지 팀이 알려 드리며, 가능하다는 약속은 아닙니다.

결제는 월 이용료나 선택할 요금제가 없는 선불 USD 지갑입니다. 카드 또는 USDT/USDC로 충전하며, 충전 후에는 PDF 인보이스가 이메일로 발송됩니다. 연동을 구축하는 동안에는 개발 계정의 샌드박스 모드를 요청할 수 있으며, 지갑 잔액을 건드리지 않고 시뮬레이션된 번호와 코드가 반환됩니다. 현재 요금은 요금 페이지에 있습니다.

자주 묻는 질문

이집트 SIM 카드 없이 앱의 이집트 가입 OTP를 확인할 수 있나요?

네. OTP Gateway에서 +20 번호를 주문해 가입 양식에 입력하고 대시보드나 API에서 코드를 읽으세요. 현지 SIM은 필요 없습니다.

OTP Route API는 이집트에 어떤 국가 id를 사용하나요?

이집트는 eg입니다. 가격 엔드포인트와 POST /api/v1/activations 본문에 전달하세요.

SMS가 오지 않으면 +20 번호 요금을 내야 하나요?

아니요. 20분 안에 코드가 도착하지 않거나 activation을 취소하면 전액이 자동으로 지갑으로 환불됩니다.

이집트 휴대폰 번호를 저장할 때 앞의 0을 유지해야 하나요?

아니요. 0은 국내 트렁크 접두사이므로 제거하고 +20으로 시작하는 E.164 형식으로 저장하세요.

다음 달에 같은 이집트 테스트 번호로 다시 로그인할 수 있나요?

안정적으로는 어렵습니다. OTP Gateway 번호 하나는 인증 코드 한 건을 위한 것이고 셀프 서비스 전용 회선은 미국과 캐나다에만 있으므로, 반복 로그인이 필요한 계정은 이를 고려해 계획하세요.

이집트 번호로 플랫폼에 많은 계정을 만들 수 있나요?

아니요. OTP Route는 자사 제품을 테스트하고 정당한 자사 계정을 운영하기 위한 서비스입니다. 각 서비스의 약관과 이용 정책을 따르세요.

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