Overview of Checkout and Payment

The checkout system on Bukkinhomes provides a structured, secure, and transparent process for purchasing paint, wall finishing products, and application tools. Accessible directly at the /checkout route, the platform handles orders ranging from individual retail paint cans to large-scale commercial orders.

Bukkinhomes serves customers across all 36 states of Nigeria and the Federal Capital Territory (FCT). To accommodate project managers, professional painters, property owners, and corporate contractors, the checkout workflow includes flexible fulfilment methods, optional split-deposit payment plans, agent referral discounts, and GPS location tagging for accurate site deliveries. All financial transactions are processed securely through Flutterwave using industry-standard PCI-compliant payment infrastructure.

How the Checkout Process Works

Completing a purchase on Bukkinhomes involves six steps designed to capture accurate delivery data, calculate exact logistics fees, apply eligible discounts, and secure payment.

Step 1: Customer Information

The checkout flow begins by collecting basic contact details for order processing and delivery communication:

Full Name: The primary contact name associated with the order and delivery receipt.
Email Address: Used immediately to transmit digital purchase receipts, order confirmation summaries, and status updates. This email also enables account matching for customer tracking.
Phone Number: The primary direct contact number used by dispatch coordinators and logistics personnel to coordinate on-site delivery.

Step 2: Delivery Location and GPS Coordinates

To prevent delivery delays and address misdirection across Nigeria, Bukkinhomes uses a structured location selection system:

State Selection: Customers select their destination from a comprehensive dropdown list covering all 36 Nigerian states and the Federal Capital Territory (FCT).
Local Government Area (LGA): Selecting a state dynamically filters the LGA menu, allowing the customer to choose their exact local government area.
Address and Landmark: Customers enter their physical street address along with notable nearby landmarks (e.g., specific bus stops, religious centers, or public structures).
GPS Pin Drop (Optional): Customers can drop a pin on an interactive map. The platform records exact GPS coordinates, allowing dispatch drivers to locate remote construction sites or unnumbered building projects accurately.

Step 3: Fulfilment Method Selection

Customers select between nationwide door delivery or direct pickup from the regional warehouse:

Door Delivery (Nationwide): Delivery charges are calculated automatically based on the destination state and total liquid volume (litres) or weight of the order.
- Standard Delivery: Delivered within 2 to 5 working days nationwide.
- Express Delivery (Rivers State): Delivered within 5 hours of order confirmation. Express delivery in Rivers State carries a flat add-on fee of ₦5,000.
- Express Delivery (Other States): Delivered within 12 hours to 2 days depending on the state capital and proximity. Express delivery outside Rivers State carries a flat add-on fee of ₦12,000.
Self Pickup (Port Harcourt HQ): Customers or site representatives can choose to collect their orders directly from the Bukkinhomes depot headquarters in Port Harcourt. Self pickup is 100% free of charge.

Step 4: Payment Plan Selection

Bukkinhomes offers two distinct payment structures to help customers manage their cash flow:

Option A: 60% Deposit Plan (Split Payment)
- Upfront Deposit: The customer pays 60% of the total checkout order amount immediately.
- Remaining Balance: The outstanding 40% balance is payable when the order arrives on-site before offloading.
- Use Case: Designed for contractors, large-scale commercial builders, and long-term finishing projects requiring phased cash management.
Option B: 100% Upfront Payment
- Full Payment: The customer pays 100% of the order total at checkout.
- Benefits: Speeds up order verification, streamlines logistics processing, and eliminates balance verification requirements upon site arrival.

Customers who were referred by an authorized Bukkinhomes agent can receive a direct discount on their purchase:

Manual Promo Code Entry: Customers enter an active agent promo code into the dedicated promo field during checkout.
Referral Link Auto-Fill: If a customer navigates to the store via an agent referral link (containing ?ref=CODE), the promo code automatically populates at checkout.
Discount Benefit: Applying a valid agent code subtracts 5% from the total order cost.
Validation & Protection: The system validates promo codes on the server before payment. Self-referral protection rules prevent agents from applying their own referral codes to personal purchases. Once verified, the associated agent is automatically credited with their commission earnings for the order.

Step 6: Payment Execution via Flutterwave

Payment processing is integrated directly into the checkout interface using Flutterwave:

Payment Modal: Upon clicking "Complete Order," a payment modal opens directly on desktop or mobile screens.
Supported Payment Channels:
- Debit / Credit Cards: Mastercard, Visa, and Verve cards issued by Nigerian and international banks.
- Bank Transfer: Instant bank transfers generated dynamically with custom account numbers for real-time payment matching.
- USSD Banking: Direct USSD mobile codes for all major Nigerian financial institutions.
Order Finalization: Upon successful payment processing, the system issues an immediate transaction confirmation screen, transmits an electronic receipt to the customer's registered email address, and logs the order for delivery dispatch.

What This Includes

The checkout and payment infrastructure on Bukkinhomes includes the following features and user controls:

Real-time Order Calculation: Automatic tallying of product sub-totals, delivery surcharges based on total volume and state, and promotional discounts.
Flexible Logistics Control: Choice between standard delivery, expedited express delivery, or free warehouse pickup in Port Harcourt.
Precise GPS Mapping: Location pin-drop capability to provide exact coordinates for site dispatch.
Structured Cash-Flow Options: Split deposit payment support (60% deposit / 40% on site) or full 100% upfront settlement.
Agent Discount Integration: 5% price reduction via manual code entry or URL-based referral tracking (?ref=CODE).
Multi-Channel Financial Options: Payment capabilities supporting Nigerian debit/credit cards, direct bank transfers, and mobile USSD codes.
Automated Order Tracking Integration: Immediate generation of standardized reference numbers linked directly to the order tracking portal at /orders/track.

Order Confirmation, Tracking, and Receipt Generation

Once payment is verified, the system generates a unique, formatted order reference number to identify the purchase across all systems.

Order Reference Format

Every confirmed transaction receives an order reference in the following format: BKP-YYYYMMDD-NNNNN

Prefix (BKP): Identifies the purchase as an official Bukkinhomes Platform transaction.
Date Code (YYYYMMDD): Represents the calendar year, month, and day the transaction was initiated (e.g., 20260918 for September 18, 2026).
Unique Sequence (NNNNN): A distinct five-digit numerical sequence generated for that specific order (e.g., 47263).

Example Reference: BKP-20260918-47263

Post-Payment Notifications and Tracking

Email Receipts: An official electronic receipt containing the itemized invoice, delivery destination, logistics breakdown, and unique order reference number is immediately dispatched to the customer's email address.
Customer Dashboard: Registered users can view their active and past orders by logging into their customer dashboard.
Public Tracking Route: Anyone holding a valid order reference number and associated email address can track fulfillment progress directly via /orders/track.
Agent Commission Credit: If a valid agent promo code was attached to the order, commission balances are automatically registered and credited to the referring agent's account balance.

Payment Security and Transaction Integrity

Bukkinhomes implements strict security protocols to safeguard customer funds and prevent transaction errors:

PCI-Compliant Processing: All payment processing is managed by Flutterwave. Bukkinhomes never stores sensitive bank card numbers, CVV details, or banking PINs on its local servers.
Server-Side Transaction Verification: Payment verification occurs directly between the Bukkinhomes server and Flutterwave. The platform cross-checks the total payment amount received against the actual order total calculated by the database before fulfilling any items.
Automated Webhook Monitoring: Even if a customer accidentally closes their web browser, loses internet connection, or navigates away from the page immediately after completing a payment, background webhook services catch the payment status notification directly from Flutterwave to confirm the order and issue receipts automatically.
Duplicate Order Prevention: Order state checks prevent duplicate submissions or double-charging caused by repeated clicks during network latency.
Anti-Fraud Promo Rules: Server-side checks validate agent code usage to ensure referral benefits comply with platform rules and prevent self-referral abuses.

Frequently Asked Questions

How does the 60% deposit payment plan work when my items arrive?

When selecting Option A (60% deposit now, 40% on delivery), you pay 60% of the calculated total during online checkout. Your paint and materials are mixed, packaged, and dispatched to your specified address. When our delivery team arrives at your project site, you pay the remaining 40% balance using card, transfer, or USSD before the materials are offloaded.

What happens if I close my browser before being redirected back to Bukkinhomes?

You do not need to worry about losing your money or order. Our payment system uses background webhooks that communicate directly with Flutterwave. As soon as your bank confirms the transaction, Flutterwave alerts our system automatically, updating your order status to "Confirmed" and emailing your payment receipt even if your device turned off or lost connection.

If an authorized Bukkinhomes agent gave you their referral code, enter it into the promo code box during checkout and click apply. If you visited the site using an agent's custom link containing ?ref=CODE, the discount will apply automatically. A 5% discount will be deducted from your checkout subtotal before final payment calculation.

What are the exact timelines and costs for Express Delivery?

Express Delivery for locations within Rivers State costs an additional ₦5,000 and ensures your order arrives on-site within 5 hours. For all other states across Nigeria, Express Delivery costs an additional ₦12,000 and delivers your items within 12 hours to 2 days, depending on location. Standard nationwide delivery takes between 2 and 5 working days.

Where can I find my order reference number to track my package?

Your order reference number is displayed on the order confirmation screen immediately after payment and is sent to your email address in your digital receipt. The reference number follows the format BKP-YYYYMMDD-NNNNN (for example, BKP-20260918-47263). You can enter this number along with your email at /orders/track to monitor your delivery status.