Đưa mã xác minh Chad (+235) vào hệ thống của bạn

Trình tự gọi cho một request API OTP Chad là gì?

Các request cho Chad đến cùng một base URL như mọi thị trường khác, https://otproute.com/api/v1, được ký bằng một Bearer key or_live_. Bạn tạo key trong Developer console; một tài khoản có thể giữ tối đa 10 key và gửi 300 request mỗi phút.

Một lượt chạy Chad điển hình gồm bốn lệnh gọi:

1. GET /api/v1/countries và GET /api/v1/services để xác nhận td có trong danh sách và tra id dịch vụ mà bài kiểm thử của bạn nhắm tới.
2. GET /api/v1/prices?country=td&service=<id> để đọc giá trực tiếp cho cặp đó trước khi tốn bất cứ khoản nào.
3. POST /api/v1/activations với body như {"service": "telegram", "country": "td"}. Phản hồi chứa một activation id và số +235 để nhập vào ứng dụng đang kiểm thử.
4. Chờ mã, rồi hoặc để activation hoàn tất hoặc gọi POST /api/v1/activations/{id}/cancel nếu bài kiểm thử bị hủy sớm.

Nên gọi GET /api/v1/balance ở đầu một tác vụ CI để pipeline báo lỗi rõ ràng khi ví trống thay vì hết thời gian giữa chừng. Tài liệu tham chiếu đầy đủ nằm trong tài liệu dành cho lập trình viên.

Bộ nhận webhook nên xử lý mã +235 như thế nào?

Polling GET /api/v1/activations/{id} vài giây một lần là đủ cho một script đơn lẻ. Khi nhiều trình chạy kiểm thử dùng chung một key, webhook gọn gàng hơn. Đăng ký một endpoint (năm endpoint cho mỗi tài khoản) và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled.

Mỗi request có header X-OTPRoute-Signature dạng t=<unix>,v1=<hex>. Hãy dựng lại chuỗi <t>.<raw body>, ký bằng HMAC-SHA256 với secret của endpoint, và so sánh với v1 theo thời gian không đổi. Từ chối mọi thứ có timestamp cũ; việc đó chặn các request bị phát lại. Hướng dẫn của chúng tôi về bảo mật webhook OTP bằng HMAC trình bày điều này bằng nhiều ngôn ngữ.

Hãy coi activation id là khóa idempotency. Nếu cùng một sự kiện được gửi hai lần, lần ghi thứ hai không được thay đổi gì, và trình xử lý của bạn nên trả về 2xx nhanh rồi mới làm các việc chậm sau đó.

Những ứng dụng nào có thể gửi mã đến một số xác minh Chad?

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

Tình trạng khả dụng không cố định. Các tuyến mở và đóng trong ngày khi các đối tác nhà mạng thay đổi dung lượng, nên một dịch vụ thấy được sáng nay có thể biến mất chiều nay. Hãy đọc danh mục tại thời điểm chạy thay vì gán cứng, và giữ một dịch vụ thứ hai trong kế hoạch kiểm thử phòng khi dịch vụ đầu tạm thời không khả dụng cho Chad.

Tôi lưu trữ và chuẩn hóa một số +235 như thế nào?

Chad dùng kế hoạch đánh số đóng: số quốc gia gồm tám chữ số và không có tiền tố trung kế để loại bỏ, nên dạng E.164 đơn giản là +235 theo sau tám chữ số đó. Điều đó khiến Chad là một trong những thị trường dễ kiểm tra nhất.

• Lưu toàn bộ chuỗi E.164 trong một cột duy nhất thay vì tách mã quốc gia và số thuê bao.
• Nếu biểu mẫu của bạn chấp nhận khoảng trắng hoặc kiểu nhóm theo cặp hai chữ số mà người dùng hay gõ, hãy bỏ chúng đi trước khi lưu.
• Khẳng định trong các bài kiểm thử rằng một giá trị có số 0 thừa ở đầu bị từ chối hoặc được làm sạch, vì người dùng từ các kế hoạch đánh số khác đôi khi thêm vào theo thói quen.

Tiếng Pháp và tiếng Ả Rập là các ngôn ngữ chính thức. Tuy nhiên, câu chữ của một tin SMS xác minh theo ngôn ngữ mà ứng dụng hoặc tài khoản được đặt, nên bộ kiểm thử bản địa hóa cần kiểm tra riêng các mẫu tiếng Pháp, tiếng Ả Rập và tiếng Anh.

Vì sao các nhóm sản phẩm chạy kiểm thử ở Chad?

Rất ít nhóm kỹ sư đặt trụ sở ở N'Djamena, đó chính là lý do một số +235 từ xa trở nên hữu ích. Những lý do phổ biến mà chúng tôi thấy:

• Ra mắt ở Trung Phi nói tiếng Pháp, nơi một sản phẩm đã chạy ở các thị trường lân cận thêm Chad vào bộ chọn quốc gia khi đăng ký và cần bằng chứng rằng luồng hoạt động.
• QA bản địa hóa tiếng Ả Rập và tiếng Pháp, bao gồm bố cục từ phải sang trái của màn hình nhập mã.
• Khách hàng kiều bào giữ số Chad khi sống ở nước ngoài, điều này ảnh hưởng đến cách quy tắc chống gian lận của bạn đọc mã quốc gia.
• Đội vận hành quản lý các tài khoản nhắn tin doanh nghiệp cho đối tác khu vực.

Mô hình rộng hơn được mô tả trong định tuyến theo quốc gia cho OTP.

Nếu mã Chad không bao giờ đến thì sao?

Một số im lặng thường là vấn đề về tuyến hoặc về việc chấp nhận, không phải lỗi trong code của bạn. Hãy xử lý theo thứ tự này:

• Cho cửa sổ 20 phút một cơ hội chạy hết; một số bên gửi gom tin nhắn theo lô.
• Kiểm tra dịch vụ đích có chấp nhận số ảo hay không. Một số thì không, đó là lý do có cơ chế hoàn tiền.
• Thử lại sau, hoặc với một dịch vụ khác trên cùng quốc gia, thay vì đặt lại liên tục trong vòng lặp dày. Thử lại nhanh có thể chạm giới hạn tốc độ của chính bên gửi.
• Xác nhận trình xử lý của bạn đã kiểm tra chữ ký đúng; một webhook bị từ chối trông giống như thiếu mã.

Nếu cửa sổ đóng hoặc bạn hủy, toàn bộ số tiền quay về ví mà không cần phiếu hỗ trợ. Thêm các cách xử lý có trong bài giảm số lần gửi OTP thất bại.

Có đường dây Chad dùng lâu dài không, và tính phí ra sao?

Không có số dùng lâu dài tự phục vụ cho Chad. Dedicated Numbers là sản phẩm của Hoa Kỳ và Canada, từ $1.95/tháng, với SMS chiều đến và chiều đi cùng gọi điện trên trình duyệt. Nếu bạn cần một đường dây +235 bền vững, hãy gửi email đến [email protected]; khả năng đáp ứng phụ thuộc vào quy định địa phương và chúng tôi không thể hứa trước.

Phí cho các mã +235 được trừ từ một số dư USD trả trước duy nhất; không có bậc đăng ký và không có phí hằng tháng. Bạn nạp tiền bằng thẻ hoặc stablecoin USDT/USDC, và một hóa đơn PDF về hộp thư của bạn sau mỗi lần nạp. Mức giá hiện hành hiển thị trên trang bảng giá. Với công việc tích hợp, hãy yêu cầu chuyển sang sandbox: nó trả về số và mã mô phỏng để bạn diễn tập luồng mà không đụng đến tiền trong ví. Mở một tài khoản mới chỉ cần mã email sáu chữ số, hoặc đăng nhập Google nếu nhóm bạn thích hơn.

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

Id quốc gia của Chad trong API OTP Route là gì?

Hãy dùng td trong trường country của POST /api/v1/activations và trong truy vấn giá.

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

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

Một số +235 dùng được trong bao lâu?

Một activation mở trong 20 phút và bao gồm một mã duy nhất. Sau đó, hãy đặt một số mới.

Tôi có phải trả tiền khi SMS không bao giờ đến không?

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

Số Chad có cần bỏ tiền tố trung kế không?

Không. Chad không có tiền tố trung kế, nên dạng lưu trữ là +235 cộng số quốc gia tám chữ số.

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

Không qua tự phục vụ. Dedicated Numbers dùng lâu dài chỉ có ở Mỹ và Canada; với Chad, hãy gửi email cho nhóm để hỏi những gì có thể làm.

Có quy tắc sử dụng nào không?

Có. 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; gateway dành cho việc kiểm thử và vận hành các sản phẩm và tài khoản hợp pháp của chính bạn.

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.