Danh sách kiểm tra trước khi nhận mã SMS Curacao (+599)

Danh sách kiểm tra cần có gì trước khi đặt số +599?

Thị trường đảo thưởng cho sự chuẩn bị kỹ một chút, vì tình trạng khả dụng của tuyến thay đổi trong ngày và một lượt kiểm thử vội vàng chỉ tốn thời gian. Hãy đánh dấu các mục này trước yêu cầu đầu tiên:

• Một khóa API từ Developer console. Khóa bắt đầu bằng or_live_; một tài khoản có thể giữ tối đa 10 khóa, vì vậy hãy cấp cho CI và staging khóa riêng.
• Một ví USD đã nạp tiền, hoặc một tài khoản phát triển được chuyển sang sandbox theo yêu cầu nếu bạn chỉ muốn chạy thử tích hợp.
• Đúng các id. Curacao là cw trong API; id dịch vụ lấy từ GET /api/v1/services.
• Một endpoint webhook đã lưu secret, hoặc một vòng lặp polling với khoảng cách hợp lý. Mỗi tài khoản được phép tối đa 5 endpoint.
• Một quy tắc lưu trữ cho số +599 (trình bày bên dưới), để dữ liệu kiểm thử khớp với dữ liệu thật.
• Một kế hoạch cho trường hợp trống: bài kiểm thử của bạn làm gì khi cửa sổ hết hạn mà không có mã.

Tuyến số xác minh Curacao bao phủ những dịch vụ nào?

Bản chụp trực tiếp cho Curacao liệt kê hơn 400 dịch vụ. Những dịch vụ phổ biến gồm Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal, Netflix, Uber và Airbnb. Các tên thuộc nhóm du lịch và nhắn tin là những cái mà các đội ở Curacao thường chọn đầu tiên, vì khách sạn và các sản phẩm hướng tới du khách tạo ra nhiều lượt đăng ký số trên đảo.

Hãy xem danh sách này là điểm khởi đầu chứ không phải lời hứa. Nguồn cung thay đổi trong ngày, chính vì thế API trả về tình trạng khả dụng cùng với mỗi lần tra giá.

Từng bước: gọi API OTP Curacao

Mọi lệnh gọi đều đến https://otproute.com/api/v1 với khóa Bearer của bạn, trong mức trần 300 yêu cầu mỗi phút.

1. Đọc GET /api/v1/prices?country=cw&service=<id> để xác nhận tuyến đang mở và xem giá hiện tại cho cặp đó.
2. Tạo đơn bằng POST /api/v1/activations, gửi {"service": "telegram", "country": "cw"} hoặc id dịch vụ nào bạn cần. Phản hồi mang một id kích hoạt và số +599.
3. Nhập số đó vào màn hình đăng ký hoặc đăng nhập bạn đang kiểm thử.
4. Chờ activation.sms_received trên webhook, hoặc polling GET /api/v1/activations/{id} với khoảng cách vừa phải.
5. Nếu bài kiểm thử bị bỏ dở, gọi POST /api/v1/activations/{id}/cancel để ví được hoàn tiền ngay.

Trước khi tin bất kỳ webhook nào, hãy kiểm tra header X-OTPRoute-Signature: tính HMAC-SHA256 trên "<t>.<raw body>" bằng secret của endpoint và từ chối các dấu thời gian đã cũ. Hướng dẫn ký webhook trình bày kỹ hơn.

Nên lưu và chuẩn hóa số +599 như thế nào?

Curacao dùng chung mã quốc gia +599 với Bonaire, Sint Eustatius và Saba, và số thuê bao Curacao theo sau mã đó là số 9. Số 9 đứng đầu ấy là một phần của số, không phải tiền tố trunk, nên một bộ chuẩn hóa bỏ nó sẽ làm hỏng bản ghi. Hãy lưu đầy đủ chuỗi E.164 (+5999 theo sau là các chữ số còn lại) không có khoảng trắng, và chỉ thêm định dạng khi hiển thị.

Cũng nên kiểm tra rằng widget nhập số điện thoại của bạn liệt kê Curacao thành một mục riêng thay vì gộp vào một lựa chọn Netherlands Antilles chung, như các thư viện cũ vẫn làm.

Về ngôn ngữ: tiếng Papiamentu, tiếng Hà Lan và tiếng Anh đều là ngôn ngữ chính thức, và phần lớn dịch vụ toàn cầu gửi mã bằng tiếng Anh hoặc theo ngôn ngữ đặt trong tài khoản. Nếu sản phẩm của bạn bản địa hóa sang tiếng Hà Lan hoặc Papiamentu, hãy chạy ít nhất một lượt cho mỗi ngôn ngữ để thấy mẫu tin thật chứ không phải bản dự phòng. Các đội thường kiểm thử ở đây khi ra mắt tại vùng Caribe thuộc Hà Lan, phục vụ du khách đặt chỗ từ nước ngoài, hoặc vận hành khu vực từ hòn đảo.

Con đường qua dashboard cho những người không viết mã là gì?

Nhân viên hỗ trợ và quản lý sản phẩm có thể làm điều tương tự mà không cần viết script:

1. Tạo tài khoản bằng email và mã 6 chữ số, hoặc đăng nhập Google, rồi bật xác thực hai yếu tố TOTP.
2. Nạp tiền vào ví.
3. Mở OTP Gateway, chọn dịch vụ, rồi chọn Curacao; giá hiện ra trước khi bạn xác nhận.
4. Sao chép số +599 vào ứng dụng và theo dõi thẻ kích hoạt cho đến khi mã xuất hiện.

Cùng cửa sổ 20 phút và quy tắc hoàn tiền được áp dụng như với API.

Khắc phục sự cố: mã Curacao không xuất hiện

Thỉnh thoảng một lượt kích hoạt im lặng là bình thường, và nó không tốn gì vì số tiền quay lại ví khi cửa sổ đóng hoặc khi bạn hủy.

• Để cửa sổ chạy hết. Một số dịch vụ gửi lại chậm; hủy ở phút thứ hai sẽ bỏ phí một mã có thể vẫn sẽ đến.
• Kiểm tra lập trường của dịch vụ đích về số ảo. Một số từ chối chúng, đó là lý do cơ chế hoàn tiền tồn tại.
• Thử lại sau, hoặc thử tuyến quốc gia khác nếu bài kiểm thử không phụ thuộc cụ thể vào số Curacao.
• Tránh đặt lại liên tục trong vòng lặp dày. Hãy giãn cách giữa các lần thử để không chồng nhiều lượt kích hoạt song song cho một bài kiểm thử.

Trang giải pháp kiểm thử QA cho thấy cách các đội xây dựng những lần thử lại này vào bộ kiểm thử tự động.

Dòng số dài hạn, ví và thanh toán cho các dự án Curacao

Không có số dài hạn tự phục vụ cho Curacao. Nếu bạn cần một dòng số giữ trong nhiều tháng, hãy gửi email tới [email protected] và đội ngũ sẽ kiểm tra những gì quy định địa phương cho phép; không có gì được hứa. Dòng số chuyên dụng là sản phẩm dành cho Hoa Kỳ và Canada, từ $1.95/month, được mô tả ở trang số ảo.

Các lượt kích hoạt Curacao trừ vào một ví USD trả trước duy nhất, không có phí hàng tháng và không phải chọn gói. Cả thanh toán thẻ lẫn USDT/USDC đều dùng được để nạp tiền, và mỗi lần nạp tạo một hóa đơn PDF gửi qua email cho sổ sách của dự án Curacao của bạn. Mức giá hiện hành nằm ở trang bảng giá. Chỉ dùng OTP Route cho sản phẩm của chính bạn và các tài khoản hợp pháp, tuân thủ điều khoản của từng dịch vụ, và lưu ý rằng Chính sách Sử dụng Chấp nhận được của OTP Route áp dụng.

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

Tôi có thể kiểm thử luồng đăng ký Curacao mà không cần mua SIM nội địa không?

Có. Đặt một số +599 từ OTP Gateway cho dịch vụ đang kiểm thử và đọc mã trong dashboard hoặc qua API, không cần SIM hay điện thoại trên đảo.

OTP Route dùng country id nào cho Curacao?

Curacao là cw. Hãy kết hợp cw với id dịch vụ liệt kê trong GET /api/v1/services ở mọi lần kiểm tra giá và đặt đơn.

Số 9 sau +599 có phải tiền tố trunk mà tôi nên bỏ không?

Không. Với Curacao, số 9 là một phần của số thuê bao, vì vậy hãy giữ nó trong giá trị E.164 được lưu.

Tôi có bị tính phí khi một lượt kích hoạt Curacao hết hạn mà không có mã không?

Không. Nếu không có SMS nào đến trong 20 phút, hoặc bạn hủy trước, toàn bộ số tiền sẽ quay lại ví của bạn tự động.

Tôi có thể giữ một số Curacao để đăng nhập lại vào tháng sau không?

Không qua hình thức tự phục vụ. Số chuyên dụng dài hạn chỉ được bán cho Hoa Kỳ và Canada; với Curacao bạn có thể gửi email cho bộ phận hỗ trợ để hỏi, không có lời hứa về khả năng cung cấp.

Làm sao nối tích hợp trước khi tiêu tiền trong ví?

Hãy yêu cầu chế độ sandbox cho một tài khoản phát triển qua bộ phận hỗ trợ. Nó trả về số và mã mô phỏng để toàn bộ đường đi của API và webhook có thể chạy thử từ đầu đến 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.