Tích hợp xác minh SMS +82 vào pipeline phát hành cho thị trường Hàn Quốc

Một kích hoạt +82 đi qua những endpoint nào?

Hãy bắt đầu từ API xác minh SMS, vì đó là nơi hầu hết các kế hoạch kiểm thử tại Hàn Quốc rồi cũng kết thúc. Mọi lệnh gọi đều đi tới https://otproute.com/api/v1 với khóa Bearer bắt đầu bằng or_live_ lấy từ Developer console.

• GET /api/v1/countries trả về kr cho Hàn Quốc; GET /api/v1/services cho các service id.
• GET /api/v1/prices?country=kr&service=<id> báo giá hiện tại và tuyến có đang mở hay không.
• POST /api/v1/activations với {"service": "kakaotalk", "country": "kr"} giữ một số +82 và trả về activation id.
• GET /api/v1/activations/{id} hiển thị trạng thái và, khi đã nhận được, cả mã.
• POST /api/v1/activations/{id}/cancel giải phóng một số bạn không còn cần.
• GET /api/v1/balance cho phép một bộ kiểm thử thất bại sớm khi ví còn ít tiền.

Giới hạn của tài khoản là 300 yêu cầu mỗi phút, nên polling vài giây một lần trên nhiều job song song vẫn thoải mái. Hướng dẫn tích hợp trình bày một chu trình yêu cầu đầy đủ.

Webhook có chữ ký phù hợp thế nào với một lượt kiểm thử tại Hàn Quốc?

Polling là ổn với một nhà phát triển đơn lẻ; các job CI song song sẽ gọn hơn khi dùng cách đẩy dữ liệu. Hãy đăng ký tối đa năm endpoint và đăng ký nhận activation.sms_received, activation.expired và activation.cancelled.

Mỗi yêu cầu đều kèm X-OTPRoute-Signature: t=<unix>,v1=<hex>. Lấy phần thân thô đúng như nhận được, dựng chuỗi <t>.<raw body>, tính HMAC-SHA256 với secret của endpoint và so sánh với v1 bằng phép kiểm tra thời gian không đổi. Từ chối mọi thứ có timestamp cũ để chặn phát lại, và dùng activation id làm khóa cho trình xử lý của bạn để một lần gửi lại không giải quyết cùng một bài kiểm thử hai lần. Bài viết về HMAC đề cập các trường hợp biên như việc tuần tự hóa lại phần thân.

Các nhóm ra mắt tại Hàn Quốc thường giải quyết vấn đề gì?

Hàn Quốc là một thị trường khắt khe đối với ứng dụng di động và trò chơi, và người dùng Hàn Quốc kỳ vọng bản địa hóa chỉn chu. Các nhóm kiểm thử tại đây trước một bản phát hành, khi thêm màn hình tiếng Hàn, hoặc khi hàng đợi hỗ trợ báo rằng tin nhắn xác minh không tới được người dùng Hàn Quốc. Nếu không có SIM địa phương, việc nhận tin nhắn SMS OTP Hàn Quốc và tái hiện các báo cáo đó rất chậm. Một số +82 dùng một lần từ dịch vụ OTP routing cho phép kỹ sư phát lại đúng luồng đó từ bất kỳ văn phòng nào, và mã đổ về cùng công cụ như mọi thị trường khác.

Số điện thoại Hàn Quốc được định dạng và lưu trữ như thế nào?

Số di động Hàn Quốc được viết trong nước là 010 theo sau là tám chữ số. Số 0 đầu là tiền tố trung kế, nên dạng quốc tế bỏ nó đi: +82 10 rồi đến tám chữ số còn lại. Các biểu mẫu chấp nhận cả hai kiểu viết nên chuẩn hóa về E.164 ngay khi nhập; lưu 010… và +8210… song song sẽ tạo ra người dùng trùng lặp và tra cứu hỏng.

Tin nhắn từ các bên gửi Hàn Quốc thường viết bằng Hangul, được gửi dưới dạng SMS Unicode, trong khi các ứng dụng toàn cầu theo cài đặt ngôn ngữ của tài khoản. Hãy phân tích mã bằng cách khớp nhóm chữ số, đừng mong đợi một mẫu tiếng Anh. Cũng cần lưu ý rằng nhiều dịch vụ nội địa Hàn Quốc gắn việc đăng ký với kiểm tra danh tính bằng tên thật thông qua nhà mạng của thuê bao. Việc kiểm tra đó được thiết kế cho thuê bao cá nhân, một số dùng một lần sẽ không đáp ứng được, và bạn không nên tìm cách lách nó.

Hiện có những ứng dụng nào mở trên các tuyến Hàn Quốc?

Bản chụp kr cho thấy hơn 500 dịch vụ. Các lựa chọn phổ biến cho số xác minh Hàn Quốc gồm KakaoTalk, LINE, WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, TikTok, Discord, Netflix, Microsoft & Outlook, Amazon, Uber, ChatGPT (OpenAI) và Claude.

Mức bao phủ thay đổi trong ngày, vì vậy luôn xác nhận bằng endpoint prices trước khi đặt số. Người không phải lập trình viên có thể làm tương tự từ bảng điều khiển: tạo tài khoản, mở OTP Gateway, chọn dịch vụ và Hàn Quốc, xem giá hiển thị, xác nhận, rồi sao chép số +82 vào ứng dụng. Mã hiện trên màn hình ngay khi nó đến.

Nếu một kích hoạt +82 vẫn trống thì sao?

Khoảng thời gian kích hoạt là 20 phút, và bạn chỉ bị tính phí nếu mã đến. Khi không có gì đến:

• Hãy để khoảng thời gian đó chạy đủ trước khi coi đơn là thất bại.
• Hủy và thử lại sau, hoặc chọn một tuyến khác cho dịch vụ đó nếu có.
• Kiểm tra xem ứng dụng có từ chối đường dây ảo hoặc yêu cầu kiểm tra danh tính qua nhà mạng không; nếu có, lặp lại đơn sẽ không thay đổi kết quả.
• Không thử lại dồn dập trong một vòng lặp, điều này dễ kích hoạt cơ chế hạn chế tốc độ phía bên gửi.

Các đơn không được trả lời hoặc bị hủy sẽ được hoàn tiền tự động. Hãy tôn trọng điều khoản của từng ứng dụng, và nhớ rằng Chính sách Sử dụng Chấp nhận được của OTP Route áp dụng cho mọi kích hoạt.

Có số Hàn Quốc dài hạn không, và thanh toán hoạt động ra sao?

Không có đường dây +82 dài hạn tự phục vụ. Dedicated Number chỉ được cung cấp tại Hoa Kỳ và Canada, từ $1.95/month, cho các tài khoản phải tiếp tục nhận tin nhắn. Với các nhu cầu khác tại Hàn Quốc, hãy gửi email tới [email protected]; khả năng đáp ứng phụ thuộc vào quy định địa phương và không được đảm bảo.

OTP Gateway được thanh toán từ ví USD trả trước, không có gói cước hay phí hàng tháng. Nạp bằng thẻ hoặc USDT/USDC và nhận hóa đơn PDF cho mỗi lần nạp. Theo yêu cầu, một tài khoản phát triển có thể chuyển sang sandbox để pipeline của bạn chạy với số và mã mô phỏng. Xem bảng giá để biết mức giá hiện hành.

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

Tôi có thể kiểm thử bước xác minh số điện thoại Hàn Quốc của ứng dụng mà không cần SIM Hàn Quốc không?

Có. Đặt một số +82 qua OTP Gateway, nhập nó vào ứng dụng của bạn, và lấy mã qua API, webhook hoặc bảng điều khiển.

Tôi có thêm số 0 ở đầu khi nhập số Hàn Quốc theo định dạng quốc tế không?

Không. Bỏ tiền tố trung kế, nên một số di động 010 trở thành +82 10 cộng tám chữ số.

Một số +82 để kiểm thử có giá bao nhiêu?

Từ $0.20 mỗi mã, với giá chính xác tùy theo dịch vụ. Con số trực tiếp đến từ endpoint prices và bảng điều khiển.

Một số dùng một lần có vượt qua được bước xác minh tên thật của Hàn Quốc không?

Không. Các bước kiểm tra danh tính qua nhà mạng gắn với thuê bao cá nhân, vì vậy chỉ dùng OTP Route cho những luồng chấp nhận mã SMS thông thường.

Tôi có bị tính phí nếu KakaoTalk hay ứng dụng khác không bao giờ gửi mã không?

Không. Nếu không có gì đến trong 20 phút, hoặc bạn hủy, khoản thanh toán được hoàn lại vào ví của bạn.

Tôi có thể giữ một số Hàn Quốc cho các lần đăng nhập lặp lại không?

Không phải tự phục vụ. Mỗi số dùng một lần chỉ nhận một mã, và đường dây dài hạn chỉ giới hạn ở Hoa Kỳ và Canada.

API mong đợi mã quốc gia nào cho Hàn Quốc?

Country id là kr, dùng trong truy vấn giá và trong phần thân của yêu cầu kích hoạt.

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.