BursaPay Logo
Knowledge Base
Ticket Sign In
Help Center > Vendor Services & Marketplace > Booking Cart & Pending Details State Machine in Client Checkout

Booking Cart & Pending Details State Machine in Client Checkout

Published 2026-08-17 6 min read
Who is this article for?
This guide is for Developers, Technical Support seeking operational guidance on BursaPay workflows.

UI Navigation Path (Step-by-Step)

  1. Client modifies cart selections (packages, add-ons, intake answers)
  2. Browser dispatches background POST to /vendor/api/checkout-save-cart/
  3. Temporary pending booking state is cached in Redis/database session
  4. Upon Paystack webhook verification, state transitions into a permanent Booking record
Executive Guide (): Technical explanation of the session cart state machine (/api/checkout-save-cart/ and /api/save-pending-details/) before Paystack payment initialization.

1. Overview & Operational Purpose

In the BursaPay ecosystem, Booking Cart & Pending Details State Machine in Client Checkout represents a core operational workflow designed for Developers, Technical Support. This comprehensive guide provides step-by-step instructions, system rules, and technical specifications to ensure seamless execution without errors or administrative delays.

Understanding this workflow ensures compliance with platform security protocols, accuracy in financial reporting, and efficient service delivery for all associated stakeholders.

2. Prerequisites & Required Documentation

Before proceeding with this workflow, verify that you have gathered all mandatory prerequisites and meet the necessary operational criteria:

  • Verified Account Credentials: Ensure you are logged in with the appropriate user persona and role permissions required for this task.
  • Active Identification & Records: Relevant records (such as Matriculation Number, CAC Business Registration, or Payment Reference IDs) must be valid and active.
  • Network & Device Compliance: Access via a secure web browser with standard security headers enabled to receive instant verification alerts.

3. Detailed Step-by-Step UI Execution Path

Follow these exact steps within your dashboard interface to complete the process:

  1. Step 1: Client modifies cart selections (packages, add-ons, intake answers)
  2. Step 2: Browser dispatches background POST to /vendor/api/checkout-save-cart/
  3. Step 3: Temporary pending booking state is cached in Redis/database session
  4. Step 4: Upon Paystack webhook verification, state transitions into a permanent Booking record
Important Notice & Safety Protocol: Ensure all input data is thoroughly cross-checked prior to final submission. Incorrect entries may require manual administrative review and prolong processing times up to 48 working hours.

4. System Boundaries, Limits & Operational Rules

To ensure system integrity and compliance, the following operational limits and validation rules apply to this feature:

Metric / Parameter Standard Requirement Validation Scope
Access Control Scope Target Audience (Developers, Technical Support) Role-Based Access Control (RBAC)
Verification Standard System OTP & Compliance Audit Automated & Manual Review
Service SLA Instant to 48 Hours Transaction & Document Verification Window

5. Processing SLA, Verification & Next Steps

Upon completing the step-by-step instructions above, your submission is immediately logged into the BursaPay audit engine. You will receive an automated confirmation email detailing your transaction status, reference code, and next steps. For requests requiring manual compliance review, allow up to 24 to 48 working hours for notification of final approval.

Was this article useful?

Related Articles

Creating a Service Listing: Lifecycle, Statuses & Publishing Guidelines End-to-End Client Booking Flow: From Discovery to Checkout Confirmation Booking Lifecycle Statuses: Pending, Confirmed, In-Progress, Completed, Disputed Service Pricing Models: Fixed Price, Base Price & Variable Rates
Ask Bursa AI