Ra mắt tại Nhật Bản mà không cần điện thoại Nhật: kiểm thử mã +81

Vì sao đợt ra mắt tại Nhật Bản hay bị kẹt ở bước nhập số điện thoại?

Các đội chuẩn bị bản phát hành cho Nhật Bản thường đã dịch xong, đã nối xong các phương thức thanh toán và soạn xong trang App Store. Rồi ai đó hỏi ai sẽ xác minh luồng đăng ký bằng một số +81 thật, và cả phòng im lặng.

Khoảng trống này xuất hiện ở vài chỗ dễ đoán:

• QA bản địa hóa phải xác nhận trường điện thoại chấp nhận các định dạng mà người dùng Nhật thực sự gõ, kể cả số viết có dấu gạch ngang.
• Nhân viên vận hành khu vực ở Tokyo hay Osaka cần khôi phục một tài khoản doanh nghiệp dùng chung sau khi đổi thiết bị, và không ai muốn gắn số cá nhân vào đó.
• Đối tác và tích hợp với các nền tảng Nhật Bản đôi khi yêu cầu số địa phương khi onboarding hồ sơ doanh nghiệp.

OTP Gateway loại bỏ sự phụ thuộc vào SIM vật lý. Nó cung cấp một số +81 cho một lần xác minh, thu SMS qua định tuyến OTP trên các đối tác nhà mạng của chúng tôi, và chuyển kết quả đến code hoặc trình duyệt của bạn.

Tôi có thể xác minh những gì trên số +81 để kiểm thử?

Một số xác minh Nhật Bản hiện có thể đặt cho hơn 1,500 dịch vụ. Các tuyến phổ biến trong bản chụp trực tiếp gồm LINE, X (Twitter), Amazon, Netflix, Google (Gmail & YouTube), Instagram, TikTok, Discord, Uber, Airbnb, Microsoft & Outlook, ChatGPT (OpenAI), Facebook và WhatsApp.

LINE đáng được lưu ý riêng vì đây là ứng dụng nhắn tin mặc định của một bộ phận lớn người dân Nhật Bản, nên sản phẩm có đăng nhập LINE hoặc thông báo LINE nên bao phủ cả luồng đó lẫn SMS thông thường. Tình trạng khả dụng thay đổi trong ngày, vì vậy danh sách trong công cụ của bạn nên lấy từ API thay vì từ trang này.

Nối API OTP Nhật Bản vào trình chạy kiểm thử thế nào?

API xác minh SMS nằm tại https://otproute.com/api/v1. Tạo một khóa trong Developer console (khóa bắt đầu bằng or_live_), gửi nó dưới dạng Bearer token, và giữ dưới 300 yêu cầu mỗi phút. Một tài khoản có thể giữ 10 khóa và 5 endpoint webhook.

Một lượt chạy điển hình như sau:

1. Tra các mã một lần bằng GET /api/v1/services và GET /api/v1/countries; Nhật Bản là jp.
2. Lấy mức giá hiện tại qua GET /api/v1/prices?country=jp&service=<id> và lưu cùng kết quả kiểm thử.
3. Tạo đơn bằng POST /api/v1/activations với nội dung {"service": "<id>", "country": "jp"}.
4. Nhập số nhận được vào ứng dụng đang kiểm thử và kích hoạt SMS.
5. Nhận activation.sms_received trên webhook của bạn, hoặc polling GET /api/v1/activations/{id} nếu trình chạy nằm sau tường lửa.
6. Khi dọn dẹp, gọi POST /api/v1/activations/{id}/cancel cho mọi lượt kích hoạt mà bài kiểm thử không còn cần.

Yêu cầu webhook mang header X-OTPRoute-Signature: t=<unix>,v1=<hex>. Hãy tính lại HMAC-SHA256 trên <t>.<raw body> bằng secret của endpoint, so sánh an toàn, và từ chối timestamp cũ. Hãy coi sự kiện được định danh theo mã kích hoạt để một lần gửi lại không gây hại. Về chi tiết CI, xem kiểm thử SMS OTP trong pipeline CI và giải pháp kiểm thử QA.

Người không phải lập trình viên ở văn phòng Tokyo có làm được từ trình duyệt không?

Có. Trong bảng điều khiển OTP Route, mở OTP Gateway, chọn Nhật Bản và dịch vụ, kiểm tra giá hiển thị rồi xác nhận. Số được hiển thị ngay; khi tin nhắn đến, mã xuất hiện bên cạnh. Không cần cài đặt gì, nên rất tiện cho trưởng nhóm hỗ trợ hoặc quản lý marketing kiểm tra luồng trang đích của một chiến dịch.

Số di động Nhật Bản được định dạng ra sao, và tin nhắn trông thế nào?

Nhật Bản dùng tiền tố trung kế nội địa là 0. Số di động thường được viết là 070, 080 hoặc 090 theo sau là tám chữ số, thường nhóm bằng dấu gạch ngang. Trong E.164 số 0 bị bỏ, nên 090 cùng phần còn lại thành +81 90 cộng tám chữ số. Chỉ lưu dạng E.164, xóa dấu gạch ngang và dấu cách khi người dùng gõ, và đảm bảo bộ kiểm tra hợp lệ không từ chối dải 070.

Tin nhắn xác minh thường đến bằng tiếng Nhật, trộn kanji, hiragana và katakana, và một số dùng chữ số toàn chiều rộng thay vì chữ số ASCII thông thường. Hãy chuẩn hóa văn bản bằng Unicode NFKC trước khi trích mã, nếu không biểu thức chính quy [0-9] có thể bỏ sót mà không báo lỗi. Văn bản tiếng Nhật cũng có nghĩa là SMS được gửi bằng mã hóa Unicode, nên hãy giữ log ở UTF-8 để đọc lại các lỗi sau này.

Mã không hiện lên. Chúng ta nên thử gì?

Không đến nghĩa là không tính phí: khi 20 phút trôi qua mà không có SMS, hoặc bạn hủy, toàn bộ số tiền được hoàn về ví tự động. Trước khi đặt lại:

• Hãy cho khung thời gian đủ lâu; mã đến muộn vẫn được thu nhận.
• Thử lại sau một khoảng nghỉ, hoặc chuyển sang tuyến khác cho cùng dịch vụ.
• Kiểm tra xem dịch vụ có chấp nhận số ảo ngay từ đầu không, vì một số từ chối.
• Tránh đặt lại liên tục trong vòng lặp nhanh từ tự động hóa; hãy giãn cách các lần thử.

Bài định tuyến quốc gia cho OTP giải thích vì sao các tuyến khác nhau.

Có đường dây Nhật Bản dùng lâu dài không, và ví được tính phí thế nào?

OTP Route không cung cấp số Nhật Bản dùng lâu dài tự phục vụ. Dedicated Virtual Number là sản phẩm dành cho Hoa Kỳ và Canada, từ $1.95/tháng; nếu bạn thật sự cần đường dây +81 lâu dài, hãy gửi email đến [email protected] và đội ngũ sẽ kiểm tra quy định địa phương cho phép gì, mà không hứa chắc là khả thi.

Thanh toán chạy qua một ví USD trả trước duy nhất: không thuê bao và không có gói. Nạp bằng thẻ hoặc USDT/USDC, và mỗi lần nạp có hóa đơn PDF gửi qua email. Theo yêu cầu, tài khoản phát triển có thể chạy ở chế độ sandbox với số và mã mô phỏng. Xem trang bảng giá để biết mức giá hiện tại.

Câu hỏi thường gặp

Tôi có thể nhận mã SMS OTP Nhật Bản mà không cần SIM Nhật không?

Có. OTP Gateway cấp một số +81 cho một lần xác minh và hiển thị mã trong bảng điều khiển hoặc gửi đến webhook của bạn.

Tôi gửi mã quốc gia nào cho Nhật Bản trong các lệnh gọi API?

Dùng jp trong nội dung kích hoạt và trong truy vấn giá.

Vì sao bộ phân tích của tôi bỏ sót mã trong tin nhắn tiếng Nhật?

Tin nhắn có thể dùng chữ số toàn chiều rộng. Hãy áp dụng chuẩn hóa NFKC trước khi so khớp, và mã sẽ khớp với mẫu chữ số thông thường.

Số 090 có nên được lưu kèm số 0 ở đầu không?

Không. Hãy lưu +81 theo sau là số không có số 0 trung kế, ví dụ +81 90 và tám chữ số còn lại.

Tiền của tôi sẽ ra sao nếu không có mã xác minh Nhật Bản nào đến?

Tiền được hoàn về ví tự động khi khung 20 phút kết thúc hoặc khi bạn hủy lượt kích hoạt.

Chúng tôi có thể kiểm thử đăng ký LINE cho thị trường Nhật Bản không?

LINE nằm trong số các dịch vụ khả dụng cho Nhật Bản, dù tình trạng khả dụng thay đổi. Hãy kiểm tra danh sách trực tiếp, và tuân thủ điều khoản của LINE với mọi tài khoản bạn tạo.

Có quy tắc nào về cách dùng các số này không?

Có. Chỉ dùng chúng cho sản phẩm và tài khoản hợp pháp của chính bạn, tôn trọng điều khoản của từng dịch vụ, và lưu ý rằng Chính sách sử dụng chấp nhận được của OTP Route cũng áp dụng.

Tên dịch vụ là nhãn hiệu của chủ sở hữu tương ứng. OTP Route không liên kết với họ. Hãy sử dụng số hợp pháp, tuân thủ điều khoản của từng dịch vụ và Chính sách sử dụng chấp nhận được của chúng tôi.