Checklist nhận mã SMS Bolt trên số OTP Route

Bolt yêu cầu số điện thoại ở đâu?

Bolt, công ty di chuyển được thành lập tại Tallinn đứng sau dịch vụ gọi xe, giao đồ ăn và hàng tạp hóa, cùng cho thuê xe scooter, xây dựng tài khoản quanh một số di động. Ứng dụng dành cho hành khách xác nhận số đó bằng mã SMS dùng một lần khi đăng ký, và loại mã tương tự thường xuất hiện lại khi ai đó đăng nhập trên thiết bị mới hoặc khôi phục quyền truy cập. Các sản phẩm dành cho tài xế, người giao hàng và doanh nghiệp cũng theo mô hình tương tự.

Với một doanh nghiệp, điều đó nghĩa là số điện thoại Bolt thực chất là chìa khóa của tài khoản. Các đội vận hành tài khoản công tác của công ty, kiểm tra tích hợp đối tác của mình hoạt động ra sao ở một thành phố mới, hoặc giữ SIM cá nhân của nhân viên tránh xa đăng nhập dùng chung đều cần một cách kiểm soát được để nhận mã đó.

Checklist trước khi đặt số Bolt

Hãy đi qua các mục này trước khi tiêu bất kỳ khoản nào:

• Mục đích hợp pháp: tài khoản thuộc về tổ chức của bạn hoặc là tài khoản kiểm thử cho sản phẩm của chính bạn, và điều khoản của Bolt cho phép điều đó.
• Đã chọn thị trường: quốc gia của số khớp với nơi tài khoản sẽ hoạt động. Một tài khoản hành khách đăng ký bằng số của một quốc gia nhưng dùng ở nơi khác có thể hoạt động khác đi.
• Khóa API sẵn sàng: một khóa Bearer có tiền tố or_live_, tạo trong Developer console (tối đa 10 khóa mỗi tài khoản).
• Endpoint webhook đã được kiểm thử: đã đăng ký activation.sms_received, với kiểm tra chữ ký được bật.
• Ví đã nạp tiền: xác nhận bằng GET /api/v1/balance, hoặc yêu cầu chế độ sandbox để diễn tập luồng với số mô phỏng.
• Phương án dự phòng đã thống nhất: quyết định trước bài kiểm thử sẽ làm gì nếu không có mã nào trả về.

Những quốc gia nào có tuyến Bolt?

Các tuyến Bolt hiện được liệt kê cho 198 quốc gia. Ví dụ gồm Estonia, Latvia, Litva, Ba Lan, Cộng hòa Séc, Bồ Đào Nha, Đức, Croatia, Malta, Georgia, Nam Phi, Nigeria, Kenya, Ghana, Tanzania và Uganda.

Hãy chọn quốc gia có chủ đích. Tính năng, phương thức thanh toán và các bước kiểm tra đăng ký của Bolt khác nhau theo thị trường, nên một bài kiểm thử ở Warsaw cho bạn biết rất ít về luồng ở Nairobi. Tình trạng khả dụng theo quốc gia thay đổi trong ngày; GET /api/v1/prices và dashboard cho thấy những gì đang hoạt động.

Từng bước: API mã xác minh Bolt

1. Xác nhận id dịch vụ bằng GET /api/v1/services; với Bolt là bolt.
2. Chọn id quốc gia từ GET /api/v1/countries, ví dụ ee cho Estonia.
3. Đọc giá trực tiếp: GET /api/v1/prices?country=ee&service=bolt.
4. Đặt đơn: POST /api/v1/activations với {"service": "bolt", "country": "ee"}. Lưu id kích hoạt và số được trả về.
5. Nhập số vào ứng dụng Bolt trên thiết bị kiểm thử của bạn và yêu cầu SMS.
6. Xử lý sự kiện activation.sms_received. Xác minh X-OTPRoute-Signature: t=<unix>,v1=<hex> bằng cách tính HMAC-SHA256 trên <t>.<raw body> với secret của endpoint, từ chối dấu thời gian cũ, và ghi theo khóa là id kích hoạt để một lần gửi lặp không làm thay đổi gì.
7. Nếu không dùng được webhook, hãy polling GET /api/v1/activations/{id} vài giây một lần, nằm trong giới hạn 300 yêu cầu mỗi phút.
8. Gọi POST /api/v1/activations/{id}/cancel nếu bài kiểm thử bị bỏ dở.

Chi tiết các endpoint nằm trong tài liệu API, và bảo mật webhook OTP giải thích bước kiểm tra chữ ký.

Từng bước: đường dashboard

Với một lần xác minh SMS Bolt để kiểm thử hoặc thiết lập tài khoản một lần, trình duyệt là đủ. Đăng nhập, mở OTP Gateway, chọn Bolt và thị trường, kiểm tra giá rồi xác nhận. Sao chép số vào ứng dụng, yêu cầu mã, và theo dõi nó hiện trên thẻ đơn trước khi bộ đếm 20 phút kết thúc.

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

Một cửa sổ trống không tốn gì; khi 20 phút trôi qua mà không có SMS, hoặc bạn hủy, toàn bộ số tiền được trả lại ví của bạn. Các nguyên nhân phổ biến và cách xử lý:

• Bolt từ chối số: như nhiều nền tảng, họ không chấp nhận số ảo để đăng ký Bolt ở mọi thị trường. Hãy thử tuyến quốc gia khác nếu bài kiểm thử của bạn cho phép, hoặc thử lại sau.
• Gửi chậm: thời gian phụ thuộc vào dịch vụ và tuyến, nên hãy để cửa sổ kết thúc trước khi hủy.
• Yêu cầu lặp lại: bấm gửi lại nhiều lần hoặc đặt lại đơn liên tục có thể kích hoạt cơ chế giới hạn của chính Bolt. Hãy giãn cách các lần thử.
• Sai thị trường: một số từ quốc gia mà Bolt không phục vụ trong kịch bản kiểm thử của bạn có thể không bao giờ được chấp nhận.

Hướng dẫn về định tuyến theo quốc gia cho OTP đề cập cách chọn phương án dự phòng.

Khi nào Dedicated Number là lựa chọn phù hợp hơn?

Số dùng một lần phù hợp với một lần xác minh. Nếu tài khoản Bolt phải đăng nhập lại sau vài tuần, chẳng hạn một hồ sơ hành khách staging mà đội QA của bạn dùng lại, hoặc một đăng nhập vận hành được xác minh lại trên thiết bị mới, thì số cần ở lại với bạn. Dedicated Number làm được điều đó, nhưng chỉ ở Hoa Kỳ và Canada, từ $1.95/tháng, với SMS đến trong dashboard và được chuyển tiếp tới webhook của bạn dưới dạng number.sms_received. Hãy kiểm tra xem thị trường Bolt của tài khoản có hoạt động với số Hoa Kỳ hoặc Canada không trước khi dựa vào chúng. Xem số ảo để biết chi tiết.

Sử dụng số Bolt có trách nhiệm

Hãy tuân thủ điều khoản dịch vụ của Bolt ở mọi thị trường. Mỗi người thật hoặc doanh nghiệp một tài khoản, và chỉ dùng OTP Route để kiểm thử sản phẩm của chính bạn hoặc vận hành các tài khoản hợp pháp mà tổ chức của bạn sở hữu; tạo hồ sơ hành khách dùng một lần hoặc săn khuyến mãi là cách dùng không được chấp nhận. Chính sách Sử dụng Chấp nhận được của OTP Route áp dụng cho mọi đơn, và Bolt là nhãn hiệu của chủ sở hữu, không hàm ý có liên kết.

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

Tôi có thể nhận mã OTP của Bolt mà không cần SIM địa phương không?

Có. Đặt một số cho dịch vụ bolt ở đúng quốc gia, nhập vào ứng dụng và đọc mã trong dashboard hoặc qua API.

Id dịch vụ Bolt trong API là gì?

Là bolt. Kết hợp nó với id quốc gia như pl hoặc ke khi bạn gọi POST /api/v1/activations.

Một số xác minh Bolt giá bao nhiêu?

Từ $0.20 mỗi mã. Số tiền chính xác phụ thuộc vào quốc gia và được trả về trực tiếp từ GET /api/v1/prices.

Bolt có chấp nhận mọi số ảo không?

Không. Bolt có thể từ chối số ảo ở một số thị trường hoặc luồng, đó là lý do mã không được gửi đến sẽ được hoàn tiền tự động.

Tôi nên chọn quốc gia nào cho bài kiểm thử Bolt?

Dùng quốc gia nơi tài khoản thực sự được dùng, để quy tắc đăng ký, ngôn ngữ và phương thức thanh toán khớp với những gì người dùng thật thấy.

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

Không với lượt kích hoạt dùng một lần. Với các lần đăng nhập lặp lại, Dedicated Number ở Hoa Kỳ hoặc Canada là lựa chọn tự phục vụ.

Tôi có thể thử luồng trước khi trả tiền không?

Có. Hãy yêu cầu chế độ sandbox trên tài khoản phát triển để nhận số và mã mô phỏng mà không tiêu tiền trong ví.

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.