Lộ trình dành cho lập trình viên để nhận mã xác minh Thụy Sĩ (+41)

Những yêu cầu nào trả về mã Thụy Sĩ qua API?

API OTP Thụy Sĩ dùng cùng một bề mặt nhỏ gọn như mọi quốc gia khác, với ch làm id quốc gia. Hãy xác thực bằng khóa Bearer (tiền tố or_live_) tạo trong Developer console; mỗi tài khoản có thể giữ tối đa 10 khóa.

1. Lấy các id từ GET /api/v1/services và GET /api/v1/countries, rồi lưu cache giữa các lần chạy.
2. Kiểm tra GET /api/v1/prices?country=ch&service=<id>. Phản hồi cho biết giá hiện tại và việc hiện có tuyến nào đang mở hay không.
3. Gửi POST /api/v1/activations với {"service": "whatsapp", "country": "ch"} hoặc dịch vụ nào mà bài kiểm thử của bạn cần. Giữ lại activation id được trả về.
4. Nhập số +41 vào ô số điện thoại của sản phẩm của chính bạn.
5. Đọc kết quả từ GET /api/v1/activations/{id} hoặc từ webhook; hủy gọn gàng bằng POST /api/v1/activations/{id}/cancel.

GET /api/v1/balance nên nằm trong bước khởi tạo của bộ kiểm thử. Giới hạn tốc độ là 300 yêu cầu mỗi phút cho mỗi tài khoản, đủ thoải mái cho nhiều job chạy đồng thời polling ở khoảng cách thư thả. Tài liệu endpoint: docs.

Nên polling hay dùng webhook cho các lượt kích hoạt +41?

Polling giúp một script nhanh vẫn đơn giản. Webhook thắng thế ngay khi các bài kiểm thử chạy song song, vì không có gì phải quay vòng chờ trong lúc một SMS gửi về Zurich đang trên đường.

OTP Route cho phép bạn đăng ký tối đa năm endpoint; hãy đăng ký mỗi endpoint với activation.sms_received, activation.expired và activation.cancelled. Hãy xác minh từng lần gửi trước khi tin tưởng: lấy phần t và v1 của X-OTPRoute-Signature, tính HMAC-SHA256 trên "<t>.<raw body>" bằng secret của endpoint, so sánh trong thời gian hằng số, và từ chối các timestamp nằm ngoài một ngưỡng dung sai ngắn. Hãy định khóa việc xử lý theo activation id để một lần gửi lại chỉ là thao tác vô hại không có tác dụng.

Để tìm hiểu sâu hơn về kiểm tra chữ ký, xem bảo mật webhook OTP bằng HMAC.

Một số điện thoại Thụy Sĩ nên trông như thế nào trong cơ sở dữ liệu?

Trong nước, số Thụy Sĩ bắt đầu bằng tiền tố trung kế 0, ví dụ một số di động viết là 079 123 45 67. Ở dạng quốc tế, số 0 này biến mất: dạng E.164 là +41 79 123 45 67, với chín chữ số sau mã quốc gia. Các dải di động nằm trong khối 07x. Hãy lưu chuỗi chuẩn +41… và chỉ định dạng khi hiển thị, nếu không việc loại trùng và tra cứu sẽ hỏng khi một dạng ghi 079 còn dạng kia ghi +4179.

Ngôn ngữ là điểm đặc thù khác của Thụy Sĩ. Với tiếng Đức, Pháp, Ý và Romansh đều là ngôn ngữ quốc gia, một SMS xác minh có thể đến bằng bất kỳ ngôn ngữ nào trong ba thứ tiếng đầu tùy cách bên gửi xử lý locale, và nhiều ứng dụng đơn giản quay về tiếng Anh. Nếu sản phẩm của bạn bản địa hóa theo vùng, một mã +41 thật là cách rẻ để xác nhận đúng mẫu tin được kích hoạt.

Các đội kiểm thử ở đây trước khi ra mắt một sản phẩm fintech hoặc thương mại điện tử vào thị trường Thụy Sĩ, khi hỗ trợ nhân sự quản lý tài khoản doanh nghiệp từ Geneva hay Basel, hoặc khi xác thực các luồng xuyên biên giới có liên quan đến Liechtenstein, nơi dùng mã +423 riêng.

Những dịch vụ nào bạn có thể xác minh với số xác minh Thụy Sĩ

Ảnh chụp hiện tại cho ch liệt kê Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, WhatsApp, Telegram, Signal, Uber, Airbnb, Amazon, eBay, Netflix, Discord, ChatGPT (OpenAI) và Claude, cùng nhiều dịch vụ khác. Tổng cộng, Thụy Sĩ có hơn 1,700 dịch vụ trên OTP Gateway.

Vì tình trạng khả dụng thay đổi suốt cả ngày, hãy coi danh sách đó là điểm khởi đầu và truy vấn dữ liệu trực tiếp lúc chạy. Một bộ kiểm thử kiểm tra giá trước và đánh dấu bài kiểm thử là bỏ qua khi tuyến đóng sẽ cho báo cáo sạch hơn nhiều so với bộ cứ thử lại một cách mù quáng.

Xử lý lượt kích hoạt Thụy Sĩ cứ trống không

Khi một số +41 không nhận được gì, hãy làm lần lượt các bước sau trước khi động đến mã của bạn:

• Hãy cho đủ khung 20 phút; một số nền tảng xếp hàng đợi tin nhắn gửi đi.
• Kiểm tra xem dịch vụ có từ chối số ảo hay không. Một vài dịch vụ từ chối, và đó chính là trường hợp mà cơ chế hoàn tiền tự động sinh ra để xử lý.
• Thử lại sau một khoảng nghỉ, hoặc dùng một tuyến dịch vụ khác, thay vì đặt lại liên tục trong vòng lặp chặt.
• Hủy các lượt kích hoạt bị bỏ dở để tiền quay về ngay.

Bài viết về định tuyến theo quốc gia cho OTP giải thích vì sao cùng một ứng dụng có thể hoạt động khác nhau giữa các tuyến quốc gia.

Có số Thụy Sĩ dùng lâu dài không?

Không phải dạng sản phẩm tự phục vụ. Với Thụy Sĩ, OTP Route chỉ cung cấp số dùng một lần qua OTP Gateway.

Dedicated Virtual Numbers, tức số bạn giữ lại chừng nào còn gia hạn, chỉ giới hạn ở Hoa Kỳ và Canada và bắt đầu từ $1.95/tháng. Nếu bạn thực sự cần một đường dây Thụy Sĩ cố định, hãy viết đến [email protected] và mô tả trường hợp sử dụng; câu trả lời phụ thuộc vào quy định địa phương và không thể hứa trước.

Ví, hóa đơn và sandbox cho định tuyến OTP Thụy Sĩ

Bạn trả theo mức dùng từ một ví USD trả trước duy nhất. Không có phí hằng tháng và không có gói nào để chọn. Hãy nạp bằng thẻ hoặc bằng USDT/USDC, và một hóa đơn PDF được gửi qua email cho mỗi lần nạp, giúp kế toán gọn gàng cho các pháp nhân Thụy Sĩ đối soát bằng franc.

Với công việc tích hợp, hãy yêu cầu chế độ sandbox trên tài khoản phát triển. Chế độ này trả về số và mã mô phỏng để toàn bộ đường đi của API xác minh SMS có thể được kiểm thử mà không tốn tiền trong ví. Chỉ dùng các lượt kích hoạt thật cho sản phẩm và tài khoản của chính bạn, trong phạm vi điều khoản của từng dịch vụ và Acceptable Use Policy của OTP Route. Trang giải pháp kiểm thử QA cho thấy các đội đưa việc này vào kiểm tra phát hành như thế nào.

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

API dùng id quốc gia nào cho Thụy Sĩ?

Thụy Sĩ là ch. Các yêu cầu cho Thụy Sĩ mang giá trị hai chữ cái đó ở bất cứ chỗ nào cần quốc gia, kể cả trong phần thân của yêu cầu kích hoạt.

Tôi có thể kiểm tra luồng đăng nhập Thụy Sĩ mà không có SIM Thụy Sĩ không?

Có. Một số +41 để kiểm thử từ OTP Gateway sẽ nhận mã, và bạn đọc mã đó trong dashboard hoặc qua API.

Có nên giữ số 0 khi lưu số di động Thụy Sĩ không?

Không. Số 0 là tiền tố trung kế nội địa; hãy lưu dạng E.164 bắt đầu bằng +41 rồi đến chín chữ số.

SMS xác minh Thụy Sĩ sẽ bằng ngôn ngữ nào?

Tùy bên gửi: tiếng Đức, Pháp, Ý hoặc Anh đều phổ biến. Hãy trích mã bằng mẫu chữ số thay vì dựa vào câu chữ cố định.

SMS OTP Thụy Sĩ có giá bao nhiêu?

Từ $0.20 mỗi mã, với giá chính xác theo từng dịch vụ do GET /api/v1/prices trả về trước khi bạn đặt.

Điều gì xảy ra với tiền của tôi nếu không có mã nào đến?

Tiền tự động quay về ví của bạn khi khung thời gian kết thúc hoặc khi bạn hủy lượt kích hoạt.

Tuyến Thụy Sĩ có bao gồm Liechtenstein không?

Không, Liechtenstein có mã quốc gia +423 riêng và trang riêng trong danh sách quốc gia, nên hãy đặt riêng.

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.