Mã xác minh Monaco (+377) cho đội sản phẩm và QA

Vì sao các đội lại thử nghiệm bằng số Monaco?

Monaco rất nhỏ, nhưng có tiếng nói vượt xa quy mô với các doanh nghiệp ngân hàng tư nhân, khách sạn, dịch vụ du thuyền và sự kiện quốc tế. Khách hàng ở đó kỳ vọng một sản phẩm chấp nhận số +377 mà không phàn nàn, và vẫn còn đáng ngạc nhiên nhiều biểu mẫu mặc định rằng ai ở gần Riviera cũng có đường dây +33 của Pháp.

Giả định đó gây ra những phiếu hỗ trợ thật. Nhiều người làm việc ở Monaco sống bên kia biên giới ở Pháp và dùng số Pháp, trong khi cư dân giữ số Monaco, nên một tệp khách hàng duy nhất trộn lẫn cả hai mã. Một số xác minh Monaco, đặt như một số +377 để thử nghiệm, cho phép kỹ sư QA chứng minh rằng bộ chọn quốc gia, quy tắc kiểm tra và mẫu SMS xử lý công quốc này như một quốc gia riêng chứ không phải vùng ngoại ô của Pháp.

Một biểu mẫu nên lưu và kiểm tra số +377 như thế nào?

Monaco có mã gọi quốc gia riêng, tách biệt với Pháp, và số quốc gia của nước này ngắn so với phần lớn châu Âu. Ở dạng quốc tế không có tiền tố nội hạt: số là +377 theo ngay sau bởi các chữ số thuê bao.

Một vài quy tắc thực tế cho kỹ sư:

• Lưu số ở dạng E.164 (+377…) và chỉ hiển thị nhóm số dễ đọc ở bước hiển thị.
• Người dùng quen cách bấm số của Pháp đôi khi gõ số 0 đứng đầu theo thói quen. Hãy bỏ nó khi chuẩn hóa thay vì làm kiểm tra thất bại.
• Đừng suy ra quốc gia từ tiền tố +33 và một địa chỉ bưu chính Monaco; hãy giữ quốc gia điện thoại và quốc gia thanh toán là hai trường độc lập.
• Dùng một thư viện số điện thoại được bảo trì thay vì kiểm tra độ dài tự viết, vì độ dài của Pháp được gắn cứng sẽ từ chối các số Monaco hợp lệ.

Tiếng Pháp là ngôn ngữ chính thức, nên tin nhắn xác minh thường đến bằng tiếng Pháp, dù tiếng Ý và tiếng Anh cũng được dùng rộng rãi tại chỗ và nhiều ứng dụng gửi tiếng Anh khi ngôn ngữ tài khoản được đặt như vậy. Hãy thử cả hai nếu quy trình onboarding của bạn đã bản địa hóa.

Tuyến Monaco có thể xác minh cho những dịch vụ nào?

Hiện có hơn 1,300 dịch vụ trên tuyến Monaco. Các dịch vụ phổ biến trong ảnh chụp hôm nay gồm Instagram, Airbnb, Telegram, Claude, WhatsApp, Facebook, Google (Gmail & YouTube), Uber, Netflix, eBay, LinkedIn và X (Twitter).

Độ phủ không cố định. Các đối tác nhà mạng của chúng tôi luân chuyển dung lượng trong ngày, nên một dịch vụ thấy được vào buổi sáng có thể bị tạm dừng vào buổi chiều. OTP routing đúng đắn đọc tình trạng sẵn có tại thời điểm đặt thay vì dựa vào danh sách lưu đệm, và API xác minh SMS cung cấp chính điều đó qua endpoint giá.

Chuỗi lệnh API OTP Monaco trông như thế nào?

Các yêu cầu đi đến https://otproute.com/api/v1 và xác thực bằng khóa Bearer bắt đầu bằng or_live_, tạo trong Developer console. Id quốc gia của Monaco là mc.

1. Thỉnh thoảng lấy GET /api/v1/services và GET /api/v1/countries để ánh xạ tên sang id.
2. Trước mỗi đơn, gọi GET /api/v1/prices?country=mc&service=<id>. Nó trả lời bằng giá trực tiếp và cho biết cặp đó có thể phục vụ được hay không.
3. Tạo đơn bằng POST /api/v1/activations, ví dụ {"service": "airbnb", "country": "mc"}. Giữ lại id kích hoạt được trả về.
4. Nhập số +377 vào ứng dụng của bạn và chờ activation.sms_received trên webhook, hoặc thăm dò GET /api/v1/activations/{id}.
5. Khi dọn dẹp, gọi POST /api/v1/activations/{id}/cancel cho mọi thứ còn đang chờ.

Hãy xác minh header X-OTPRoute-Signature của mỗi webhook bằng cách tính lại HMAC-SHA256 trên <t>.<raw body> với khóa bí mật của endpoint, và từ chối dấu thời gian cũ. Mỗi tài khoản có thể đăng ký 5 endpoint webhook và gửi tối đa 300 yêu cầu mỗi phút, đủ chỗ cho các lượt chạy Monaco song song. Hướng dẫn tích hợp trình bày cùng các bước kèm xử lý lỗi.

Có cách nào không cần code cho nhân viên vận hành không?

Dashboard bao quát cùng con đường đó cho bất kỳ ai không muốn chạm đến API. Chọn Monaco trong OTP Gateway, chọn dịch vụ, kiểm tra giá xuất hiện, rồi xác nhận. Số +377 hiện trên thẻ kích hoạt; dán nó vào màn hình đăng nhập hoặc đăng ký và mã sẽ xuất hiện trên thẻ đó khi SMS đến.

Khung thời gian kéo dài 20 phút. Nếu mã không đến kịp, hoặc bạn hủy đơn, toàn bộ số tiền được hoàn về ví mà không cần yêu cầu hỗ trợ.

Nếu mã Monaco không đến thì sao?

Các thị trường nhỏ có ít tuyến hơn, nên sự kiên nhẫn và một phương án dự phòng quan trọng hơn ở đây so với các nước lớn.

• Cho đơn hàng đủ khung thời gian trước khi hủy.
• Kiểm tra xem dịch vụ có chấp nhận số ảo cho thao tác đó; một số từ chối hoàn toàn.
• Thử lại sau một quãng nghỉ thay vì đặt lại trong vòng lặp, điều có thể kích hoạt giới hạn tốc độ phía dịch vụ.
• Nếu bài kiểm thử chỉ cần một số khu vực Riviera, tuyến Pháp hoặc tuyến Ý có thể có dung lượng dồi dào hơn vào lúc đó.

Hãy giữ mọi bài kiểm thử trong điều khoản của dịch vụ. OTP Route dành cho việc xác minh sản phẩm của chính bạn và các tài khoản doanh nghiệp hợp pháp, và Chính sách Sử dụng Chấp nhận được của nó có hiệu lực.

Có thể giữ số Monaco lâu dài không, và thanh toán được xử lý thế nào?

Không có đường dây +377 dài hạn tự phục vụ. Dedicated Virtual Number, loại bạn giữ trong khi chúng được gia hạn và hỗ trợ nhận SMS, gửi SMS và gọi từ trình duyệt, là sản phẩm chỉ có ở Mỹ và Canada, từ $1.95/month. Với một đường Monaco, hãy gửi email đến [email protected]; đội ngũ có thể cho biết quy định địa phương có cho phép gì không, mà không kèm lời hứa nào.

Các đơn Monaco trừ vào cùng một ví USD trả trước như mọi thứ khác, không phí hằng tháng và không phải chọn gói. Nạp bằng thẻ hoặc USDT/USDC, và sẽ có một hóa đơn PDF qua email cho mỗi lần nạp. Trong lúc làm tích hợp, một tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu, trả về số và mã mô phỏng để bạn kiểm thử từ đầu đến cuối mà không tốn gì. Chi tiết nằm ở trang bảng giá.

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

Số điện thoại Monaco có giống số Pháp không?

Không. Monaco dùng mã +377 riêng, nên logic kiểm tra phải xử lý nó tách biệt với +33 của Pháp.

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

Dùng mc trong truy vấn giá và trong phần thân yêu cầu kích hoạt.

Tôi có thể lấy một số +377 để thử nghiệm một đợt ra mắt ở châu Âu không?

Có, OTP Gateway cấp các số +377 dùng một lần cho từng lần xác minh, đặt từ dashboard hoặc API.

Tôi có bao lâu để nhận mã Monaco?

Mỗi lượt kích hoạt mở trong 20 phút; nếu không có gì đến, khoản phí được hoàn tự động.

Số Monaco có tiền tố nội hạt không?

Không ở định dạng quốc tế. Hãy bỏ số 0 đứng đầu mà người dùng gõ vào và lưu số dưới dạng +377 cộng các chữ số thuê bao.

Tin nhắn SMS xác minh từ một dịch vụ ở Monaco sẽ dùng ngôn ngữ nào?

Thường là tiếng Pháp, nhưng tùy ứng dụng và thiết lập ngôn ngữ của tài khoản, nên tin nhắn tiếng Anh hoặc tiếng Ý cũng có thể xảy ra.

Tôi có thể chạy các bài kiểm thử Monaco mà không tốn tiền thật không?

Hãy 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 việc kiểm thử tích hợp.

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.