아르헨티나(+54) 인증 코드를 내 연동 시스템으로 받아오기

+54 활성화를 처리하는 API 호출 네 가지는 무엇인가요?

모든 요청은 https://otproute.com/api/v1 아래에서 이루어지며 or_live_로 시작하는 Bearer 키로 인증합니다. 키는 개발자 콘솔에서 발급하며, 계정당 키 10개와 웹훅 엔드포인트 5개를 둘 수 있고 분당 요청 한도는 300건입니다.

1. 견적 확인. GET /api/v1/prices?country=ar&service=<id>를 호출해 지갑 자금을 쓰기 전에 실시간 비용을 확인합니다. 아르헨티나의 국가 ID는 ar입니다.
2. 주문. JSON 본문 {"service": "whatsapp", "country": "ar"}와 함께 POST /api/v1/activations를 보냅니다. 테스트에 필요한 서비스 ID로 바꾸세요. 응답에는 활성화 ID와 테스트 대상 앱에 입력할 +54 번호가 들어 있습니다.
3. 대기. 적절한 간격으로 GET /api/v1/activations/{id}를 읽거나, activation.sms_received 웹훅이 코드 도착을 알려 주게 하세요.
4. 필요하면 일찍 해제. POST /api/v1/activations/{id}/cancel은 더는 필요 없는 활성화를 종료하고 금액을 지갑으로 돌려줍니다.

ID를 하드코딩하기 전에 확인하고 싶다면 GET /api/v1/services와 GET /api/v1/countries가 플랫폼이 현재 제공하는 항목을 나열합니다. 전체 참조 자료는 문서에 있습니다.

아르헨티나 코드용 웹훅 수신기를 신뢰할 수 있게 만들려면 어떻게 하나요?

모든 전송에는 t=<unix>,v1=<hex> 형태의 X-OTPRoute-Signature 헤더가 포함됩니다. "<t>.<raw body>" 문자열을 재구성하고 해당 엔드포인트의 시크릿으로 HMAC-SHA256을 계산한 뒤, 결과를 상수 시간 함수로 v1과 비교하세요. 타임스탬프가 오래된 요청은 버리세요. 오래되었지만 유효한 서명은 바로 재전송 공격의 모습이기 때문입니다.

activation.sms_received 외에 activation.expired와 activation.cancelled도 구독하면 테스트 러너가 이미 종료된 번호를 하염없이 기다리는 일이 없습니다. 모든 이벤트를 활성화 ID 기준으로 취급하고, 같은 이벤트가 두 번 전달되어도 아무것도 바뀌지 않도록 핸들러를 작성하세요. OTP 웹훅 서명과 검증 글에서 비교 로직을 더 자세히 설명합니다.

아르헨티나 번호로 어떤 앱을 인증할 수 있나요?

아르헨티나의 실시간 스냅샷에는 2,000개가 넘는 서비스가 나옵니다. 아르헨티나의 제품팀과 QA팀이 주로 찾는 서비스는 다음과 같습니다.

• 메시징: WhatsApp, Telegram, Signal, Discord
• 계정 및 생산성: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT(OpenAI)
• 소셜 및 동영상: Instagram, TikTok
• 커머스 및 이동: Amazon, Uber, Airbnb, Netflix

이 목록은 하루 중에도 바뀌기 때문에 API가 고정된 표 대신 실시간으로 이용 가능 여부를 알려 줍니다. 예약된 CI 작업이 시작되기 전에 ar 국가를 염두에 두고 GET /api/v1/services를 조회하고, 대상 서비스가 일시적으로 없으면 명확한 메시지와 함께 빠르게 실패하게 하세요.

아르헨티나 휴대폰 번호가 번호 검증기에서 문제를 일으키는 이유는 무엇인가요?

아르헨티나는 이 지역에서 비교적 독특한 번호 체계를 가지고 있습니다. 국내에서는 지역 번호 앞에 트렁크 0을 쓰고, 휴대폰은 가입자 번호 앞에 15를 붙이기 때문에 부에노스아이레스의 휴대폰은 011 15 뒤에 8자리로 표기될 수 있습니다. 국제 E.164 형식에서는 이 둘이 모두 사라지고 국가 코드 바로 뒤에 9가 삽입됩니다. 즉 +54 9 11 뒤에 8자리 가입자 번호가 옵니다.

이 차이는 전화번호를 저장하는 모든 사람에게 중요합니다. 저장하기 전에 모두 E.164로 정규화하고, 입력에서 0과 15를 제거하며, 휴대폰 번호에는 9를 추가하세요. 길이만 확인하는 검증기는 SMS를 받을 수 없는 유선 전화 형태의 +54 11 값도 그대로 통과시킵니다. 번호를 직접 다시 포맷하지 말고 API가 반환한 그대로 사용하세요.

아르헨티나 번호로 오는 코드는 대개 스페인어이며, 숫자 주위에 "Tu código es" 같은 문구가 붙는 경우가 많습니다. 템플릿은 바뀌므로 문구를 매칭하지 말고 패턴으로 숫자 코드를 파싱하세요. 팀이 이곳을 테스트하는 경우는 라틴 아메리카에 출시할 때, 리오플라텐세 스페인어 문구를 확인할 때(현지의 vos 활용형은 교과서적 스페인어와 다릅니다), 현지 운영을 할 때, 또는 해외에 살면서도 +54 SIM으로 가입하는 아르헨티나인을 상대할 때입니다.

코드를 쓰지 않는 사람도 +54 번호를 주문할 수 있나요?

예. 지원, 그로스, 에이전시 담당자는 브라우저에서 모든 것을 처리할 수 있습니다.

1. 회원가입에서 이메일과 6자리 코드 또는 Google 로그인으로 계정을 만듭니다.
2. 지갑에 자금을 충전합니다.
3. OTP Gateway를 열고 아르헨티나를 선택한 다음 테스트하려는 서비스를 고릅니다.
4. 표시된 가격을 확인하고 확정한 뒤, 앱의 인증 화면에 +54 번호를 복사해 넣습니다.
5. 활성화를 지켜보세요. 코드가 수신되는 즉시 거기에 표시됩니다.

대시보드와 API는 같은 지갑과 같은 활성화를 사용하므로, 개발자가 동료가 주문한 번호를 활성화 ID로 이어받아 쓸 수 있습니다.

아르헨티나 코드가 도착하지 않았어요. 다음에 무엇을 해야 하나요?

각 활성화는 20분 동안 열려 있습니다. 아무것도 도착하지 않거나 그 전에 취소하면 전체 금액이 지갑으로 자동 환불되므로, 응답 없는 경로는 돈이 아니라 시간만 소모합니다. 전달 속도는 서비스와 경로에 따라 다르니, 실패라고 결론짓기 전에 시간 창에 충분한 기회를 주세요.

그다음 아래 짧은 목록을 확인하세요.

• 앱 안에서 코드를 한 번 다시 요청한 뒤 시간 창이 끝날 때까지 기다립니다.
• 하루 중 나중에 시도하거나 같은 서비스에 다른 경로로 주문해 보세요.
• 서비스가 가상 번호를 허용하는지 확인하세요. 일부는 거부하며, 이것이 자동 환불이 존재하는 이유입니다.
• CI에서 짧은 간격으로 반복 주문하지 마세요. 백오프와 재시도 횟수 상한을 추가하세요.

OTP 전달 실패 줄이기 글에서 아르헨티나 경로를 위한 추가 패턴을 다룹니다. 모든 테스트는 각 서비스의 약관 안에서 진행하세요. OTP Route 이용 정책(Acceptable Use Policy)도 적용됩니다.

아르헨티나 회선을 유지할 수 있나요? 결제는 어떻게 하나요?

현재 아르헨티나에는 셀프서비스 장기 번호가 없습니다. 팀에 지속적인 +54 회선이 필요하면 [email protected]으로 이메일을 보내 사용 사례를 설명해 주세요. 가능 여부는 현지 규정에 따라 달라지며 보장되지 않습니다. 갱신되는 동안 유지하고 수신 SMS를 웹훅으로 전달하는 전용 가상 번호(Dedicated Virtual Numbers)는 미국과 캐나다 전용 상품이며 월 $1.95부터 시작합니다.

결제는 월 요금도, 선택할 요금제도 없는 선불 USD 지갑 하나로 이루어집니다. 카드 또는 USDT/USDC로 충전하며, 충전할 때마다 PDF 인보이스가 이메일로 발송됩니다. 자세한 내용은 가격 페이지에 있습니다. 실제 자금을 쓰기 전에 개발 계정을 샌드박스로 전환해 달라고 요청하세요. 시뮬레이션된 번호와 코드를 반환하므로 아르헨티나 전체 흐름을 처음부터 끝까지 미리 연습할 수 있습니다.

자주 묻는 질문

OTP Route API에서 아르헨티나의 국가 ID는 무엇인가요?

ar입니다. POST /api/v1/activations의 country 필드와 GET /api/v1/prices의 쿼리 문자열에 사용하세요.

앱에 +54 번호를 입력할 때 9를 추가해야 하나요?

OTP Route가 반환한 번호를 그대로 사용하세요. 자체 데이터베이스에는 아르헨티나 휴대폰을 +54 뒤에 9를 포함하고 국내용 0과 15는 뺀 E.164 형식으로 저장하세요.

아르헨티나 SMS OTP를 받는 데 비용이 얼마인가요?

코드당 $0.20부터이며 서비스에 따라 다릅니다. 정확한 금액은 GET /api/v1/prices가 반환하고 주문을 확정하기 전에 화면에 표시됩니다.

현지 SIM 없이 내 앱의 아르헨티나 가입 흐름을 테스트할 수 있나요?

예. 직접 만든 앱이나 테스트 대상인 서드파티 서비스에 맞춰 아르헨티나 활성화를 주문하고 +54 번호를 입력한 다음, 대시보드나 웹훅에서 코드를 읽으면 됩니다.

같은 +54 번호를 다음 달 로그인에도 쓸 수 있나요?

아니요. 게이트웨이 번호는 20분 안에 코드 하나만 처리합니다. 계속 코드를 받아야 하는 계정에는 미국 또는 캐나다의 전용 번호가 적합합니다.

아르헨티나 인증 문자는 어떤 언어로 오나요?

대개 스페인어지만 발신자와 계정의 언어 설정에 따라 다릅니다. 주변 단어에 의존하지 말고 숫자를 추출하세요.

웹훅 대신 폴링을 써도 되나요?

예. 적당한 간격으로 GET /api/v1/activations/{id}를 폴링하되, 계정당 분당 300건 한도를 충분히 밑돌게 유지하세요.

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