Kiểm thử luồng đăng ký +236 khi không ai trong nhóm có SIM Trung Phi

Vì sao bước xác minh +236 khó tái hiện từ nước ngoài đến vậy?

Tình huống thường gặp là thế này: một sản phẩm ra mắt ở Trung Phi nói tiếng Pháp, ai đó báo lỗi rằng mã dùng một lần không bao giờ hiện cho người dùng ở Bangui, và kỹ sư được giao không có cách nào nhập một số Trung Phi vào biểu mẫu. SIM chuyển vùng mất thời gian mới có được, đồng nghiệp tại chỗ bận việc thật, và trình giả lập không thể tạo ra một tin SMS nhà mạng thực sự.

Một dịch vụ OTP routing như OTP Route lấp khoảng trống đó, và API OTP Cộng hòa Trung Phi của nó chính là API dùng cho mọi quốc gia khác. Thay vì vận chuyển phần cứng đi khắp nơi, bạn yêu cầu một đường dây +236 qua một lệnh gọi API, nhập nó vào màn hình đăng ký của chính bạn, và đọc mã trở lại bằng chương trình. Cùng một request hoạt động trong phiên làm việc trên laptop, một tác vụ hồi quy hằng đêm hay một tab trình duyệt của kỹ sư hỗ trợ, khiến một thị trường khó tiếp cận trở thành một dòng như bao dòng khác trong ma trận kiểm thử của bạn.

Hiện nay những dịch vụ nào có thể nhận mã SMS Cộng hòa Trung Phi?

Ảnh chụp trực tiếp cho cf liệt kê hơn 900 dịch vụ. Các tuyến phổ biến gồm WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, imo, Signal, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI) và Uber.

Tình trạng khả dụng thay đổi trong ngày khi các đối tác nhà mạng xoay vòng danh mục, vì vậy hãy coi mọi danh sách trên trang web là điểm khởi đầu chứ không phải lời hứa. Trước mỗi lượt chạy, hãy hỏi GET /api/v1/prices?country=cf&service=<id> để biết giá hiện tại và tuyến có đang mở hay không. Một số ứng dụng trong danh mục cũng từ chối hoàn toàn các đường dây ảo; đó là quyết định của ứng dụng chứ không phải của mạng, và chính là lý do các đơn không có phản hồi được hoàn tiền.

Backend yêu cầu một số +236 để kiểm thử như thế nào?

Mọi thứ nằm dưới https://otproute.com/api/v1 và xác thực bằng một Bearer key có tiền tố or_live_, cấp trong Developer console. Một phiên API xác minh SMS tối giản diễn ra như sau:

1. Tra các định danh một lần bằng GET /api/v1/services và GET /api/v1/countries; Cộng hòa Trung Phi là cf.
2. Xác nhận giá và tình trạng khả dụng bằng GET /api/v1/prices.
3. Tạo đơn bằng POST /api/v1/activations với body như {"service": "viber", "country": "cf"}.
4. Nhập số +236 được trả về vào màn hình đang kiểm thử.
5. Nhận mã qua webhook activation.sms_received, hoặc polling GET /api/v1/activations/{id} vài giây một lần.
6. Nếu bài kiểm thử bị hủy, hãy giải phóng đường dây bằng POST /api/v1/activations/{id}/cancel.

Các lệnh gọi webhook mang X-OTPRoute-Signature: t=<unix>,v1=<hex>. Bộ nhận của bạn nên dựng lại HMAC-SHA256 của <t>.<raw body> bằng secret của endpoint đó, so khớp với v1 theo thời gian không đổi và loại bỏ mọi lần gửi có timestamp cũ. Hướng dẫn thu mã bằng webhook trình bày một trình xử lý hoàn chỉnh, và tài liệu tham chiếu nằm trong tài liệu API.

Chúng ta nên biết gì về số điện thoại Trung Phi và ngôn ngữ tin nhắn?

Số điện thoại ở Cộng hòa Trung Phi theo kế hoạch đánh số đóng gồm tám chữ số và không có tiền tố trung kế, nên dạng trong nước và dạng quốc tế chỉ khác nhau ở mã quốc gia. Hãy lưu mọi giá trị theo E.164, ví dụ +236 theo sau tám chữ số nội hạt, và bỏ khoảng trắng hoặc dấu gạch ngang khi nhập. Việc kiểm tra bắt buộc số 0 ở đầu, hoặc mười chữ số, sẽ âm thầm từ chối người dùng thật.

Tiếng Pháp và Sango là các ngôn ngữ chính thức. Hầu hết ứng dụng quốc tế gửi tin xác minh bằng tiếng Pháp hoặc tiếng Anh tùy theo locale của tài khoản, vì vậy hãy làm trình phân tích của bạn tìm các chữ số thay vì một câu cụ thể. Các nhóm thường kiểm thử ở đây khi mở rộng triển khai ở Tây hoặc Trung Phi, chạy công cụ cho NGO và vận hành hiện trường, hoặc hỗ trợ khách hàng có người thân trong khu vực.

Người không phải lập trình viên có thể lấy số xác minh Cộng hòa Trung Phi không?

Có. Product manager, trưởng nhóm hỗ trợ và nhân viên agency có thể làm toàn bộ từ trình duyệt:

• Tạo tài khoản bằng mã qua email hoặc đăng nhập Google, và bật xác thực hai yếu tố TOTP.
• Mở OTP Gateway, chọn dịch vụ và chọn Cộng hòa Trung Phi.
• Kiểm tra giá trực tiếp hiển thị trước khi đặt, rồi xác nhận.
• Dán số +236 vào ứng dụng và chờ mã xuất hiện trên màn hình.

Activation mở trong 20 phút. Bạn chỉ trả tiền nếu có mã đến; hủy hoặc để cửa sổ đóng thì toàn bộ số tiền quay về ví.

Nếu mã không bao giờ hiện trên đường dây +236 thì sao?

Một số im lặng thường có nghĩa là ứng dụng đã giới hạn request, từ chối đường dây ảo, hoặc tuyến đang bận. Hãy xử lý bình tĩnh:

• Để cửa sổ chạy trọn vẹn trước khi kết luận là thất bại; một số bên gửi xếp hàng tin nhắn.
• Hủy rồi thử lại sau, hoặc chuyển sang tuyến khác cho cùng dịch vụ nếu có.
• Kiểm tra xem dịch vụ có được biết là từ chối số ảo hay không; nếu có, thử lại cũng vô ích.
• Tránh đặt lại liên tục trong vòng lặp dày. Các lần thử lặp lại có thể kích hoạt giới hạn tốc độ ở phía ứng dụng lẫn phía chúng tôi (300 request mỗi phút cho mỗi tài khoản).

Thêm các mẫu xử lý có trong bài giảm số lần gửi OTP thất bại.

Có đường dây +236 dùng lâu dài không, và việc sử dụng được tính phí ra sao?

Không. Dedicated Numbers tự phục vụ chỉ có ở Hoa Kỳ và Canada, từ $1.95/tháng, nên không có đường dây Trung Phi cố định nào để mua trong dashboard. Nếu một dự án thực sự cần, hãy gửi email đến [email protected]; việc có sắp xếp được hay không phụ thuộc vào quy định địa phương và chúng tôi không thể hứa trước.

Thanh toán cho OTP Gateway chạy từ một ví USD trả trước duy nhất, không có phí hằng tháng. Bạn nạp tiền bằng thẻ hoặc stablecoin USDT/USDC, và mỗi lần nạp kích hoạt một hóa đơn PDF gửi qua email. Lập trình viên muốn diễn tập một tích hợp mà không tốn tiền có thể yêu cầu chế độ sandbox, trả về số và mã mô phỏng. Mức giá đầy đủ có trên trang bảng giá. Xin hãy tuân thủ điều khoản của từng ứng dụng; Chính sách sử dụng chấp nhận được của OTP Route bao quát mọi đơn.

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

Tôi có thể nhận mã SMS OTP Cộng hòa Trung Phi mà không cần SIM địa phương không?

Có. Hãy đặt một số +236 từ OTP Gateway, nhập nó vào ứng dụng của bạn và đọc mã từ dashboard, một webhook hoặc endpoint activations.

Id quốc gia của Cộng hòa Trung Phi trong API là gì?

Là cf. Hãy dùng nó trong truy vấn giá và trong body của activation.

Một số +236 để kiểm thử có giá bao nhiêu?

Mã bắt đầu từ $0.20 mỗi mã, và mức chính xác tùy thuộc vào dịch vụ. Mức giá hiện tại của một tuyến +236 hiển thị trong dashboard và trong endpoint giá trước khi đặt.

Đơn +236 có bị tính phí nếu tin nhắn xác minh không đến không?

Không. Nếu không có tin nhắn nào đến trong cửa sổ 20 phút, hoặc bạn hủy trước, toàn bộ số tiền được hoàn về ví của bạn tự động.

Tôi có nên lưu số Trung Phi kèm số 0 đứng đầu không?

Không. Kế hoạch đánh số không có tiền tố trung kế, nên hãy giữ dạng E.164 với +236 và tám chữ số nội hạt.

Tôi có thể giữ cùng một số +236 cho các lần đăng nhập sau không?

Không qua tự phục vụ. Mỗi số OTP Gateway chỉ dùng cho một mã, và các đường dây dùng lâu dài là sản phẩm của Mỹ và Canada; bạn có thể gửi email cho bộ phận hỗ trợ để hỏi về các lựa chọn khác.

Có cách nào để kiểm thử tích hợp mà không phải trả tiền không?

Có. Theo yêu cầu, một tài khoản phát triển có thể chuyển sang sandbox, mô phỏng số và mã từ đầu đến cuối.

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.