Payment Flow — Pay at the Hotel#

payMethodId: 2

Page Flow Overview#

🏠 Home Page (Loading Reference Data)#

API Calls#

Load All Room Types#

Load Hotel Details#

Load Hotel Rules#

📅 Booking Page (Checking Room Availability)#

API Call#

Check Availability#

{
    "errorCode": 0,
    "errorMessage": "Successfully retrieved available rooms.",
    "types": [
        {
            "roomTypeId": 3,
            "roomType": "Premium Suite",
            "rate": 40000,
            "available": 3,
            "currencySymbol": "₦"
        }
    ]
}

💾 Store roomTypeId and rate for the room the guest selects — both are required on the Checkout Page.

⚠️ Only display rooms where available > 0.

👤 Guest Detail Page (Entry for Guest Details)#

API Call#

Look Up Existing Guest#

{
    "detail": {
        "title": "Mrs",
        "firstName": "Jane",
        "lastName": "Smith",
        "phone": "08030000001",
        "email": "jane.smith@example.com",
        "sex": "Female",
        "occupation": "Doctor",
        "country": "Nigeria",
        "state": "FCT",
        "address1": "5, Sample Avenue",
        "address2": "",
        "city": "Abuja"
    },
    "errorCode": 0,
    "errorMessage": "Guest detail retrieved successfully."
}

{
    "detail": null,
    "errorCode": -200,
    "errorMessage": "Guest not found."
}

💡 If errorCode is -200, the guest is new — display a blank form for them to fill in their details manually.

💾 Store all guest details — they are required in the reservation payload on the Checkout Page.

Supporting Reference Data#

📋 Booking Preview (Review and Confirm Details Filled)#

Data Displayed#

✅ This is the guest's last chance to review and edit before checkout. Provide a Back button to return to the Guest Detail Page if needed.

💳 Checkout Page (Choose Method of Payment)#

API Call#

Load Active Payment Methods#

{
    "items": [
        { "id": 1, "name": "Book On Hold" },
        { "id": 2, "name": "Pay at the Hotel" },
        { "id": 4, "name": "Paystack" }
    ],
    "errorCode": 0,
    "errorMessage": "Successfully retrieved payment methods."
}

💾 Store the selected id as payMethodId — required in the reservation payload.

Add Reservation#

{
    "bookingRef": "K3PLW9",
    "errorCode": 0,
    "errorMessage": "Reservations made successfully"
}

{
    "bookingRef": "",
    "errorCode": -100,
    "errorMessage": "Validation failed. Guest first name is required."
}

💾 Store the bookingRef — used on the next page to retrieve and display the booking confirmation.

✅ Payment Success Page (Reservation Confirmed)#

API Call#

Get Booking Detail#

{
    "guest": {
        "firstName": "Jane",
        "lastName": "Smith",
        "email": "jane.smith@example.com"
    },
    "reservations": [
        {
            "roomType": "Premium Suite",
            "bookingRef": "K3PLW9",
            "checkInDate": "2025-09-15",
            "checkOutDate": "2025-09-16",
            "arrivalTime": "03:00 PM",
            "quantity": 1,
            "rate": 40000
        }
    ],
    "errorCode": 0,
    "errorMessage": "Reservation details retrieved successfully."
}

📋 Display the bookingRef prominently. The guest will need it to look up or cancel their reservation.

🏨 Remind the guest to present their booking reference and a valid ID at the front desk upon arrival.

📩 Send a confirmation email to the guest containing their bookingRef, check-in time, check-out time, and the total amount due on arrival.

Payment Object Reference#

Field Sources — Quick Reference#

Important Notes#

💡 The room is held for the guest but not guaranteed beyond the hotel's cancellation window. Check GET /Rule/Detail for the minCheckInWindow to understand when a held reservation may be released.

⚠️ The hotel reserves the right to release the room if the guest does not arrive by the standard check-in time without prior notice.