Quickly find and manage reservations in seconds.
Enter the guest’s Booking ID to instantly view booking details, update reservations, or resend confirmation emails.
🔍 Booking Lookup
Công cụ tra cứu đầy đủ cho khách hàng A complete lookup tool for your guests
Nhúng vào bất kỳ trang nào — khách tự tra cứu, tự huỷ, không cần liên hệ nhà hàng. Embed anywhere — guests self-check and self-cancel without contacting the restaurant.
Tra cứu bằng booking referenceLookup by Booking Reference
Khách nhập mã dạng RBP-ABCDEF-123. REST API endpoint /rbp/v1/bookings/{ref} trả về toàn bộ thông tin booking theo thời gian thực.
Guests enter their code in format RBP-ABCDEF-123. REST API endpoint /rbp/v1/bookings/{ref} returns full booking info in real-time.
Hiển thị đầy đủ thông tin bookingFull Booking Detail Display
Tên khách, ngày đặt, giờ đặt, số khách (người lớn / người cao tuổi / trẻ em), bàn, gói dịch vụ, trạng thái, ghi chú đặc biệt — tất cả hiện ngay trên card đẹp. Guest name, date, time, guest count (adults / seniors / children), table, service package, status, special requests — all shown on a clean result card.
Tìm kiếm bằng phím EnterSearch with Enter Key
Hỗ trợ keydown + Enter để submit ngay — không cần click nút. Fetch API async với loading state và error handling đầy đủ.
Supports keydown + Enter for instant submit — no button click needed. Async Fetch API with loading state and full error handling.
REST API endpointBuilt-in REST API Endpoint
Endpoint GET /wp-json/rbp/v1/bookings/{ref} tích hợp sẵn trong plugin. Trả về JSON với đầy đủ trường booking, không cần cài thêm plugin API.
Endpoint GET /wp-json/rbp/v1/bookings/{ref} built directly into the plugin. Returns full booking JSON — no additional API plugin needed.
Error handling thông minhSmart Error Handling
Booking không tìm thấy → thông báo rõ ràng với mã ref. Lỗi kết nối → alert “Connection error”. Input trống → validate ngay trước khi fetch. Không để khách bối rối. Not found → clear message with the ref code. Connection error → “Connection error” alert. Empty input → validated before fetch. Never leaves guests confused.
Nhúng bằng shortcodeShortcode Embed
Paste [rbp_booking-lookup] vào bất kỳ trang WordPress nào. Widget render đầy đủ — input + nút tìm + khu vực kết quả. Mỗi instance có unique ID riêng.
Paste [rbp_booking-lookup] into any WordPress page. Widget renders complete — input + button + result area. Each instance has a unique ID.
Trải nghiệm tra cứu thực tếThe lookup experience
Từ mã đặt bàn đến thông tin chi tiếtFrom reference code to full booking detail
Nhúng shortcode vào trang WordPressEmbed shortcode on a WordPress page
Paste [rbp_booking-lookup] vào trang “Tra cứu đặt bàn”. Plugin tự render form input + nút tìm + vùng kết quả.
Paste [rbp_booking-lookup] on your “Check booking” page. Plugin auto-renders the input form + button + result area.
Khách nhập mã đặt bànGuest enters their booking reference
Khách nhận mã từ email xác nhận (dạng RBP-ABCDEF-123). Nhập vào input box, nhấn Enter hoặc click nút Tra cứu.
Guest receives the ref from their confirmation email (format RBP-ABCDEF-123). Types it in, presses Enter or clicks Look Up.
Fetch API gọi REST endpointFetch API calls the REST endpoint
GET /wp-json/rbp/v1/bookings/{ref} được gọi async. Plugin tra cứu DB, trả về JSON booking object với đầy đủ trường: tên, ngày, giờ, bàn, gói, trạng thái.
GET /wp-json/rbp/v1/bookings/{ref} is called asynchronously. Plugin queries DB and returns full booking JSON: name, date, time, table, package, status.
Render card kết quả đẹpResult card is rendered
Nếu tìm thấy: hiển thị card với header màu đỏ (booking ref + status badge) và lưới thông tin 2 cột. Nếu không tìm thấy hoặc lỗi mạng: alert thông báo rõ ràng. If found: card with red header (ref + status badge) and 2-column info grid. If not found or network error: clear alert message with the entered code.
REST API EndpointREST API Endpoint
{booking_ref} là mã alphanumeric dạng RBP-ABCDEF-123 hoặc ID số nguyên. Endpoint public — không yêu cầu authentication.
Returns a JSON object with full booking data. {booking_ref} accepts alphanumeric format RBP-ABCDEF-123 or integer ID. Public endpoint — no authentication required.
6 trạng thái booking6 booking statuses
Mỗi booking luôn có một trong 6 trạng thái. Widget Booking Lookup hiển thị tất cả chính xác theo thời gian thực. Every booking is always in one of 6 states. The Booking Lookup widget shows them all accurately in real-time.
Đặt bàn vừa tạo, chờ xác nhận từ admin (khi auto_confirm = OFF).Booking just created, awaiting admin confirmation (when auto_confirm = OFF).
Đã xác nhận. Bàn đã được lock. Khách sẽ nhận reminder email/Zalo/SMS.Confirmed. Table is locked. Guest will receive reminder emails/Zalo/SMS.
Khách đã ngồi. Staff cập nhật thủ công từ WP Admin hoặc REST API.Guest is seated. Staff updates manually from WP Admin or REST API.
Booking hoàn thành. Bàn đã unlock. Điểm loyalty được cộng nếu có.Booking completed. Table unlocked. Loyalty points awarded if applicable.
Đã huỷ (bởi khách hoặc admin). Bàn unlock. Có thể trigger win-back email.Cancelled (by guest or admin). Table unlocked. May trigger win-back email.
Khách không đến. Admin đánh dấu. Có thể đưa vào blacklist nếu đủ lần no-show.Guest didn’t arrive. Marked by admin. May be blacklisted if threshold reached.
Thông số kỹ thuậtTechnical Specifications
| Thuộc tínhProperty | Chi tiếtDetail |
|---|---|
| Shortcode | [rbp_booking-lookup] |
| REST Endpoint | GET /wp-json/rbp/v1/bookings/{ref} |
| Input format | RBP-XXXXXX-NNN (alphanumeric) hoặcor integer ID |
| Fetch method | Browser fetch() — async, no page reload |
| Authentication | Không cần — endpoint publicNone required — public endpoint |
| Error handling | 404 not found · Network error · Empty input validation404 not found · Network error · Empty input validation |
| Keyboard UX | keydown: Enter — submit không cần clicksubmit without clicking |
| Instance ID | Unique per shortcode: Unique per shortcode: rbplkp + uniqid() |
| Response fields | booking_ref, status, full_name, guests, seniors_count, children_count, booking_date, booking_time, table_number, buffet_package, special_requests |
| Plan required | Tất cả plan (Free Trial → Annual)All plans (Free Trial → Annual) |

