Kiểm thử luồng xác minh +27: danh sách kiểm tra cho các đợt ra mắt tại Nam Phi

Trước lần đặt số +27 đầu tiên: danh sách sẵn sàng ngắn gọn

Hãy đánh dấu từng mục này và lần kích hoạt Nam Phi đầu tiên của bạn sẽ diễn ra suôn sẻ, không có bất ngờ:

1. Đã nạp ví. Một ví USD trả trước chi trả cho mọi thứ; nạp bằng thẻ hoặc USDT/USDC. Không có gói đăng ký nào.
2. Đã tạo khóa. Tạo khóa Bearer trong Developer console (bắt đầu bằng or_live_). Dùng khóa riêng cho CI và cho staging, tối đa 10 khóa.
3. Đã đăng ký webhook. Thêm một endpoint HTTPS và lưu lại secret ký của nó. Bạn có thể đăng ký tối đa năm endpoint.
4. Đã kiểm thử bộ chuẩn hóa số. Đưa vào dữ liệu kiểu 082 123 4567 và xác nhận nó cho ra +2782... với số 0 đầu đã được bỏ.
5. Đã xác nhận service id. Lấy danh mục từ GET /api/v1/services thay vì đoán id.
6. Sandbox là tùy chọn. Bộ phận hỗ trợ có thể chuyển một tài khoản phát triển sang sandbox để số và mã mô phỏng chạy qua mã của bạn trước khi tốn tiền thật.

Hướng dẫn kiểm thử trong CI chỉ cách ghép các mảnh này vào một pipeline.

Số điện thoại Nam Phi nên được lưu và chuẩn hóa như thế nào?

Nam Phi dùng tiền tố trung kế 0. Một số di động viết theo kiểu trong nước có mười chữ số, chẳng hạn 082 123 4567, và các dải số di động ở dạng quốc gia này thường bắt đầu bằng 06, 07 hoặc 08. Ở định dạng quốc tế, số 0 biến mất: cùng đường dây đó trở thành +27 82 123 4567, hoặc +27821234567 khi bỏ dấu cách, tức là chín chữ số sau mã quốc gia.

Lỗi kinh điển là giá trị lưu như +270821234567, xảy ra khi một biểu mẫu ghép mã quốc gia vào số nội địa mà không bỏ số 0. Hãy chuẩn hóa khi nhập, chỉ lưu E.164, và chỉ dùng định dạng nội địa có dấu cách để hiển thị. Nếu bạn tự gửi SMS đi, cùng quy tắc đó giữ cho báo cáo gửi và tra cứu người dùng nhất quán.

Những dịch vụ nào có thể gửi mã tới số xác minh Nam Phi?

Các tuyến phổ biến cho za hiện nay gồm WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Uber, Telegram, Microsoft & Outlook, LinkedIn, Netflix, Amazon, X (Twitter), ChatGPT (OpenAI) và Discord. Trên toàn danh mục, quốc gia này hỗ trợ hơn 1.700 dịch vụ, và vì kho số thay đổi trong ngày, API là nơi để đọc tình trạng khả dụng hiện tại.

Vì sao các nhóm chọn thị trường này? Johannesburg và Cape Town là những trung tâm công nghệ và tài chính lâu đời, và nhiều công ty dùng Nam Phi làm cơ sở cho một đợt triển khai rộng hơn tại Nam Phi châu. Quốc gia này có nhiều ngôn ngữ chính thức, trong đó có tiếng Anh, isiZulu, isiXhosa và Afrikaans, nhưng phần lớn tin nhắn xác minh đến bằng tiếng Anh, nên QA bản địa hóa thường tập trung vào các màn hình xung quanh hơn là nội dung SMS.

Các bước: gọi API OTP Nam Phi từ bộ kiểm thử của bạn

Các yêu cầu gửi tới https://otproute.com/api/v1 kèm khóa Bearer của bạn, tối đa 300 mỗi phút.

1. GET /api/v1/prices?country=za&service=<id> trả về giá hiện tại cho cặp dịch vụ bạn muốn.
2. POST /api/v1/activations với {"service": "<id>", "country": "za"} giữ một số +27 và trả về activation id.
3. Bài kiểm thử của bạn nhập số vào ứng dụng và kích hoạt SMS.
4. Sự kiện activation.sms_received đến webhook của bạn. Trước khi tin nó, hãy dựng lại HMAC-SHA256 của <t>.<raw body> bằng secret của endpoint, so sánh với v1 trong X-OTPRoute-Signature, và loại bỏ các yêu cầu có timestamp quá cũ.
5. Thích polling hơn? Hãy đọc GET /api/v1/activations/{id} theo khoảng cách vừa phải.
6. Các lượt chạy bị bỏ dở nên gọi POST /api/v1/activations/{id}/cancel, và GET /api/v1/balance cho phép một job dừng sớm khi số dư thấp.

Thêm về các lựa chọn định tuyến có trong định tuyến OTP theo quốc gia.

Các bước dành cho nhân viên vận hành dùng bảng điều khiển

Không cần viết mã: mở OTP Gateway, chọn Nam Phi và dịch vụ, xem giá hiển thị, xác nhận rồi dán số +27 vào ứng dụng. SMS hiện trên trang kích hoạt khi nó đến, còn khoảng thời gian 20 phút và việc hoàn tiền tự động hoạt động y như khi dùng API.

Khắc phục sự cố mã Nam Phi bị kẹt

Trước hết là phần tiền: nếu không có SMS nào đến trong 20 phút, hoặc bạn hủy, toàn bộ số tiền được hoàn lại vào ví tự động. Sau đó hãy chẩn đoán:

• Kiên nhẫn trước. Tốc độ gửi phụ thuộc vào dịch vụ và tuyến, nên hãy để kích hoạt chạy hết.
• Chính sách chấp nhận. Một số dịch vụ từ chối số ảo; trong trường hợp đó việc hoàn tiền là hành vi bình thường, không phải lỗi.
• Thời điểm hoặc tuyến khác. Thử lại sau, hoặc dùng một tuyến lân cận như Namibia hay Botswana khi ca kiểm thử cho phép.
• Không dồn dập. Hủy rồi đặt lại liên tục trong một vòng lặp hiếm khi có tác dụng và chỉ làm hao giới hạn tốc độ của bạn.

Chỉ dùng số để kiểm thử sản phẩm của chính bạn hoặc vận hành các tài khoản doanh nghiệp của chính bạn, tôn trọng điều khoản của từng dịch vụ, và nhớ rằng Chính sách Sử dụng Chấp nhận được của OTP Route có hiệu lực.

Đường dây Nam Phi dài hạn và mô hình thanh toán

Không có số +27 dài hạn tự phục vụ. Dedicated Number, từ $1.95/month, chỉ được cung cấp tại Hoa Kỳ và Canada; các nhóm cần một đường dây Nam Phi cố định có thể gửi email tới [email protected], và việc có thực hiện được hay không phụ thuộc vào quy định địa phương. Thanh toán theo mức dùng từ ví trả trước, với hóa đơn PDF được gửi qua email cho mỗi lần nạp. Xem bảng giá để biết bức tranh đầy đủ.

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

Tôi có thể kiểm thử luồng đăng ký Nam Phi của ứng dụng mà không cần SIM địa phương không?

Có. Đặt một số +27 qua OTP Gateway và đọc mã trong bảng điều khiển hoặc qua API. Giá từ $0.20 mỗi mã, và chỉ khi mã đến.

Tôi có giữ lại số 0 ở đầu khi chuyển số Nam Phi sang E.164 không?

Không. Bỏ số 0 trung kế và thêm tiền tố +27, nên 082 123 4567 trở thành +27821234567.

Country id của Nam Phi trong API là gì?

Là za, dùng trong truy vấn giá và trong phần thân JSON khi bạn tạo một kích hoạt +27.

Tin nhắn xác minh Nam Phi dùng ngôn ngữ nào?

Chủ yếu là tiếng Anh, dù đất nước có nhiều ngôn ngữ chính thức. Cách diễn đạt do dịch vụ gửi quyết định.

Có được hoàn tiền nếu mã không bao giờ được gửi tới không?

Có. Kích hoạt mở trong 20 phút, và nếu không có gì đến hoặc bạn hủy, toàn bộ số tiền được hoàn vào ví tự động.

Tôi có thể mua một số Nam Phi để giữ nhiều tháng không?

Không tự phục vụ. Dedicated Number là sản phẩm của Hoa Kỳ và Canada; với Nam Phi, hãy gửi email cho bộ phận hỗ trợ để hỏi, không có cam kết về khả năng đáp ứng.

Tôi có thể xác minh bao nhiêu dịch vụ bằng số +27 trên OTP Route?

Hơn 1.700 dịch vụ theo bản chụp mới nhất. Hãy kiểm tra danh mục trực tiếp qua API, vì tình trạng khả dụng thay đổi trong ngày.

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.