Xác minh đăng ký +387 khi không ai trong đội có SIM Bosnia

Bản phát hành cần kiểm thử +387, nhưng chiếc SIM nằm trong ngăn kéo ở Sarajevo. Giờ làm gì?

Đây là tình huống bí bách quen thuộc với các đội phát hành sản phẩm ở Tây Balkan. Quản lý sản phẩm muốn có bằng chứng rằng người dùng Bosnia đăng ký được, trưởng nhóm QA có một mục kiểm tra ghi "xác minh bằng số địa phương", và chiếc SIM +387 vật lý duy nhất thuộc về một đồng nghiệp đã nghỉ việc từ mùa xuân năm ngoái.

Những lý do thường khiến một đội rơi vào tình cảnh này:

• Một đợt ra mắt khu vực gồm Bosnia và Herzegovina cùng Croatia, Serbia và Montenegro, nơi đường đăng ký của mỗi thị trường cần được kiểm tra riêng.
• Khách hàng kiều bào. Nhiều người sống ở Đức, Áo, Thụy Điển và nơi khác vẫn giữ số +387, nên một sản phẩm fintech hay gần với viễn thông có thể thấy số Bosnia từ những người dùng chưa từng đặt chân tới đất nước này trong lúc đăng ký.
• QA bản địa hóa. Tiếng Bosnia, Croatia và Serbia đều là ngôn ngữ chính thức, và cả chữ Latinh lẫn chữ Kirin đều xuất hiện hằng ngày, nên nội dung và việc kiểm tra biểu mẫu xứng đáng được chạy đầu cuối thực sự.

Thay vì gửi thẻ SIM qua đường bưu điện, OTP Route lo phần định tuyến OTP cho bạn: OTP Gateway trao cho bạn một số +387 cho một lần xác minh và chuyển tin SMS đến lại qua một API xác minh SMS mà bộ kiểm thử của bạn có thể gọi.

Những ứng dụng và nền tảng nào có thể gửi mã tới số xác minh Bosnia?

Phạm vi hỗ trợ là ảnh chụp trực tiếp, nên hãy xem đây là điểm khởi đầu chứ không phải thực đơn cố định. Tại thời điểm viết bài, các tuyến của Bosnia và Herzegovina gồm Viber, WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Discord, Uber, Amazon và eBay.

Tổng cộng quốc gia này có hơn 1,600 dịch vụ. Nếu bạn cần số xác minh Bosnia và Herzegovina cho một dịch vụ không có ở đây, hãy xem danh sách trực tiếp trước. Viber quan trọng ở Balkan hơn nhiều khu vực khác, điều đáng nhớ nếu sản phẩm của bạn cũng gửi mã qua kênh nhắn tin chứ không chỉ SMS. Vì tình trạng khả dụng thay đổi trong ngày, hãy hỏi API các lựa chọn hiện tại thay vì ghi cứng danh sách vào bộ kiểm thử.

Luồng API OTP Bosnia và Herzegovina chạy thế nào, từng lệnh gọi một?

Với các bài kiểm thử Bosnia, hãy trỏ client của bạn tới https://otproute.com/api/v1 và truyền khóa or_live_ làm token Bearer. Khóa được tạo trong Developer console; một tài khoản có thể giữ tối đa 10 khóa và 5 endpoint webhook, với trần 300 yêu cầu mỗi phút.

1. Gọi GET /api/v1/services và GET /api/v1/countries một lần, lưu các id vào bộ nhớ đệm, và xác nhận ba có trong danh sách.
2. Kiểm tra chi phí bằng GET /api/v1/prices?country=ba&service=<id> để tác vụ của bạn ghi lại con số chính xác trước khi chi tiêu.
3. Gửi POST /api/v1/activations với {"service": "<id>", "country": "ba"}. Phản hồi mang id kích hoạt và số +387 để nhập vào ứng dụng đang kiểm thử.
4. Chờ webhook activation.sms_received, hoặc thăm dò GET /api/v1/activations/{id} theo khoảng vừa phải nếu runner của bạn không nhận được lưu lượng đến.
5. Nếu bài kiểm thử bị hủy giữa chừng, hãy giải phóng số bằng POST /api/v1/activations/{id}/cancel để tiền được hoàn ngay.

Với webhook, hãy đọc tiêu đề X-OTPRoute-Signature (t=<unix>,v1=<hex>), tính HMAC-SHA256 trên <t>.<raw body> bằng bí mật endpoint, so sánh trong thời gian không đổi, và loại bỏ dấu thời gian cũ. Vì các sự kiện được định khóa theo id kích hoạt, một mã +387 được gửi hai lần chỉ nên được ghi một lần. Hướng dẫn tích hợp API OTP trình bày sâu hơn về thử lại và xử lý lỗi.

Có cách không cần code cho đội hỗ trợ hoặc vận hành không?

Có. Người không có quyền API có thể làm điều tương tự từ trình duyệt: đăng nhập, mở OTP Gateway, chọn Bosnia và Herzegovina cùng dịch vụ, xem giá, rồi xác nhận. Số hiện trên màn hình, và mã xuất hiện bên cạnh khi SMS được nhận. Cách này phù hợp cho nhân viên hỗ trợ tái hiện sự cố đăng ký của khách hàng hoặc trưởng bộ phận vận hành kiểm tra cổng đối tác sau khi đổi điện thoại.

Nên lưu số +387 và phân tích nội dung SMS Bosnia như thế nào?

Trong nước, số Bosnia được quay với tiền tố trung kế 0, và số di động thường bắt đầu bằng 06. Trong E.164 số không đó biến mất: số viết nội địa là 061 theo sau sáu chữ số sẽ thành +387 61 cộng sáu chữ số đó. Chỉ lưu dạng E.164, loại bỏ khoảng trắng, dấu gạch và dấu gạch chéo khi nhập, và từ chối bất cứ thứ gì vẫn còn số không đứng đầu sau mã quốc gia.

Tin nhắn xác minh có thể đến bằng tiếng Anh hoặc một trong các ngôn ngữ địa phương, và một tin viết bằng chữ Kirin hoàn toàn có thể xảy ra. Hãy trích mã bằng mẫu chữ số thay vì tìm một từ cụ thể, và bảo đảm nhật ký của bạn giữ nguyên UTF-8 để các dấu như č, ć, š và ž không bị hỏng khi bạn gỡ lỗi một lượt chạy thất bại.

Nếu lượt kiểm thử không nhận được mã thì sao?

Không tính phí khi mã không đến. Nếu không có SMS nào về trong 20 phút, hoặc bạn hủy trước, toàn bộ số tiền tự động trở về ví. Khi điều đó xảy ra:

• Hãy để khung thời gian chạy hết thay vì đặt lại ngay; một SMS đến muộn vẫn được tính.
• Thử lại sau một lúc, hoặc chọn tuyến dịch vụ khác cho cùng kịch bản.
• Xác nhận dịch vụ đích có chấp nhận số ảo hay không; một số từ chối chúng, đó chính là lý do khoản hoàn tiền tồn tại.
• Tránh đặt số liên tục trong vòng lặp từ CI, điều đó chỉ đốt giới hạn tốc độ mà không cải thiện cơ hội.

Giảm gửi OTP thất bại đề cập các mẫu thường có ích.

Có thể giữ số Bosnia lâu dài không, và thanh toán hoạt động ra sao?

Không phải dưới dạng sản phẩm tự phục vụ. Dedicated Virtual Numbers (số ảo chuyên dụng), gia hạn từ ví, từ $1.95/tháng, chỉ được bán tức thì cho Hoa Kỳ và Canada. Nếu đội của bạn thực sự cần một số +387 dùng lâu dài, hãy gửi email tới [email protected]; liệu có khả thi hay không phụ thuộc vào quy định địa phương, và không có lời hứa rằng có thể sắp xếp được.

Thanh toán cho cổng là một ví USD trả trước, không phí hằng tháng và không có gói để chọn. Có thể nạp tiền bằng thẻ hoặc stablecoin USDT/USDC; hóa đơn PDF cho mỗi lần nạp sẽ về hộp thư của bạn. Với công việc tích hợp, một tài khoản phát triển có thể được chuyển sang sandbox khi có yêu cầu, trả về số và mã mô phỏng để pipeline của bạn chạy mà không đụng đến tiền trong ví. Mức giá hiện tại có trên trang bảng giá, và bạn có thể tạo tài khoản bằng mã email hoặc đăng nhập Google.

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

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

Có. Hãy đặt một số +387 cho dịch vụ của bạn qua OTP Gateway, nhập vào ứng dụng và đọc mã trên dashboard hoặc từ API.

OTP Route dùng id quốc gia nào cho Bosnia và Herzegovina?

Id là ba. Hãy truyền nó làm trường country khi tạo lượt kích hoạt và làm tham số truy vấn country khi kiểm tra giá.

Tôi có phải trả tiền nếu mã +387 không bao giờ đến không?

Không. Nếu không có gì đến trong khung 20 phút, hoặc bạn hủy, toàn bộ số tiền được trả về ví của bạn tự động.

Có nên giữ số không đứng đầu khi lưu số di động Bosnia không?

Không. Hãy lưu số theo E.164, nghĩa là +387 theo sau là số đã bỏ số không trung kế nội địa.

Số +387 để kiểm thử có phù hợp cho tài khoản chúng tôi phải đăng nhập lại vào tháng sau không?

Không hẳn, vì mỗi số của cổng chỉ phục vụ một lần xác minh. Với đăng nhập lặp lại, số chuyên dụng ở Mỹ hoặc Canada là lựa chọn tự phục vụ; còn số Bosnia dùng lâu dài thì hãy hỏi đội ngũ qua email.

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

Có, bằng cách yêu cầu chế độ sandbox cho tài khoản phát triển. Nó trả về số và mã mô phỏng để toàn bộ luồng, kể cả webhook, được chạy thử miễn phí.

Có quy tắc nào về cách dùng các số này không?

Có. Hãy tuân thủ điều khoản của từng dịch vụ, chỉ dùng số cho sản phẩm và tài khoản hợp pháp của chính bạn, và lưu ý Chính sách sử dụng chấp nhận được của OTP Route áp dụng cho mọi đơ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.