Xác minh luồng đăng ký tại Trung Quốc (+86) bằng API định tuyến OTP

Vì sao thị trường Trung Quốc cần một kế hoạch kiểm thử xác minh riêng?

Trung Quốc có một trong những hệ sinh thái di động lớn nhất thế giới, và phần lớn nằm trong các nền tảng nội địa chứ không phải những ứng dụng toàn cầu mà đội ngũ phương Tây thường kiểm thử trước. SIM ở đó được đăng ký theo quy định định danh thật, nên các dịch vụ trong nước coi số điện thoại là tín hiệu danh tính mạnh và thường khắt khe hơn về việc chấp nhận số nào.

Điều đó định hình cách một kỹ sư QA nên nghĩ về tuyến Trung Quốc:

• Thương mại xuyên biên giới. Người bán và người mua trên Alibaba và AliExpress xác nhận số điện thoại khi đăng ký hoặc đổi thông tin tài khoản, vì vậy các đội làm sàn thương mại muốn xem các tin nhắn này từ đầu đến cuối.
• Nội dung tiếng Trung. Mã từ các đơn vị gửi trong nước thường đến bằng tiếng Trung giản thể, hay mở đầu bằng tên đơn vị gửi trong ngoặc 【】. Bộ phân tích tìm từ tiếng Anh "code" sẽ bỏ sót chúng.
• Mã hóa. Văn bản tiếng Trung được gửi dưới dạng SMS Unicode, vì vậy hãy lưu nội dung tin nhắn bằng UTF-8 và trích xuất chữ số bằng mẫu bỏ qua các ký tự xung quanh.

Dùng số +86 để kiểm thử trên một tuyến thật sẽ lộ ra cả ba vấn đề này trước khi khách hàng gặp phải, và đó là lúc việc định tuyến OTP qua đường truyền nhà mạng Trung Quốc thực sự phát huy giá trị.

Nên lưu số di động +86 như thế nào?

Số di động đại lục có 11 chữ số và bắt đầu bằng 1. Khác với điện thoại cố định, vốn được quay trong nước bằng số 0 đầu và mã vùng, số di động hoàn toàn không có tiền tố trunk, nên dạng E.164 chỉ đơn giản là +86 theo sau là 11 chữ số.

Vài thói quen chuẩn hóa sẽ giúp bạn đỡ phải gỡ lỗi về sau:

• Bỏ khoảng trắng và dấu gạch ngang; người dùng thường gõ số theo nhóm 3-4-4.
• Chuyển 0086 hoặc 86 ở đầu thành +86 trước khi lưu, và đừng bao giờ thêm số 0 vào trước số di động.
• Kiểm tra độ dài sau khi chuẩn hóa: 11 chữ số quốc nội cho số di động, không hơn.

Hãy giữ một cột chuẩn duy nhất ở dạng E.164 và chỉ định dạng khi hiển thị ở lớp ngoài cùng. Số mà một lượt kích hoạt trả về đã theo đúng dạng chuẩn đó, nên nó là dữ liệu mẫu tiện lợi để viết unit test cho bộ chuẩn hóa của bạn.

Những ứng dụng nào có thể gửi mã đến tuyến Trung Quốc hiện nay?

Tuyến Trung Quốc hiện hỗ trợ hơn 1.300 dịch vụ. Những dịch vụ phổ biến trong bản chụp trực tiếp gồm WeChat, Alibaba, AliExpress, Microsoft & Outlook, LinkedIn, Telegram, WhatsApp, Google (Gmail & YouTube), TikTok, Amazon, Discord, ChatGPT (OpenAI) và Claude.

Tình trạng khả dụng thay đổi trong ngày khi các đối tác nhà mạng của chúng tôi thêm và rút bớt năng lực, vì vậy hãy xem danh sách đó là điểm khởi đầu. Hãy gọi GET /api/v1/services và GET /api/v1/countries để biết bức tranh hiện tại thay vì mã hóa cứng id dịch vụ vào ma trận kiểm thử.

Luồng API trông ra sao với country id cn?

Tạo một khóa Bearer (tiền tố or_live_) trong Developer console, rồi trỏ client của bạn tới https://otproute.com/api/v1. Một lượt chạy API OTP Trung Quốc điển hình diễn ra như sau, và chính các bước này cũng giúp bạn nhận SMS OTP Trung Quốc cho bất kỳ dịch vụ nào được hỗ trợ:

1. Gọi GET /api/v1/prices?country=cn&service=wechat để lấy giá trực tiếp của cặp dịch vụ-quốc gia bạn định kiểm thử.
2. Gửi POST /api/v1/activations với nội dung {"service": "wechat", "country": "cn"} và giữ lại id kích hoạt được trả về.
3. Nhập số +86 vào biểu mẫu đăng ký của sản phẩm đang kiểm thử.
4. Để webhook của bạn nhận activation.sms_received; nếu không có webhook, hãy kiểm tra GET /api/v1/activations/{id} vài giây một lần.
5. Gọi POST /api/v1/activations/{id}/cancel nếu bài kiểm thử bị hủy giữa chừng, việc này giải phóng khoản giữ tiền ngay lập tức.

Các lượt gửi webhook mang X-OTPRoute-Signature theo dạng 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 theo thời gian hằng định và loại bỏ các dấu thời gian đã cũ. Mỗi tài khoản có tối đa 10 khóa, 5 endpoint webhook và 300 yêu cầu mỗi phút; tài liệu tham chiếu đầy đủ nằm ở tài liệu API.

Người không biết lập trình có đặt được số Trung Quốc không?

Có. Quản lý sản phẩm và nhân viên hỗ trợ có thể làm toàn bộ trên dashboard:

1. Mở OTP Gateway, chọn Trung Quốc, rồi chọn dịch vụ.
2. Kiểm tra mức giá hiển thị trước khi đặt.
3. Sao chép số +86 vào ứng dụng bạn đang xác minh.
4. Theo dõi thẻ kích hoạt; nội dung tin nhắn sẽ hiện ở đó ngay khi nhận được.

Cùng cửa sổ 20 phút và quy tắc hoàn tiền được áp dụng, nên việc kiểm tra thủ công một màn hình onboarding đã bản địa hóa không tốn gì nếu ứng dụng không gửi bất cứ thứ gì.

Nên thử gì khi mã Trung Quốc không đến?

Im lặng thường có nghĩa là dịch vụ từ chối gửi đến số đó hoặc tuyến đang bận, chứ không phải tích hợp của bạn bị hỏng. Hãy xử lý bình tĩnh theo từng bước:

• Để cửa sổ chạy hết thời gian; một số đơn vị gửi thử lại theo lịch của riêng họ.
• Xác nhận dịch vụ có chấp nhận số ảo hay không. Các nền tảng có quy định định danh thật thường không chấp nhận, và cơ chế hoàn tiền tự động tồn tại chính vì trường hợp này.
• Quay lại sau một lúc, hoặc chạy cùng kịch bản qua tuyến của dịch vụ khác.
• Tránh đặt lại liên tục trong vòng lặp dày. Việc đó làm cạn giới hạn tốc độ và hiếm khi thay đổi kết quả.

Hướng dẫn của chúng tôi về giảm thiểu OTP gửi thất bại đi sâu hơn vào cách thiết kế cơ chế thử lại.

Tôi có thể giữ số +86 lâu dài không, và tính phí thế nào?

Không có dòng số dài hạn tự phục vụ cho Trung Quốc. Số chuyên dụng (Dedicated Numbers) là sản phẩm dành cho Hoa Kỳ và Canada, từ $1.95/month, có nhận SMS, gửi SMS và gọi điện ngay trên trình duyệt. Nếu đội của bạn cần một dòng số Trung Quốc lâu dài, hãy gửi email tới [email protected] để hỏi; khả năng cung cấp phụ thuộc vào quy định địa phương và không được cam kết.

Tiền nằm trong một ví USD trả trước duy nhất, không có phí hàng tháng và không phải chọn gói. Việc kiểm thử Trung Quốc trừ vào số dư này, bạn nạp bằng thẻ hoặc USDT/USDC và nhận hóa đơn PDF qua email sau mỗi lần nạp. Chi tiết nằm ở trang bảng giá, còn tổng quan về số ảo giải thích các dòng số Hoa Kỳ và Canada. Với công việc tích hợp, hãy yêu cầu chế độ sandbox: nó trả về số và mã mô phỏng để pipeline chạy thử mà không động đến tiền trong ví.

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

Tôi có thể kiểm thử luồng đăng ký WeChat hoặc Alibaba mà không cần SIM Trung Quốc không?

Bạn có thể đặt một số +86 cho dịch vụ đó qua OTP Route và đọc mã trong dashboard hoặc qua API. Một số nền tảng từ chối số ảo, khi đó lượt kích hoạt sẽ được hoàn tiền tự động.

Country id của Trung Quốc trong API OTP Route là gì?

Dùng cn ở mọi nơi cần country id, ví dụ trong GET /api/v1/prices?country=cn&service=<id>.

Tin nhắn xác minh của Trung Quốc có đến bằng tiếng Anh không?

Các đơn vị gửi trong nước thường viết bằng tiếng Trung giản thể, còn ứng dụng toàn cầu hay gửi tiếng Anh hoặc ngôn ngữ phù hợp với tài khoản. Hãy xây dựng việc trích xuất mã dựa trên chữ số, không dựa trên từ khóa.

Một lượt kích hoạt +86 mở trong bao lâu?

Hai mươi phút. Nếu không có SMS nào đến trước khi nó đóng, hoặc bạn hủy trước, toàn bộ số tiền sẽ được hoàn vào ví.

Số xác minh Trung Quốc có phù hợp để đăng nhập nhiều lần không?

Không. Mỗi lượt kích hoạt nhận một mã rồi kết thúc, nên nó phù hợp với kiểm thử đăng ký và onboarding hơn là các tài khoản phải xác thực lại vào tháng sau.

Những quy tắc nào áp dụng khi dùng số +86?

Hãy tuân thủ điều khoản của từng nền tảng cũng như Chính sách Sử dụng Chấp nhận được của OTP Route. Sản phẩm dành để kiểm thử luồng xác minh của chính bạn và vận hành tài khoản doanh nghiệp hợp pháp, không bao giờ dành cho việc đăng ký hàng loạt.

Một job CI có thể dùng số Trung Quốc mà không phải trả tiền không?

Theo yêu cầu, tài khoản phát triển có thể chuyển sang chế độ sandbox, trả về số và mã mô phỏng để các bài kiểm thử API xác minh SMS của bạn chạy trọn vẹn mà không tốn phí.

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.