Hướng dẫn cho nhà phát triển về mã xác minh Moldova (+373)

Một activation +373 trông như thế nào từ lúc yêu cầu đến lúc có mã?

Một activation là một đối tượng tồn tại ngắn với id, số điện thoại và trạng thái. Client của bạn xác thực tới https://otproute.com/api/v1 bằng khóa Bearer bắt đầu bằng or_live_, được tạo trong Developer console (tối đa 10 khóa mỗi tài khoản, 300 request mỗi phút).

Vòng đời cho Moldova diễn ra như sau. Tác vụ của bạn đọc GET /api/v1/prices?country=md&service=<id> để xác nhận tuyến đang mở và xem giá hôm nay. Sau đó nó gửi POST /api/v1/activations với {"service": "<id>", "country": "md"} và nhận activation id cùng một số +373. Bài test nhập số đó vào ứng dụng đích và kích hoạt SMS. Từ đó activation hoạt động trong 20 phút; nó kết thúc khi nhận được mã, khi bạn gọi POST /api/v1/activations/{id}/cancel, hoặc khi hết thời gian.

Service id và toàn bộ danh mục quốc gia lấy từ GET /api/v1/services và GET /api/v1/countries. Hãy lấy chúng khi khởi động thay vì ghi cứng, vì danh sách trực tiếp là nguồn đáng tin cậy. Hướng dẫn tích hợp API OTP trình bày một client hoàn chỉnh.

Client API OTP Moldova của tôi nên polling hay lắng nghe webhook?

Cả hai đều hoạt động với cùng một SMS verification API, và nhiều đội dùng cả hai: webhook để nhanh, polling làm lưới an toàn.

Webhook. Thêm một endpoint trong Developer console (một tài khoản có thể đăng ký năm endpoint) và xử lý activation.sms_received, activation.expired và activation.cancelled. Xác thực header X-OTPRoute-Signature, có dạng t=<unix>,v1=<hex>, bằng cách tính HMAC-SHA256 trên <t>.<raw body> với secret của endpoint và từ chối timestamp cũ. Hãy xử lý theo activation id để một lần gửi trùng không gây hại.

Polling. Gọi GET /api/v1/activations/{id} mỗi vài giây với cơ chế giãn dần, và dừng khi trạng thái đã cuối cùng. Cách này phù hợp với các runner CI sau tường lửa không nhận được request đến. Bài viết của chúng tôi về kiểm thử SMS OTP trong pipeline CI đề cập timeout và thử lại cho cả hai mô hình.

Số điện thoại Moldova khác biệt gì khi xử lý?

Số quốc nội của Moldova có tám chữ số sau mã quốc gia +373, và quay số trong nước thêm tiền tố trung kế 0 ở phía trước. Vì vậy người dùng gõ cùng một số di động theo nhiều dạng: có 0 đứng đầu, với +373, hoặc với 00373. Hãy chuẩn hóa bằng cách bỏ khoảng trắng và dấu gạch ngang, bỏ số 0 nội địa khi thêm mã quốc gia, và lưu dạng E.164. Một bộ kiểm tra bắt buộc có số không đứng đầu sẽ từ chối dữ liệu quốc tế đúng định dạng, đây là một trong những điều đầu tiên mà một số +373 để thử nghiệm thường làm lộ ra.

Tiếng Romania là ngôn ngữ chính thức, và tiếng Nga được nói rộng rãi, nên tin nhắn xác minh từ các dịch vụ địa phương có thể đến bằng một trong hai thứ tiếng, hoặc bằng tiếng Anh từ các ứng dụng toàn cầu. Tin nhắn Cyrillic được gửi bằng bảng mã rộng hơn và tách đoạn khác với văn bản Latin, điều đáng được bao quát trong mọi bộ phân tích trích xuất mã.

Các đội test ở Moldova khi họ bản địa hóa ứng dụng sang tiếng Romania hoặc tiếng Nga, phục vụ khách hàng trong khu vực, hoặc có nhân viên hỗ trợ và kỹ thuật tại Chișinău cần kiểm tra các bước xác minh của chính họ.

Hiện những ứng dụng nào định tuyến mã tới Moldova?

OTP Route liệt kê hơn 1,700 dịch vụ cho Moldova. Bản chụp hiện tại của các dịch vụ phổ biến gồm Telegram, Viber, WhatsApp, Signal, Facebook, Instagram, TikTok, Google (Gmail & YouTube), LinkedIn, Snapchat, Amazon, eBay, Netflix và Claude.

Hãy coi đây là bức tranh luôn thay đổi. Kho số dao động trong ngày, vì vậy hãy yêu cầu danh sách trực tiếp trước mỗi lượt chạy, và chuẩn bị sẵn một tuyến dự phòng cho các dịch vụ thất thường. Bài viết về định tuyến theo quốc gia giải thích cách OTP routing sang một quốc gia dự phòng hoạt động mà không phải đổi logic kiểm thử.

Vì sao mã Moldova có thể không xuất hiện?

Một dịch vụ có thể từ chối thẳng số ảo, giới hạn các lần thử lặp lại, hoặc gửi chậm trên một tuyến nhất định. Không điều nào làm bạn tốn tiền, vì mã không tới trong khung 20 phút nghĩa là được hoàn tiền đầy đủ và tự động vào ví.

Các bước thực tế khi điều đó xảy ra:

• Chờ hết khung thời gian thay vì hủy ngay ở lần im lặng đầu tiên.
• Xác nhận ngay từ đầu rằng dịch vụ chấp nhận số ảo.
• Thử lại sau, hoặc chuyển sang quốc gia khác mà dịch vụ hỗ trợ.
• Giãn cách các đơn lặp lại; bắn activation mới liên tục trong vòng lặp nhanh chỉ phản tác dụng.
• Ghi lại activation id cùng nhật ký ứng dụng để bạn so sánh các lượt chạy thất bại và thành công.

Người không biết code đặt số Moldova thế nào?

Hãy tạo tài khoản tại trang đăng ký bằng email và mã email 6 chữ số, hoặc đăng nhập Google. Trong OTP Gateway, chọn dịch vụ, chọn Moldova, xem giá trực tiếp rồi xác nhận. Dán số +373 vào ứng dụng bạn đang xác minh; mã hiện trên dashboard ngay khi nhận được. Bạn có thể hủy từ cùng màn hình và số tiền quay thẳng về ví.

Còn đường dây dài hạn, sandbox và thanh toán thì sao?

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

Thanh toán là trả theo mức dùng từ một ví USD duy nhất, không đăng ký và không phân bậc. Nạp tiền bằng thẻ hoặc USDT/USDC và nhận hóa đơn PDF qua email cho mỗi lần nạp. Nhà phát triển muốn diễn tập tích hợp trước có thể yêu cầu chuyển tài khoản sang sandbox, nơi số và mã được mô phỏng và ví không bị động đến.

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

Tôi có thể nhận SMS OTP Moldova mà không sống ở đó không?

Có. OTP Gateway cấp một số +373 bạn dùng được từ bất cứ đâu, và mã hiện trên dashboard hoặc được gửi tới client API của bạn.

Code của tôi nên gửi country id nào cho Moldova?

Hãy gửi md làm giá trị country. Service id lấy từ GET /api/v1/services.

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

Không. Hãy lưu theo E.164 là +373 cộng tám chữ số quốc nội, bỏ tiền tố trung kế nội địa.

Chuyện gì xảy ra nếu tôi hủy một activation Moldova?

Gọi POST /api/v1/activations/{id}/cancel trước khi có mã sẽ đóng activation và hoàn toàn bộ số tiền vào ví của bạn.

Có số xác minh Moldova nào tôi giữ được vài tháng không?

Không phải dạng tự phục vụ. Dedicated Numbers dài hạn là sản phẩm của Mỹ và Canada; hãy gửi email cho bộ phận hỗ trợ để hỏi về Moldova.

Tôi có thể dùng OTP Route để tạo nhiều tài khoản trên một ứng dụng không?

Không. Nó dành để kiểm thử và vận hành sản phẩm và tài khoản hợp pháp của chính bạn, trong phạm vi đ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.

Bộ test của tôi có thể chạy với Moldova mà không tốn tiền không?

Có, nếu bạn yêu cầu chế độ sandbox cho tài khoản phát triển. Nó trả về số và mã mô phỏng cho các bài test đầu 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.