Nhận mã SMS foodpanda bằng API, webhook hoặc dashboard

Những lệnh API nào dùng để lấy mã foodpanda?

Luồng API mã xác minh foodpanda dùng id dịch vụ foodpanda và năm lệnh gọi tới https://otproute.com/api/v1, mỗi lệnh được xác thực bằng khóa Bearer bắt đầu bằng or_live_.

1. GET /api/v1/countries cho bạn các id quốc gia; hãy lưu cache kết quả.
2. GET /api/v1/prices?country=<id>&service=foodpanda trả về giá hiện tại và cho biết thị trường đó có thể phục vụ vào thời điểm này hay không.
3. POST /api/v1/activations với {"service": "foodpanda", "country": "<id>"} tạo đơn và trả về activation id cùng một số điện thoại.
4. Bài kiểm thử nhập số đó vào màn hình foodpanda đang được kiểm tra, và mã được lấy bằng webhook hoặc GET /api/v1/activations/{id}.
5. POST /api/v1/activations/{id}/cancel đóng một đơn mà bài kiểm thử không cần nữa.

Hãy thêm GET /api/v1/balance vào bước chuẩn bị để bộ kiểm thử dừng gọn gàng khi ví hết tiền. Khóa được tạo trong Developer console, tối đa 10 khóa mỗi tài khoản, với giới hạn 300 yêu cầu mỗi phút. Tài liệu dành cho nhà phát triển liệt kê định dạng yêu cầu và lỗi.

Nên viết bộ xử lý webhook như thế nào?

Nhận dữ liệu đẩy (push) là lựa chọn gọn gàng hơn khi nhiều bài kiểm thử chạy cùng lúc. Trỏ một trong năm endpoint được phép tới một route trong bộ kiểm thử của bạn, rồi đăng ký activation.sms_received, activation.expired và activation.cancelled cho các đơn foodpanda.

Mỗi lần gửi đều kèm X-OTPRoute-Signature: t=<unix>,v1=<hex>. Tính HMAC-SHA256 trên <t>.<raw body> bằng secret của endpoint, so sánh với v1 theo thời gian không đổi, và từ chối các yêu cầu có timestamp quá cũ. Hãy làm việc này trên byte thô trước khi bất kỳ bước phân tích JSON nào làm thay đổi chúng.

Làm cho bộ xử lý có tính idempotent: gắn mỗi sự kiện với activation id của nó và bỏ qua các lần lặp, vì cơ chế thử lại có thể gửi cùng một sự kiện hai lần. Phản hồi nhanh và chuyển mã cho bất cứ thứ gì bài kiểm thử đang chờ. Với các script nhanh, polling endpoint kích hoạt mỗi vài giây là một phương án thay thế hợp lý. Hướng dẫn webhook HMAC đề cập các trường hợp đặc biệt.

foodpanda xác minh số điện thoại để làm gì?

foodpanda là nền tảng giao đồ ăn và hàng tạp hóa nổi tiếng nhất ở Nam Á và Đông Nam Á. Như hầu hết ứng dụng giao đồ ăn, nó gắn tài khoản với một số di động: số thường được xác nhận bằng mã SMS dùng một lần khi đăng ký, có thể được kiểm tra lại khi đăng nhập trên thiết bị mới, và giúp tài xế cùng bộ phận hỗ trợ liên lạc với khách về đơn hàng.

Với các đội đối tác, agency và nhà phát triển làm việc xung quanh nền tảng này, điều đó có nghĩa bước nhận OTP foodpanda nằm trong nhiều hành trình thực tế: onboarding khách mới, kiểm thử màn hình đăng ký đã bản địa hóa, hoặc tái hiện lỗi đăng nhập mà người dùng báo cáo. Có một số điện thoại foodpanda mà bạn kiểm soát được cho từng bài kiểm thử giúp bạn khỏi phải mượn SIM cá nhân của đồng nghiệp.

Quốc gia nào có thể cấp số foodpanda?

Tuyến foodpanda khả dụng tại 198 quốc gia. Ví dụ gồm Pakistan, Bangladesh, Malaysia, Philippines, Đài Loan, Singapore, Hồng Kông, Thái Lan, Campuchia, Lào, Myanmar, Đức, Vương quốc Anh và Hoa Kỳ.

Việc chọn quốc gia không chỉ là hình thức. Các ứng dụng giao đồ ăn bản địa hóa theo thị trường, nên bài kiểm thử màn hình đăng ký của Bangladesh cần dùng số Bangladesh, và một tài khoản dùng để đặt hàng ở Kuala Lumpur nên khớp với Malaysia. Quốc gia không khớp có thể dẫn đến số bị từ chối hoặc một luồng khu vực không liên quan. Tình trạng khả dụng của từng quốc gia thay đổi trong ngày, vì vậy endpoint giá là nguồn tham chiếu chuẩn. Hướng dẫn định tuyến theo quốc gia giải thích cách chọn và dự phòng giữa các thị trường.

Người không phải lập trình viên có làm được từ dashboard không?

Có, và số bước chỉ ngang với việc đặt một bữa trưa:

1. Mở OTP Gateway, chọn foodpanda làm dịch vụ và chọn quốc gia.
2. Xem giá hiển thị và xác nhận đơn.
3. Sao chép số vào ứng dụng hoặc website foodpanda bạn đang kiểm thử.
4. Theo dõi thẻ kích hoạt; mã sẽ hiện ở đó khi SMS đến.

Khung kích hoạt là 20 phút. Nếu foodpanda không bao giờ gửi mã, hoặc bạn hủy, khoản phí tự động được hoàn về ví, nên bạn chỉ trả tiền cho những mã đã đến.

Vì sao mã foodpanda có thể không đến?

Một vài nguyên nhân bao quát gần như mọi lần trượt. foodpanda, như nhiều ứng dụng tiêu dùng khác, có thể từ chối số ảo ở một số thị trường hoặc với một số thao tác. Nó cũng có thể giới hạn tần suất một thiết bị, IP hoặc tài khoản được yêu cầu mã. Và từng tuyến đôi khi bị nghẽn.

Những thói quen hữu ích khi xác minh SMS foodpanda để kiểm thử:

• Chờ hết khung thời gian rồi mới hủy.
• Giãn cách các lần thử lại thay vì đặt lại liên tục trong vòng lặp dày đặc.
• Thử tuyến quốc gia khác nếu trường hợp kiểm thử cho phép.
• Dùng chế độ sandbox trên tài khoản phát triển khi đang xây pipeline, để bạn không tốn đơn thật cho các lỗi đường ống.

Không tuyến nào có thể ép một dịch vụ chấp nhận một số; cơ chế hoàn tiền tự động tồn tại chính cho tình huống đó.

Khi nào Dedicated Number phù hợp hơn, và các quy tắc cơ bản là gì?

Một số Gateway dùng một lần không thể nhận mã thứ hai về sau. Nếu một tài khoản staging hoặc QA phải đăng nhập lại sau vài tuần, một số ảo cho foodpanda mà bạn giữ lại sẽ hợp lý hơn: Dedicated Virtual Numbers có tại Hoa Kỳ và Canada, từ $1.95/month, với SMS đến trong dashboard và trên webhook của bạn. Ở nơi khác không có số dài hạn tự phục vụ; hãy gửi email tới [email protected] để hỏi. Xem số ảo để biết chi tiết.

Chỉ dùng OTP Route cho sản phẩm và tài khoản hợp pháp của chính bạn: một tài khoản cho mỗi cá nhân hoặc doanh nghiệp thật, và luôn trong khuôn khổ điều khoản của foodpanda cũng như Chính sách Sử dụng Chấp nhận được của OTP Route. foodpanda là nhãn hiệu của chủ sở hữu, và OTP Route không có liên kết với họ. Nguồn tiền là ví USD trả trước, không có phí hàng tháng, nạp bằng thẻ hoặc USDT/USDC, mỗi lần nạp đều có hóa đơn PDF.

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

Id dịch vụ của foodpanda trong API OTP Route là gì?

Là foodpanda. Hãy ghép nó với id quốc gia trong truy vấn giá và yêu cầu kích hoạt.

Tôi có thể tự động hóa các bài kiểm thử đăng ký foodpanda trong CI không?

Có. Tạo một khóa cho mỗi môi trường, đặt số qua API, rồi chờ webhook activation.sms_received hoặc polling lượt kích hoạt.

Số kiểm thử foodpanda của tôi nên đến từ quốc gia nào?

Thị trường mà tài khoản hướng tới. foodpanda bản địa hóa theo quốc gia, nên khớp số với thị trường đó giúp tránh số bị từ chối và các luồng khu vực sai.

Tôi có phải trả tiền nếu foodpanda không bao giờ gửi mã không?

Không. Đơn foodpanda không nhận được SMS trong 20 phút, hoặc bị bạn hủy, sẽ được hoàn đầy đủ về ví.

foodpanda có chấp nhận mọi số của OTP Route không?

Không nhất thiết. Một số dịch vụ từ chối số ảo, nên việc chấp nhận có thể khác nhau theo quốc gia và thao tác.

Cùng một số điện thoại foodpanda có nhận được mã lần nữa vào tháng sau không?

Một số Gateway chỉ xử lý một lần xác minh. Với các lần đăng nhập lặp lại, hãy dùng Dedicated Number của Hoa Kỳ hoặc Canada.

Làm sao kiểm tra một webhook thực sự đến từ OTP Route?

Tính lại HMAC-SHA256 trên timestamp và nội dung thô bằng secret của endpoint, so sánh với header chữ ký, và từ chối timestamp đã cũ.

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.