Closed-Loop Mode Integration

​

Prerequisite: User-Level Authorization (OAuth 2.0)

• For complete protocol endpoints and implementation guides, see the OAuth 2.0 Integration Guide.
• Pass the token in request headers: Authorization: Bearer <ACCESS_TOKEN>.

​

6-Phase End-to-End Workflow

[Phase 1: Search & Filter] --> [Phase 2: Price & Inventory Lock] --> [Phase 3: Order & Cashier]
     searchHotels                     hotelPriceConfirm                  createHotelBookingWithPaymentURL
     getHotelDetail
           │
           ▼
[Phase 4: Payment Completed] --> [Phase 5: Order & Voucher]      --> [Phase 6: Two-Phase Refund]
     Web (paymentUrl)                 getHotelOrderDetail                preCancelHotelBooking (Quote)
     Mini Program (miniProgram)       searchHotelOrders                  confirmCancelHotelBooking (Execute)

​

Phase 1: Search & Precise Room Filtering

1. searchHotels: Filter candidates by destination, landmarks, dates, star ratings, and budget;
2. getHotelDetail: Supports server-side exact filtering (e.g. filter: { mealType: "DOUBLE_BREAKFAST", cancelable: "CANCELABLE" }), directly returning matching room rate plans (roomRatePlans) without requiring the LLM to parse raw lists.

​

Phase 2: Real-Time Price & Room Lock (30 Minutes)

• Key Outputs:
  • referenceNo: The unique lock quote reference (must be passed to the booking tool);
  • finalTotalAmount: The locked final total price (including taxes & fees);
  • guestProfile: Platform-suggested frequent guest profiles for one-click confirmation.
• Lock Expiration: The locked price and room inventory remain guaranteed for 30 minutes.

{
  "tool": "hotelPriceConfirm",
  "arguments": {
    "hotelID": 102906,
    "ratePlanID": "RP_992019_DELUXE_BF2",
    "numOfRooms": 1,
    "dateParam": {
      "checkInDate": "2026-11-01",
      "checkOutDate": "2026-11-02"
    },
    "occupancyDetails": [
      {
        "roomNum": 1,
        "adultCount": 2,
        "childCount": 0
      }
    ]
  }
}

​

Phase 3: Booking Creation & Cashier Payment

• Key Inputs: referenceNo from Phase 2, contact information, and guest list;
• Mutually Exclusive Payment Payload:
  • Web/Browser Hosts: Returns paymentUrl (secure checkout web string);
  • WeChat/Native Hosts: Returns miniProgramPayInfo (native cashier launch object);
  • See Payment & Checkout Routing for detailed host handling.

{
  "tool": "createHotelBookingWithPaymentURL",
  "arguments": {
    "referenceNo": "REF_20261101_TYO_99812",
    "contact": {
      "firstName": "San",
      "lastName": "Zhang",
      "phone": "+1-202-555-0192",
      "email": "zhangsan@example.com"
    },
    "guestList": [
      {
        "roomNum": 1,
        "guestInfo": [
          {
            "firstName": "San",
            "lastName": "Zhang",
            "isAdult": true
          }
        ]
      }
    ]
  }
}

​

Phase 4: Order Query & Check-In Vouchers

1. searchHotelOrders: Queries an order summary list (supports status filtering, lightweight output to prevent LLM context bloat);
2. getHotelOrderDetail: Queries complete reservation details by orderNo, including:
   • Confirmation voucher number (hotelConfirmationNo);
   • Hotel physical address, GPS coordinates (latitude, longitude), and front desk phone;
   • Check-in dates, guest names, and cancellation policy descriptions.

Note: For confirmed, cancelled, or expired orders, paymentUrl is safely set to null to prevent redundant redirects.

​

Phase 5: Two-Phase Safe Cancellation (Quote-Execute)

​

Step 1: Pre-Cancellation Quote (preCancelHotelBooking)

• Evaluates cancellation penalties (penaltyAmount) and validates online cancellation eligibility;
• Issues a dedicated confirmId valid for 10 minutes.

​

Step 2: Confirmation & Execution (confirmCancelHotelBooking)

• The refund is automatically credited back to the original payment method.