브라질 SMS 인증을 위한 +55 경로 선택하기

브라질 테스트에는 OTP Gateway와 장기 회선 중 무엇을 써야 하나요?

작업의 성격부터 따져 보세요. 그것이 어떤 상품을 쓸지 결정하기 때문입니다. 브라질 인증 테스트는 보통 코드가 한 번만 필요합니다. 포르투갈어 가입 화면, 로그인 확인, 전화번호 변경 단계 같은 경우입니다. 이것이 바로 OTP Gateway가 만들어진 목적입니다. 서비스와 브라질을 선택하면 코드 한 번을 위한 +55 번호를 받고, 활성화는 20분 뒤 또는 SMS가 도착하면 종료됩니다.

장기 회선은 이야기가 다릅니다. Dedicated Numbers는 미국과 캐나다 전용 상품으로, 대시보드에서 월 $1.95부터 즉시 구매할 수 있으며 SMS 수신과 발신, 브라우저 통화를 지원합니다. 셀프 서비스 +55 장기 번호는 없습니다. 팀에 유지할 수 있는 브라질 회선이 정말 필요하다면 [email protected]으로 사용 사례를 적어 보내 주세요. 가능 여부는 현지 규정에 따르며 아무것도 약속되지 않습니다.

간단한 기준은 다음과 같습니다.

• 테스트 케이스마다 코드 하나, 실행마다 새 상태: br과 함께 OTP Gateway.
• 다음 달에 다시 로그인해야 하는 스테이징 계정: 서비스가 허용한다면 미국 또는 캐나다 Dedicated Number.
• 확신이 서지 않을 때: 무엇이든 구매하기 전에 임시 번호와 전용 번호 비교를 읽어 보세요.

지금 브라질 번호로 코드를 보낼 수 있는 앱은 무엇인가요?

브라질 경로는 현재 2,900개가 넘는 서비스를 지원하며, 실시간 스냅샷의 대표적인 서비스로는 WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Discord, Microsoft & Outlook, LinkedIn, Netflix, Airbnb, Shopee, AliExpress 등이 있습니다.

그 목록은 계약이 아니라 스냅샷으로 보세요. 통신사 파트너가 경로를 추가하고 교체하면서 하루 중에도 사용 가능 여부가 바뀌므로, 파이프라인은 하드코딩된 목록을 믿지 말고 API에 물어봐야 합니다. 브라우저를 선호하는 분들은 국가 디렉터리에서 같은 실시간 데이터를 볼 수 있습니다.

브라질 OTP API 흐름은 실제로 어떻게 진행되나요?

모든 호출은 https://otproute.com/api/v1로 보내며, 개발자 콘솔에서 생성한 or_live_ 접두사의 Bearer 키를 사용합니다. 브라질의 국가 id는 br입니다.

1. GET /api/v1/services로 서비스 id를 한 번 확인하고 설정에 보관합니다.
2. 주문 전에 GET /api/v1/prices?country=br&service=whatsapp(또는 사용하는 서비스 id)를 호출합니다. 응답에는 해당 조합의 실시간 가격과 사용 가능 여부가 들어 있습니다.
3. POST /api/v1/activations에 {"service": "whatsapp", "country": "br"} 본문을 보내 활성화를 생성합니다. 활성화 id는 테스트 실행 정보와 함께 저장하세요.
4. +55 번호를 테스트 중인 흐름에 입력합니다.
5. 웹훅으로 activation.sms_received 이벤트를 수신하고, 대비책으로 몇 초마다 GET /api/v1/activations/{id}를 확인합니다.
6. 테스트가 중단되면 POST /api/v1/activations/{id}/cancel로 번호를 해제해 자금이 즉시 돌아오게 합니다.

웹훅 전송은 X-OTPRoute-Signature에 t=<unix>,v1=<hex> 형태로 서명되며, 이는 엔드포인트 시크릿으로 계산한 <t>.<raw body>의 HMAC-SHA256입니다. 이를 검증하고, 오래된 타임스탬프는 버리며, 활성화 id를 기준으로 핸들러를 멱등하게 만드세요. 전체 레퍼런스는 API 문서에 있습니다.

그로스 팀 담당자도 코드 없이 이 작업을 할 수 있나요?

네. 대시보드에서는 스크립트 없이 같은 OTP 라우팅이 실행됩니다.

1. 이메일과 6자리 이메일 코드 또는 Google 로그인으로 계정을 만듭니다.
2. USD 지갑에 자금을 충전합니다.
3. 브라질과 서비스를 선택하고, 표시된 가격을 확인한 뒤 주문합니다.
4. +55 번호를 앱에 붙여 넣고 활성화 카드에 코드가 나타나는 것을 지켜봅니다.

마케팅, 지원, 현지화 검토 담당자는 릴리스 전에 포르투갈어 온보딩 화면이 제대로 동작하는지 확인하려고 이 경로를 자주 사용하고, 엔지니어는 자동화된 실행에 API를 사용합니다.

+55 번호는 어떻게 저장하고 정규화해야 하나요?

브라질 번호는 2자리 지역 번호(DDD) 뒤에 가입자 번호가 오며, 휴대폰 번호는 9로 시작하는 9자리입니다. 브라질 안에서는 장거리 전화에 맨 앞 0과 통신사 선택 코드를 누르기 때문에, 사용자 입력에는 저장하면 안 되는 추가 숫자가 들어 있는 경우가 많습니다.

모든 번호는 E.164로 저장하세요. +55, 지역 번호, 가입자 번호 순서로 공백, 맨 앞 0, 통신사 코드 없이 저장합니다. 입력 시 정규화하고, 정규화된 값으로 비교하며, 표시할 때만 서식을 적용하세요. 브라질 발신자의 코드는 보통 포르투갈어로, 때로는 영어로 도착하므로 고정된 문장을 매칭하지 말고 숫자를 파싱하세요.

팀들은 브라질 출시, 포르투갈어 현지화 QA, 그리고 브라질 개인정보 보호법(LGPD)에 따른 의무와 함께 다루는 온보딩 흐름 때문에 이 시장을 테스트합니다. 그 작업의 인증 측면은 핀테크 온보딩 페이지에서 다룹니다.

브라질 코드가 도착하지 않으면 어떻게 하나요?

먼저 20분 활성화 시간이 끝나도록 두세요. 발신자마다 속도가 다르며, 도착 여부는 서비스와 경로에 달려 있습니다. 만료되면 요금은 자동으로 취소되며, 잠시 후 다시 시도하거나 API가 안내하는 다른 경로로 시도해 볼 수 있습니다.

• 서비스가 가상 번호를 받는지 먼저 확인하세요. 받지 않는 서비스도 있으며, 환불 규정이 있는 이유가 바로 이것입니다.
• 짧은 간격으로 반복 주문하지 마세요. 시도 사이에 간격을 두고 활성화 id를 각각 기록하세요.
• 앱이 트렁크 숫자가 포함된 현지 형식이 아니라 전체 국제 형식으로 번호를 보냈는지 확인하세요.

OTP 인증 실패 줄이기 가이드에 더 많은 진단 방법이 있습니다.

지갑, 인보이스, 샌드박스는 어떻게 연결되나요?

OTP Route는 하나의 선불 USD 지갑에서 청구하며, 사용한 만큼만 내고 월 요금도 선택할 요금제도 없습니다. 카드 또는 USDT나 USDC로 충전하고, 충전할 때마다 PDF 인보이스가 이메일로 도착합니다. 전체 요금은 요금제 페이지와 API에 있습니다.

연동 작업이라면 지원팀에 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 모의 번호와 코드가 반환되므로 지갑 자금을 쓰지 않고 활성화와 웹훅 경로를 종단 간으로 시험할 수 있습니다. 본인의 제품에만 사용하고, 각 서비스의 약관을 따르며, 모든 계정에 이용 정책(Acceptable Use Policy)이 적용된다는 점을 기억하세요.

자주 묻는 질문

현지 SIM 없이 내 앱의 브라질 가입 흐름을 테스트할 수 있나요?

네. OTP Gateway에서 자체 앱이나 지원되는 서비스용 +55 번호를 주문해 흐름에 입력하고, 대시보드나 API에서 코드를 확인하세요.

OTP Route API에서 브라질의 국가 id는 무엇인가요?

br입니다. 활성화를 생성할 때는 country 필드로, 가격 엔드포인트에서는 country 쿼리 매개변수로 전달하세요.

WhatsApp이 내 +55 번호로 코드를 보내지 않으면 요금이 부과되나요?

아니요. 20분 안에 번호로 SMS가 도착하지 않거나 먼저 취소하면 전액이 지갑으로 자동 환불됩니다.

브라질 번호를 구매해 몇 달 동안 유지할 수 있나요?

셀프 서비스 상품으로는 불가능합니다. 장기 Dedicated Numbers는 미국과 캐나다에서만 판매되며, 브라질은 [email protected]으로 문의하실 수 있으나 제공 여부는 약속되지 않습니다.

브라질 번호의 맨 앞 0을 저장해야 하나요?

아니요. 트렁크 0과 통신사 선택 코드를 제거하고, +55와 2자리 지역 번호로 시작하는 E.164 형식으로 저장하세요.

브라질 인증 메시지는 어떤 언어를 사용하나요?

대부분 포르투갈어로 오고, 일부 글로벌 서비스는 영어 문자를 보냅니다. 문구에 의존하지 말고 숫자 코드를 추출하세요.

지갑을 충전하기 전에 API를 체험해 볼 수 있나요?

개발 계정에 샌드박스 모드를 요청하세요. 번호와 코드를 모의로 제공하므로 지갑 자금을 쓰지 않고 전체 연동을 테스트할 수 있습니다.

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