Số xác minh Guiana thuộc Pháp (+594) dành cho lập trình viên và đội QA

Một mã hay một số dùng lâu dài: Guiana thuộc Pháp hỗ trợ gì?

Trước khi viết bất kỳ dòng code nào, hãy xác định công việc cần sản phẩm nào.

• OTP Gateway phù hợp với các lần xác minh một lần: kiểm tra luồng đăng ký có chấp nhận số xác minh Guiana thuộc Pháp hay không, chạy hồi quy trước một đợt phát hành, hoặc thiết lập hồ sơ doanh nghiệp khu vực một lần duy nhất. Mỗi số chỉ dùng cho một mã.
• Dedicated Virtual Numbers phù hợp với các tài khoản phải tiếp tục nhận mã, chẳng hạn một tài khoản đăng nhập staging mà đội QA mở mỗi tuần. Loại này chỉ bán tức thì tại Hoa Kỳ và Canada, từ $1.95/tháng.

Guiana thuộc Pháp thuộc nhóm thứ nhất. Không có đường dây +594 dùng lâu dài tự phục vụ; nếu đội của bạn cần, hãy viết đến [email protected], và khả năng cung cấp phụ thuộc vào quy định địa phương. Bài so sánh số tạm thời và số chuyên dụng sẽ giúp bạn khi chưa chắc một tác vụ thuộc nhóm nào.

Quy trình gọi API OTP cho Guiana thuộc Pháp diễn ra thế nào?

Mã quốc gia (country id) của Guiana thuộc Pháp là gf. Với khóa Bearer (tiền tố or_live_) gọi tới https://otproute.com/api/v1:

1. GET /api/v1/prices?country=gf&service=<id> trả về giá hiện tại và cho biết tuyến có đang mở hay không.
2. POST /api/v1/activations với {"service": "facebook", "country": "gf"} giữ một số +594 và trả về activation id.
3. Bài kiểm thử của bạn nhập số đó vào ứng dụng đang được kiểm tra.
4. Mã đến với bạn qua activation.sms_received trên webhook, hoặc qua GET /api/v1/activations/{id} nếu bạn polling.
5. POST /api/v1/activations/{id}/cancel giải phóng một đơn mà bài kiểm thử không còn cần.

Các yêu cầu webhook có X-OTPRoute-Signature theo dạng t=<unix>,v1=<hex>. Hãy tính HMAC-SHA256 của "<t>.<raw body>" bằng secret của endpoint, so sánh trong thời gian hằng định, từ chối timestamp quá cũ và loại trùng theo activation id. Giới hạn cho mỗi tài khoản là 10 khóa API, 5 endpoint webhook và 300 yêu cầu mỗi phút; tài liệu đầy đủ nằm ở phần docs.

Vì sao số +594 làm khó việc kiểm tra số điện thoại?

Guiana thuộc Pháp là một vùng hải ngoại của Pháp và dùng kế hoạch đánh số của Pháp, nhưng có mã quốc gia riêng là +594 thay vì +33 của Pháp. Trong nước, số có mười chữ số với số 0 đứng đầu: di động thường bắt đầu bằng 0694 và điện thoại cố định bằng 0594. Ở dạng quốc tế, số 0 bị bỏ, nên một số di động trở thành +594 694 XX XX XX.

Cách sắp xếp này tạo ra vài lỗi kinh điển, và một số +594 để kiểm thử là cách dễ nhất để bắt chúng:

• Bộ chọn quốc gia gộp các vùng lãnh thổ của Pháp vào Pháp và thêm +33 vào trước số 0694.
• Thư viện điện thoại báo vùng là GF trong khi logic nghiệp vụ của bạn chỉ biết FR.
• Mã hiển thị định dạng theo cặp chữ số kiểu Pháp nhưng lại lưu chuỗi đã định dạng thay vì E.164.

Hãy lưu +594… không có khoảng trắng và tách riêng khái niệm vùng và quốc gia trong mô hình dữ liệu của bạn.

Những ứng dụng nào có thể gửi mã xác minh tới số Guiana thuộc Pháp?

Hiện có hơn 700 dịch vụ trên tuyến Guiana thuộc Pháp. Ảnh chụp trực tiếp gồm WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Snapchat, Telegram, Microsoft & Outlook, Amazon, Airbnb, Uber và LinkedIn.

Nội dung SMS thường bằng tiếng Pháp, phù hợp với ngôn ngữ mà hầu hết tài khoản địa phương dùng, nhưng mỗi dịch vụ tự chọn mẫu tin nhắn, vì vậy hãy trích xuất các chữ số thay vì so khớp một cụm từ. Các đội thường kiểm thử ở đây khi bản địa hóa luồng tiếng Pháp ra ngoài nước Pháp bản thổ, phục vụ khách hàng ở các vùng hải ngoại của Pháp, hoặc kiểm tra xem một tài khoản khu vực có còn xác minh được sau khi thay đổi cấu hình hay không.

Đặt một số +594 từ dashboard như thế nào?

Không cần viết code:

1. Đăng ký bằng email cùng mã email 6 chữ số, hoặc bằng đăng nhập Google, và bật luôn xác thực hai yếu tố TOTP.
2. Nạp tiền vào ví bằng thẻ hoặc USDT/USDC.
3. Chọn Guiana thuộc Pháp và dịch vụ; giá được hiển thị trước khi bạn xác nhận.
4. Dán số vào ứng dụng, rồi theo dõi trang kích hoạt để xem mã.

Nhân viên vận hành và quản lý tài khoản của agency thường đi theo hướng này, trong khi kỹ sư thiết lập API. Cả hai dùng chung một ví.

Chuyện gì xảy ra khi mã không bao giờ đến?

Mỗi lượt kích hoạt kéo dài 20 phút. Chỉ thu tiền khi mã đến; đơn bị hủy, hoặc cửa sổ đóng mà không có SMS, sẽ được hoàn lại toàn bộ số tiền vào ví một cách tự động.

Nếu bạn đang chờ một mã +594:

• Hãy để cửa sổ chạy hết; một dịch vụ có thể chậm mà không có gì bất thường.
• Kiểm tra xem dịch vụ có chấp nhận số ảo hay không. Một số dịch vụ không chấp nhận, và cơ chế hoàn tiền sinh ra chính cho trường hợp đó.
• Thử lại sau hoặc chọn một tuyến dịch vụ khác.
• Đừng viết script đặt lại ngay sau mỗi lần trượt; backoff theo cấp số nhân giúp tuyến +594 luôn dùng được cho mọi người.

Các ghi chú của chúng tôi về giảm tỷ lệ gửi OTP thất bại đi sâu hơn. Chỉ kiểm thử Guiana thuộc Pháp với các sản phẩm và tài khoản do đội của bạn sở hữu, tuân thủ điều khoản của từng dịch vụ, và xem Chính sách Sử dụng Chấp nhận được của OTP Route là một phần của thỏa thuận.

Thanh toán, hóa đơn và kiểm thử sandbox được xử lý ra sao?

OTP Route vận hành trên một ví USD trả trước: dùng bao nhiêu trả bấy nhiêu, không phí hằng tháng, không gói cước. Bạn nạp tiền bằng thẻ hoặc stablecoin USDT/USDC, và hóa đơn PDF được gửi qua email sau mỗi lần nạp để bộ phận kế toán của bạn sử dụng. Mức giá hiện tại có trên trang bảng giá.

Kỹ sư đang thiết lập luồng gf có thể nhờ bộ phận hỗ trợ chuyển tài khoản phát triển sang sandbox. Chế độ này trả về số và mã mô phỏng, nên luồng +594, việc xác minh webhook và logic thử lại đều có thể được kiểm thử đầu cuối mà không tốn tiền trong ví. Nhìn từ phía API, định tuyến OTP tới Guiana thuộc Pháp không khác gì bất kỳ thị trường nào khác: chỉ có country id thay đổi, còn API xác minh SMS vẫn giữ nguyên.

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

Tôi có thể kiểm thử đăng ký tại Guiana thuộc Pháp cho ứng dụng của mình mà không cần SIM địa phương không?

Có. Đặt một số OTP Gateway cho gf, nhập vào form đăng ký, rồi đọc mã trong dashboard hoặc từ webhook của bạn.

Số Guiana thuộc Pháp có giống số +33 của Pháp không?

Không. Guiana thuộc Pháp dùng kế hoạch đánh số của Pháp nhưng có mã quốc gia riêng là +594, và các thư viện điện thoại coi đây là một vùng riêng biệt.

Một mã +594 có giá bao nhiêu?

Từ $0.20 mỗi mã, thay đổi theo dịch vụ; dashboard và GET /api/v1/prices hiển thị giá trực tiếp. Không có SMS trong 20 phút nghĩa là được hoàn tiền tự động.

Tôi có thể giữ một số Guiana thuộc Pháp cho các lần đăng nhập sau không?

Không có lựa chọn tự phục vụ. Dedicated Numbers dài hạn chỉ giới hạn ở Hoa Kỳ và Canada; hãy gửi email tới [email protected] để hỏi về +594.

Mã được gửi đến bằng ngôn ngữ nào?

Thường là tiếng Pháp, tuy nhiên mỗi dịch vụ tự chọn mẫu tin nhắn và có thể theo cài đặt ngôn ngữ của tài khoản.

Tôi có thể thử tích hợp trước khi nạp tiền vào ví không?

Hãy yêu cầu chế độ sandbox cho tài khoản phát triển. Chế độ này mô phỏng số và mã để bạn thử toàn bộ luồng mà không tốn đồng nào.

Vì sao mã Guiana thuộc Pháp của tôi không đến?

Dịch vụ có thể chậm, có thể từ chối số ảo, hoặc tuyến có thể đang bận. Hãy chờ hết cửa sổ, sau đó thử lại sau hoặc qua tuyến khác; các đơn thất bại đều được hoàn tiền.

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.