팀이 테스트와 운영을 위해 DiDi SMS 코드를 받는 방법

상황: 전화번호 하나에 달려 있는 모빌리티 계정

DiDi는 차량 호출 및 모빌리티 플랫폼이며, 그 분야의 대부분의 앱처럼 휴대폰 번호를 계정의 핵심으로 다룹니다. SMS 코드는 보통 가입할 때, 새 기기에서 로그인할 때, 계정 복구 중에 요청되며, 드라이버와 배송원 온보딩도 같은 확인에 의존합니다.

이는 정당한 비즈니스 업무에 마찰을 일으킵니다. 법인 승객 계정을 운영하는 회사는 그것이 직원 한 명의 개인 휴대폰에 묶이는 것을 원하지 않습니다. 고객의 출장을 관리하는 에이전시에는 최초 가입자가 아닌 다른 사람이 완료할 수 있는 인증 단계가 필요합니다. DiDi 계정과 연결되는 제품을 만드는 QA 팀은 개인 휴대폰을 사무실에서 돌려 쓰지 않고 흐름을 연습하고 싶습니다. 인증마다 한 번 쓰는 DiDi용 가상 번호는 이런 단계를 누군가의 개인 SIM에서 떼어 놓습니다.

어느 국가에서 DiDi 전화번호를 얻을 수 있나요?

didi 경로는 현재 198개 국가에 걸쳐 있습니다. 팀은 대개 차량 호출 수요가 높은 시장에서 시작하며, 멕시코, 브라질, 칠레, 콜롬비아, 페루, 아르헨티나, 코스타리카, 파나마, 도미니카 공화국, 에콰도르, 호주, 뉴질랜드, 일본, 홍콩 등이 있습니다.

국가를 의도적으로 고르세요. 산티아고에서 쓸 승객 계정은 칠레 번호로, 멕시코 가입 화면의 회귀 테스트는 멕시코 번호로 인증해야 합니다. 번호의 국가와 계정의 시장이 어긋나는 것은 테스트가 문서상으로는 통과하지만 실제 앱에서는 실패하는 흔한 원인입니다. 전체 목록은 국가 아래에 있습니다.

DiDi 인증 코드 API 흐름은 어떻게 진행되나요?

DiDi 흐름은 다른 모든 경로와 같은 기본 URL인 https://otproute.com/api/v1을 쓰며, Authorization 헤더에 or_live_ 키를 넣습니다.

1. GET /api/v1/prices?country=<id>&service=didi로 경로가 열려 있는지와 현재 비용을 확인합니다.
2. {"service": "didi", "country": "mx"} 같은 본문으로 POST /api/v1/activations를 호출해 주문합니다.
3. 반환된 번호를 테스트 중인 DiDi 화면에 입력하고 SMS를 요청합니다.
4. 웹훅에서 코드를 읽거나 나타날 때까지 GET /api/v1/activations/{id}를 폴링합니다.
5. 승차 예약 테스트가 중간에 중단되면 POST /api/v1/activations/{id}/cancel로 번호를 해제합니다.

계정은 키 10개와 웹훅 엔드포인트 5개를 둘 수 있으며 분당 300건 이내입니다.

DiDi 웹훅 핸들러는 어떻게 작성해야 하나요?

activation.sms_received를 구독하고, 테스트가 기다림을 멈출 때를 알 수 있도록 activation.expired와 activation.cancelled도 구독하세요. 모든 전송에는 X-OTPRoute-Signature: t=<unix>,v1=<hex>가 포함됩니다. 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 다시 계산하고, 상수 시간으로 비교하며, 타임스탬프가 오래된 것은 버리세요.

이벤트는 activation id를 키로 하므로 주문할 때 그 id를 저장하고, 같은 id의 두 번째 전송은 아무 동작도 하지 않도록 처리하세요. 재시도된 웹훅이 DiDi 코드를 두 번 제출하지 않아야 하기 때문에 이 멱등성이 중요합니다. 환경에서 인바운드 웹훅이 불편하다면 activation 엔드포인트 폴링도 가능합니다. 웹훅 기반 OTP 수집 글에서 두 접근법을 비교합니다.

대시보드에서 DiDi OTP 받기

운영 담당자는 API를 완전히 건너뛸 수 있습니다. 로그인하고 지갑을 충전한 뒤 OTP Gateway를 열어 DiDi를 검색하고, 계정에 맞는 국가를 고른 다음 확정하기 전에 표시된 가격을 확인하세요. 번호는 activation 카드에 나타나고, DiDi가 코드를 보내면 같은 곳에 표시됩니다. activation은 20분 동안 열려 있습니다.

DiDi 코드가 도착하지 않을 수 있는 이유는?

빈 activation에는 몇 가지 평범한 원인이 있습니다.

• DiDi는 다른 많은 플랫폼처럼 일부 경로나 일부 시간대에 가상 번호를 거부할 수 있습니다.
• 선택한 국가의 경로가 혼잡할 수 있으며 가용성은 하루 종일 변합니다.
• 테스트 중 같은 기기나 세션의 반복 요청을 앱이 제한할 수 있습니다.

해결책은 공격적이지 않고 인내하는 것입니다. 창이 끝나도록 두고, 나중에 다시 시도하거나 테스트에 여전히 맞는 다른 국가를 쓰며, 빠른 루프로 다시 주문하지 마세요. 놓친 것에 대해서는 비용이 들지 않습니다. 창이 닫히거나 취소하면 전액이 자동으로 지갑에 돌아옵니다.

DiDi 계정은 언제 전용 번호에 두어야 하고, 어떤 규칙이 적용되나요?

일회용 activation은 단일 인증에 적합합니다. 스테이징 승객 계정이나 공유 법인 로그인처럼 같은 DiDi 계정이 다음 달에 다시 로그인해야 한다면, 전용 번호가 그 회선을 내 통제 아래에 둡니다. 전용 번호는 미국과 캐나다에서만 월 $1.95부터 제공되며, 수신 SMS는 대시보드와 웹훅에 표시됩니다. 자세한 내용은 가상 번호를 참고하세요.

OTP Route는 본인의 정당한 제품과 계정을 테스트하고 운영하는 데만 사용하세요. DiDi의 약관을 따르고, 실제 사람 또는 사업체당 계정 하나를 유지하며, OTP Route의 Acceptable Use Policy가 적용된다는 점을 유념하세요. OTP Route는 DiDi와 제휴 관계가 없으며 DiDi라는 이름은 해당 소유자의 상표입니다.

자주 묻는 질문

DiDi SMS 인증 테스트의 서비스 id는 무엇인가요?

service 필드에 didi를 쓰고, 테스트하는 시장의 국가 id를 함께 넣으세요.

멕시코 SIM 없이 멕시코 계정용 DiDi OTP를 받을 수 있나요?

멕시코 경로가 열려 있다면 가능합니다. 국가 mx와 서비스 didi로 번호를 주문한 뒤 API나 대시보드에서 코드를 읽으세요.

DiDi가 코드를 보내지 않으면 비용을 내나요?

아니요. 20분 안에 SMS가 없는 activation이나 취소한 activation은 전액 지갑으로 환불됩니다.

DiDi는 모든 가상 번호를 받아들이나요?

반드시 그렇지는 않습니다. 일부 경로는 거부될 수 있으니 나중에 다시 시도하거나 알맞은 다른 국가를 쓰세요.

지갑 자금을 쓰지 않고 DiDi 연동을 테스트할 수 있나요?

가능합니다. 요청하면 개발 계정을 샌드박스로 전환할 수 있으며, 엔드 투 엔드 테스트용으로 시뮬레이션된 번호와 코드가 반환됩니다.

DiDi activation은 어떻게 결제하나요?

카드 또는 USDT/USDC로 선불 USD 지갑을 충전합니다. 월 요금은 없고 충전할 때마다 PDF 인보이스가 제공됩니다. 현재 요금은 요금 페이지에 있습니다.

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