Danh sách kiểm tra trước khi chạy cho số xác minh Quần đảo Cayman

Danh sách kiểm tra trước khi chạy: cần chuẩn bị gì trước khi đặt số +1 345?

Hãy rà soát danh sách này một lần và activation Cayman đầu tiên thường sẽ diễn ra suôn sẻ:

• Tài khoản và bảo mật. Đăng ký bằng địa chỉ email và mã email 6 chữ số (hoặc đăng nhập Google), rồi bật xác thực hai yếu tố TOTP cho bất kỳ ai có thể chi tiêu từ ví.
• Ví đã nạp tiền. Nạp ví USD trả trước bằng thẻ hoặc USDT/USDC. Không có gói nào để chọn và không có phí hằng tháng.
• API key. Tạo một key trong Developer console; nó bắt đầu bằng or_live_ và được đặt trong header Bearer. Một tài khoản có thể giữ tối đa 10 key.
• Endpoint webhook. Đăng ký một URL và giữ secret của nó ở nơi trình xử lý của bạn đọc được. Giới hạn là năm endpoint cho mỗi tài khoản.
• Đã cấu hình phân tích số điện thoại. Đảm bảo thư viện số điện thoại của bạn nhận ra mã vùng 345 là Quần đảo Cayman thay vì mặc định coi mọi số +1 là của Hoa Kỳ.
• Sandbox, nếu bạn muốn chạy thử. Nhờ bộ phận hỗ trợ chuyển một tài khoản phát triển sang chế độ sandbox để số và mã mô phỏng kiểm thử tích hợp của bạn mà không đụng đến tiền trong ví.

Tài liệu tham chiếu API liệt kê mọi trường bạn sẽ thấy trong phản hồi.

Vì sao số Cayman làm vấp code giả định +1 nghĩa là nước Mỹ?

Quần đảo Cayman nằm trong Kế hoạch đánh số Bắc Mỹ, nên dùng chung mã quốc gia 1 với Hoa Kỳ, Canada và một danh sách dài các vùng lãnh thổ Caribe. Thứ nhận diện một đường dây Cayman là mã vùng 345. Một số đầy đủ gồm mười chữ số sau mã quốc gia, được viết trong nước là (345) NXX-XXXX và lưu theo E.164 là +1345 theo sau bảy chữ số.

Ba hệ quả thực tế cho kỹ sư:

• Việc nhận diện khu vực phải dựa vào mã vùng. Một biểu mẫu đăng ký suy ra quốc gia chỉ từ tiền tố +1 sẽ gắn nhãn khách hàng Cayman là người Mỹ và có thể chọn sai múi giờ, đơn vị tiền tệ hoặc nội dung đồng ý.
• Trong NANP, số 1 đứng đầu cũng là chữ số trung kế đường dài, nên người dùng đôi khi gõ 1 345... hoặc chỉ 345.... Hãy chuẩn hóa cả ba dạng về chuỗi E.164 trước khi lưu.
• Lưu số không có khoảng trắng, dấu gạch ngang hay dấu ngoặc, và chỉ định dạng ở thời điểm hiển thị.

Tiếng Anh là ngôn ngữ chính thức, nên mã cho thị trường này thường đến bằng tiếng Anh. Tuy vậy, câu chữ chính xác do dịch vụ gửi tin nhắn quyết định, không phải do tuyến.

Những dịch vụ nào có thể định tuyến mã đến số xác minh Quần đảo Cayman?

Ảnh chụp trực tiếp cho quốc gia ky hiện gồm WhatsApp, Telegram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Amazon, Airbnb, Uber, Signal, Discord, ChatGPT (OpenAI), Netflix và eBay. Tính cả phần đuôi dài, tuyến này bao phủ hơn 600 dịch vụ, và danh sách thay đổi trong ngày, đó là lý do tình trạng khả dụng luôn được đọc từ API thay vì gán cứng.

Các nhóm thường cần số +1 345 để kiểm thử vì quần đảo này là một trung tâm tài chính offshore lớn và một điểm đến du lịch nhộn nhịp. Các đơn vị quản lý quỹ, công ty bảo hiểm, nền tảng du lịch và doanh nghiệp bất động sản onboard khách hàng địa phương, và nhóm sản phẩm của họ muốn xem luồng đăng ký hoạt động đúng như một cư dân Cayman sẽ trải nghiệm. Các ghi chú về onboarding fintech trình bày mô hình này sâu hơn.

Từng bước: trình tự gọi API OTP Quần đảo Cayman diễn ra như thế nào?

Mọi lệnh gọi đều gửi đến https://otproute.com/api/v1 với Bearer key của bạn, trong giới hạn 300 request mỗi phút.

1. Gọi GET /api/v1/services một lần và cache các id dịch vụ mà bộ kiểm thử của bạn cần.
2. Gọi GET /api/v1/prices?country=ky&service=<id> để đọc giá trực tiếp và xác nhận cặp này hiện đang khả dụng.
3. Gửi POST /api/v1/activations với body như {"service": "<id>", "country": "ky"}. Phản hồi chứa activation id và số +1 345.
4. Nhập số đó vào ứng dụng đang kiểm thử và kích hoạt bước SMS của nó.
5. Chờ activation.sms_received trên webhook của bạn. Hãy kiểm tra header X-OTPRoute-Signature trước: tính HMAC-SHA256 trên <t>.<raw body> với secret của endpoint, so sánh với v1, và từ chối timestamp cũ.
6. Không có webhook, hãy polling GET /api/v1/activations/{id} ở khoảng cách vừa phải cho đến khi mã xuất hiện hoặc cửa sổ đóng.
7. Nếu bài kiểm thử bị hủy, hãy gọi POST /api/v1/activations/{id}/cancel để khoản tạm giữ quay về ví.

Hướng dẫn webhook HMAC trình bày việc kiểm tra chữ ký từng dòng một.

Từng bước cho đồng nghiệp thích dùng dashboard

Nhân viên hỗ trợ và account manager không cần chạm đến API chút nào:

1. Mở trang OTP Gateway trong dashboard.
2. Chọn Quần đảo Cayman làm quốc gia, rồi chọn dịch vụ bạn đang xác minh.
3. Kiểm tra giá hiển thị trước khi đặt và xác nhận.
4. Sao chép số vào ứng dụng, yêu cầu mã, và để trang activation mở; SMS sẽ hiện ở đó khi nó đến.

Cửa sổ 20 phút và quy tắc hoàn tiền áp dụng y hệt như khi dùng qua API.

Xử lý sự cố: nếu không có mã nào đến số +1 345 thì sao?

Một activation im lặng không bị tính phí. Nếu không có SMS nào đến trước khi 20 phút kết thúc, hoặc bạn hủy, toàn bộ số tiền tự động quay về ví. Trước khi đặt lại:

• Hãy để cửa sổ chạy hết. Thời gian gửi tùy thuộc vào dịch vụ và tuyến, nên một mã chậm không nhất thiết là thất bại.
• Kiểm tra chính sách của dịch vụ. Một số dịch vụ từ chối hoàn toàn số ảo, đó chính là tình huống mà cơ chế hoàn tiền tồn tại để xử lý.
• Thử lại sau hoặc đổi tuyến. Danh mục thay đổi trong ngày; lần thử thứ hai sau một giờ, hoặc một quốc gia Caribe lân cận, có thể cho kết quả khác.
• Tránh vòng lặp dày. Một script hủy rồi đặt lại sau mỗi vài giây sẽ đốt hết giới hạn tốc độ của bạn và hiếm khi có ích.

Cẩm nang xử lý gửi thất bại có thêm các cách chẩn đoán. Chỉ dùng mỗi số cho sản phẩm của chính bạn hoặc các tài khoản doanh nghiệp của bạn, tuân thủ điều khoản của mọi dịch vụ, và nhớ rằng Chính sách sử dụng chấp nhận được của OTP Route được áp dụng.

Tôi có thể giữ đường dây Cayman lâu dài không, và thanh toán được xử lý ra sao?

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

Mọi thứ khác chạy trên một ví USD trả trước duy nhất. Mỗi lần nạp bằng thẻ hoặc USDT/USDC đều tạo một hóa đơn PDF gửi qua email, và trang bảng giá giải thích mô hình trả theo mức dùng.

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

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

Có. Hãy đặt một số +1 345 qua OTP Gateway, nhập nó vào ứng dụng của bạn và đọc mã trong dashboard hoặc qua API. Bạn trả từ $0.20 mỗi mã và chỉ khi mã đến.

API dùng id quốc gia nào cho Quần đảo Cayman?

Id là ky. Hãy truyền nó làm giá trị country khi bạn gọi GET /api/v1/prices hoặc POST /api/v1/activations.

Tôi nên lưu số điện thoại Cayman trong cơ sở dữ liệu như thế nào?

Hãy lưu theo dạng E.164: +1345 theo sau số thuê bao bảy chữ số, không có khoảng trắng hay dấu câu. Hãy nhận diện lãnh thổ từ mã vùng 345, không phải từ tiền tố +1.

Một số +1 345 có được tính là số Mỹ đối với Dedicated Numbers không?

Không. Dedicated Numbers chỉ được bán cho Hoa Kỳ và Canada, nên một đường dây Cayman chỉ có dưới dạng activation OTP Gateway cho một mã.

Tiền của tôi sẽ ra sao nếu SMS không bao giờ đến?

Activation mở trong 20 phút. Nếu không có mã nào đến trong thời gian đó, hoặc bạn hủy trước, toàn bộ số tiền được hoàn về ví của bạn tự động.

Tôi có thể chạy kiểm thử OTP Cayman trong CI mà không tốn tiền trong ví không?

Hãy nhờ bộ phận hỗ trợ chuyển một tài khoản phát triển sang sandbox. Nó trả về số và mã mô phỏng, nên pipeline của bạn có thể chạy toàn bộ luồng activation và webhook mà không tốn phí.

OTP Route bao phủ bao nhiêu dịch vụ cho Cayman?

Hơn 600 tại thời điểm chụp nhanh gần nhất. Vì danh mục thay đổi trong ngày, hãy truy vấn GET /api/v1/services và endpoint giá để biết tình trạng khả dụng trực tiế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.