API xác minh SMS Nigeria (+234) cho đội QA, fintech và đội mở thị trường

Tôi cần gọi những endpoint nào để nhận OTP Nigeria?

Mọi thứ nằm dưới https://otproute.com/api/v1 và xác thực bằng khóa Bearer bắt đầu bằng or_live_. Mã quốc gia (country id) của Nigeria là ng. Một tích hợp điển hình thực hiện bốn lệnh gọi:

1. GET /api/v1/prices?country=ng&service=<id> để xác nhận giá hiện tại trước khi đặt.
2. POST /api/v1/activations với {"service": "<id>", "country": "ng"} để giữ một số +234. Hãy lưu lại activation id được trả về; mọi lệnh gọi và sự kiện webhook sau đó đều gắn với id này.
3. GET /api/v1/activations/{id} để đọc trạng thái và, khi đã nhận được, đọc mã.
4. POST /api/v1/activations/{id}/cancel nếu bài test của bạn lỗi ở khâu trước và bạn không cần số đó nữa.

GET /api/v1/balance rất tiện làm bước kiểm tra trước trong CI để bộ test chạy đêm báo lỗi sớm khi ví sắp hết tiền. Bài hướng dẫn tích hợp API OTP trình bày cùng trình tự này kèm cách xử lý lỗi.

Bộ test ở Lagos nên dùng polling hay webhook?

Polling ổn với vài lần chạy thủ công. Khi pipeline đặt nhiều số +234 song song, webhook gọn hơn. Hãy đăng ký một trong năm endpoint của bạn trong Developer console và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled.

Mỗi request mang header X-OTPRoute-Signature: t=<unix>,v1=<hex>. Hãy tính lại HMAC-SHA256 trên timestamp, một dấu chấm và phần raw body bằng secret của endpoint, so sánh theo thời gian hằng số, và loại bỏ request nếu timestamp đã cũ. Lưu các activation id đã xử lý để một sự kiện bị gửi lại không kích hoạt bài test của bạn hai lần. Bài viết về bảo mật webhook OTP bằng HMAC có danh sách kiểm tra đầy đủ hơn. Hãy giữ tổng lưu lượng dưới 300 request mỗi phút cho mỗi tài khoản, mức này khá rộng rãi nếu bạn dựa vào sự kiện thay vì polling dày đặc.

Các tuyến +234 hiện hỗ trợ những dịch vụ nào?

Tuyến ng hiện liệt kê hơn 2.700 dịch vụ. Những dịch vụ được yêu cầu thường xuyên gồm WhatsApp, Telegram, Google (Gmail & YouTube), TikTok, Facebook, Instagram, X (Twitter), Snapchat, LinkedIn, Uber, Discord, Microsoft & Outlook, Amazon và ChatGPT (OpenAI). Nguồn cung thay đổi trong ngày khi các đối tác nhà mạng của chúng tôi cập nhật, vì vậy hãy truy vấn tình trạng thực tế thay vì cho rằng dịch vụ bạn thấy hôm qua vẫn còn.

Vì sao các đội cần số xác minh Nigeria ngay từ đầu?

Nigeria là một trong những thị trường fintech và ứng dụng tiêu dùng sôi động nhất châu Phi, và nhiều sản phẩm coi số điện thoại là danh tính chính. Điều đó khiến bước SMS trở thành phần quan trọng trong quá trình onboarding của ví điện tử, ứng dụng cho vay, gọi xe, giao hàng và mạng xã hội. Các đội ở ngoài quốc gia này dùng số +234 để test nhằm xác nhận luồng đăng ký, bộ đếm gửi lại và nội dung thông báo lỗi hoạt động như với người dùng tại chỗ.

Tiếng Anh là ngôn ngữ chính thức nên tin nhắn xác minh thường đến bằng tiếng Anh, giúp logic kiểm tra trong test tự động đơn giản hơn. Riêng các đội fintech nên xem trang onboarding fintech để biết cách nó kết hợp với các bước xác minh danh tính mà OTP Route không thay thế.

Số di động Nigeria được định dạng như thế nào?

Mã quốc gia là +234 và tiền tố trunk là 0. Người Nigeria thường viết số di động gồm mười một chữ số bắt đầu bằng số không, chẳng hạn 0803 123 4567; ở dạng quốc tế, số không biến mất và ta có +234 803 123 4567. Hãy lưu giá trị E.164 (+234803...), chấp nhận định dạng mười một chữ số nội địa khi nhập, và bỏ số 0 đứng đầu trước khi lưu. Một bộ kiểm tra chỉ xét tổng độ dài sẽ vui vẻ chấp nhận +2340803..., vốn là nguyên nhân thường gặp khiến việc gửi tin thất bại trên môi trường production.

Tôi có thể đặt số Nigeria từ dashboard không?

Có. Đăng ký bằng mã gửi qua email hoặc Google, nạp tiền vào ví, mở OTP Gateway, chọn Nigeria và dịch vụ, rồi xác nhận mức giá hiển thị. Số sẵn sàng ngay lập tức và mã xuất hiện cạnh đơn hàng khi tin nhắn đến.

Nếu mã không đến, hãy để cửa sổ 20 phút chạy hết; bạn chỉ trả tiền khi mã đến, và các đơn hết hạn hoặc bị hủy sẽ được hoàn tiền tự động. Sau đó hãy thử đặt đơn mới một lúc sau, thử một tuyến khác như Ghana nếu bài test cho phép, và kiểm tra xem dịch vụ có từ chối số ảo hay không. Đừng đặt đơn mới liên tục trong vòng lặp dày đặc.

Còn số dùng lâu dài ở Nigeria, thanh toán và sandbox thì sao?

OTP Route không có số Nigeria dài hạn tự phục vụ. Dedicated Numbers chỉ được bán cho Hoa Kỳ và Canada, từ $1.95/tháng. Nếu cần một đường dây +234 lâu dài, hãy gửi email tới [email protected]; việc có cung cấp được hay không phụ thuộc vào quy định địa phương.

Chi phí được trừ từ một ví USD trả trước duy nhất, không có gói hay phí hằng tháng. Nạp tiền bằng thẻ hoặc USDT/USDC và nhận hóa đơn PDF cho mỗi lần nạp. Hãy nhờ bộ phận hỗ trợ chuyển tài khoản phát triển sang chế độ sandbox và tích hợp của bạn sẽ nhận số và mã mô phỏng, nhờ đó bạn có thể test toàn bộ đường đi của webhook mà không tốn tiền trong ví.

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

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

Được. Đặt một số +234 từ OTP Gateway và đọc mã trong dashboard hoặc qua API.

Country id của Nigeria trong API OTP Route là gì?

Hãy dùng ng làm giá trị country khi tra giá và khi tạo yêu cầu kích hoạt.

Nhận một OTP SMS Nigeria tốn bao nhiêu?

Từ $0.20 mỗi mã, mức chính xác phụ thuộc vào dịch vụ và được endpoint giá trả về.

Nếu không có SMS đến thì tôi có bị trừ tiền không?

Không. Nếu không có gì đến trong 20 phút, hoặc bạn hủy, toàn bộ số tiền sẽ quay lại ví.

Tôi nên lưu số như 0803 123 4567 thế nào?

Bỏ số 0 đứng đầu và lưu thành +2348031234567, tức dạng E.164 không có khoảng trắng.

Tôi có được dùng các số này cho mọi tài khoản không?

Chỉ dùng cho sản phẩm và tài khoản hợp pháp của chính bạn. Hãy 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 OTP Route; một số dịch vụ từ chối hẳn số ảo.

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.