팀에 +223 SIM이 없을 때 말리 가입 플로우 테스트하기

제품은 말리에서 출시하는데 현지 SIM을 가진 사람이 없다면?

QA 리드에게는 익숙한 난관입니다. 제품 팀은 바마코 마케팅 캠페인 전에 말리 가입 경로를 검증하길 원하고, 전화번호 입력란은 이미 +223을 받으며, 엔지니어들의 휴대폰에는 모두 유럽이나 북미 SIM이 들어 있습니다. 동료의 개인 번호를 빌리는 방식은 불안정하고, 테스트 스위트로 확장되지 않으며, 직원 정보를 테스트 계정으로 흘려보냅니다.

OTP Gateway의 말리 인증 번호는 이 좁은 문제를 해결합니다. 실제 +223 번호 하나를 코드 하나에 쓰고 폐기하는 방식이며, 스크립트로 제어하거나 대시보드에서 직접 주문할 수 있습니다. 팀이 회귀 테스트에 이를 끼워 넣는 방법은 QA 테스트와 CI/CD 페이지에 설명되어 있습니다.

말리 인증 번호로 어떤 앱의 코드를 받을 수 있나요?

말리의 현재 스냅샷에는 WhatsApp, Facebook, Telegram, TikTok, Google (Gmail & YouTube), Instagram, Snapchat, imo, Viber, Signal, Microsoft & Outlook, ChatGPT (OpenAI), LinkedIn이 포함됩니다. 게이트웨이 전체를 기준으로 말리에서는 1,600개 넘는 서비스를 사용할 수 있습니다.

가용 여부는 고정되어 있지 않습니다. 라우트는 하루 동안 열리고 닫히므로, 스크립트는 어제의 결과가 아직 유효하다고 가정하지 말고 실행 시점에 서비스를 구매할 수 있는지 확인해야 합니다.

말리 OTP API 플로우는 코드에서 어떻게 동작하나요?

요청은 or_live_로 시작하는 Bearer 키와 함께 https://otproute.com/api/v1로 보냅니다. 키는 개발자 콘솔에서 계정당 최대 10개까지 발급할 수 있습니다.

1. GET /api/v1/services와 GET /api/v1/countries에서 ID를 한 번 가져옵니다. 말리는 ml입니다.
2. GET /api/v1/prices?country=ml&service=<id>로 실시간 가격을 확인합니다.
3. POST /api/v1/activations로 주문합니다. 예: {"service": "whatsapp", "country": "ml"}. 액티베이션 ID는 보관하세요.
4. 반환된 +223 번호를 앱의 인증 폼에 입력합니다.
5. GET /api/v1/activations/{id}에서 코드를 가져오거나 웹훅이 알려 주도록 합니다. 사용하지 않는 번호는 POST /api/v1/activations/{id}/cancel로 해제합니다.

웹훅의 경우 엔드포인트(최대 5개)가 activation.sms_received, activation.expired, activation.cancelled를 구독하게 하세요. 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 계산해 X-OTPRoute-Signature를 검증하고, 오래된 타임스탬프를 거부하며, 핸들러를 액티베이션 ID 기준으로 멱등하게 만드세요. 계정 한도는 분당 300건이며, API 연동 가이드에 실제 예제가 있습니다.

여덟 자리, 트렁크 접두어 없음: 말리 번호 저장하기

말리는 트렁크 접두어 없는 폐쇄형 여덟 자리 체계를 사용하므로, 국내에서 거는 번호가 해외에서 +223 뒤에 붙는 여덟 자리와 같습니다. 정규화가 아주 간단해지는 셈입니다. E.164 형식은 +223에 여덟 자리를 붙인 것이고 추가하거나 제거할 앞자리 0이 없습니다. 다만 열 자리 시장을 기준으로 만든 일반 규칙은 정상적인 말리 입력을 거부하므로 길이는 명시적으로 검증하세요.

국제 앱의 인증 문자는 보통 프랑스어로 오고, 일상에서 가장 널리 쓰이는 언어는 밤바라어입니다. 따라서 코드는 대체로 프랑스어나 영어 템플릿 안에 담겨 오므로, 문구를 매칭하지 말고 숫자 패턴으로 추출하세요.

왜 굳이 여기서 테스트할까요? 서아프리카에서 모바일 머니와 인접한 제품을 출시하는 팀, 바마코에서 현장 직원 계정을 운영하는 NGO와 물류 업체, 프랑스와 인접국에 사는 많은 말리 디아스포라를 상대하는 앱 모두 +223 경로가 정상 동작해야 합니다. 출시가 지역 단위라면 세네갈 같은 라우트 점검도 함께 진행하세요.

+223 코드가 오지 않을 때 해야 할 일

SMS가 오지 않는 것은 대개 연동이 아니라 라우트나 서비스 쪽 문제입니다. 버그를 등록하기 전에 다음을 확인하세요.

• 20분을 끝까지 기다리세요. 일부 발신자는 메시지를 묶음으로 내보냅니다.
• 서비스가 가상 번호를 거부하는지 알아보세요. 거부하는 서비스도 있으며, 이 경우 자동 환불이 보호해 줍니다.
• 빠른 루프로 다시 주문하지 말고 나중에 다시 오거나 다른 서비스 라우트를 시도하세요.
• 포기한 액티베이션은 취소해서 잔액을 즉시 복구하세요.

윈도우가 닫힐 때까지, 또는 먼저 취소하기 전까지 아무것도 도착하지 않았다면 전액이 지갑으로 돌아갑니다.

팀이 말리 번호를 장기 보유할 수 있나요?

OTP Route는 셀프서비스 장기 말리 번호를 제공하지 않습니다. ml에서는 일회용 OTP Gateway만 사용할 수 있습니다.

지갑에서 갱신되며 인바운드·아웃바운드 SMS와 브라우저 통화를 지원하는 OTP Route의 Dedicated Virtual Numbers는 미국과 캐나다에서만 제공되며 월 $1.95부터 시작합니다($1.95/month). 운영에 상시 +223 회선이 중요하다면 [email protected]으로 이메일을 보내세요. 게이트웨이 외의 것은 현지 규정에 따라 달라지며 보장되지 않습니다.

말리 OTP 라우팅 비용 결제와 비용 없는 테스트

하나의 선불 USD 지갑으로 모든 국가를 처리합니다. 사용한 만큼만 내며 월 요금이 없고 요금제를 고를 필요도 없습니다. 카드 또는 USDT/USDC로 충전하고, 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다.

아직 개발 중이라면 지원팀에 개발 계정을 샌드박스 모드로 전환해 달라고 요청하세요. 그러면 시뮬레이션된 번호와 코드를 받아 지갑 비용 없이 SMS 인증 API 전체 시퀀스를 연습할 수 있습니다. 실제 번호는 자사 제품과 합법적인 계정에만 사용하고, 각 서비스의 약관과 이용 정책(Acceptable Use Policy)을 준수하세요. 현재 요금은 요금 페이지에 있습니다.

자주 묻는 질문

현지 SIM을 사지 않고, 가지 않고도 말리 가입을 검증할 수 있나요?

네. OTP Gateway에서 테스트용 +223 번호를 주문해 앱에 입력하고, 대시보드나 API로 코드를 읽으면 됩니다.

OTP Route API에서 말리의 ID는 무엇인가요?

말리는 ml이며, 가격 조회와 액티베이션 요청 본문 모두에 들어가는 값입니다.

말리 번호는 제거해야 할 앞자리 0이 있나요?

아니요. 말리에는 트렁크 접두어가 없으며, 유효한 번호는 +223 뒤에 여덟 자리가 옵니다.

말리 SMS OTP는 얼마인가요?

말리 코드는 코드당 $0.20 이상이며, 앱별 금액은 구매 전에 API가 실시간으로 알려 줍니다.

앱이 코드를 보내지 않으면 손해를 보나요?

아니요. 20분 윈도우가 끝날 때까지 SMS가 없거나 직접 취소한 액티베이션은 지갑으로 전액 환불됩니다.

코딩을 못 하는 사람도 사용할 수 있나요?

네. 대시보드에서 말리와 서비스를 선택하고 번호를 주문한 뒤 앱에 붙여 넣으면, 액티베이션 화면에 코드가 나타납니다.

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