{"id":2579,"date":"2026-01-24T08:34:56","date_gmt":"2026-01-24T08:34:56","guid":{"rendered":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/?p=2579"},"modified":"2026-01-31T07:30:28","modified_gmt":"2026-01-31T07:30:28","slug":"woocommerce-payment-gateway","status":"publish","type":"post","link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/kivicare-pro\/documentation\/payment-integration\/woocommerce-payment-gateway\/","title":{"rendered":"WooCommerce Payment Gateway"},"content":{"rendered":"
\n
\n\n\n\n

This document explains how to configure and use the WooCommerce Payment Gateway<\/strong> within the KiviCare Clinic Management System<\/strong>. This integration allows KiviCare to leverage WooCommerce\u2019s checkout and payment ecosystem for appointment payments.<\/p>\n\n\n\n

Overview<\/strong><\/h2>\n\n\n\n

The WooCommerce integration enables clinics to accept payments for KiviCare appointments using any payment gateway supported by WooCommerce.<\/p>\n\n\n\n

When a patient books an appointment:<\/p>\n\n\n\n

    \n
  • KiviCare dynamically creates a temporary WooCommerce product<\/strong><\/li>\n\n\n\n
  • The product is added to the cart<\/li>\n\n\n\n
  • The patient is redirected to the WooCommerce checkout flow<\/strong> to complete payment<\/li>\n<\/ul>\n\n\n\n

    This approach provides maximum flexibility by supporting all WooCommerce-compatible payment gateways.<\/p>\n\n\n\n

    Prerequisites<\/strong><\/h2>\n\n\n\n

    Before enabling WooCommerce payments in KiviCare, ensure the following requirements are met:<\/p>\n\n\n\n

      \n
    1. WooCommerce Plugin<\/strong>\n
        \n
      • WooCommerce must be installed and activated on your WordPress site.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
      • WooCommerce Payment Gateways<\/strong>\n
          \n
        • At least one payment method must be configured and enabled in WooCommerce (e.g., Stripe, PayPal, Razorpay, BACS, Cash on Delivery).<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n
          \n\n\n\n

          WooCommerce Configuration in KiviCare<\/strong><\/h2>\n\n\n\n

          Step 1: Navigate to Payment Settings<\/strong><\/h4>\n\n\n\n
            \n
          1. Log in to the WordPress Admin Dashboard<\/strong>.<\/li>\n\n\n\n
          2. Go to KiviCare > Settings > Payment Settings<\/strong>.<\/li>\n<\/ol>\n\n\n\n

            Step 2: Enable WooCommerce Gateway<\/strong><\/h4>\n\n\n\n
              \n
            1. Locate WooCommerce<\/strong> in the list of available payment gateways.<\/li>\n\n\n\n
            2. Toggle the Enable<\/strong> switch (Green).<\/li>\n<\/ol>\n\n\n\n

              Note:<\/strong> There are no additional configuration fields inside KiviCare for WooCommerce. All payment-related settings are managed directly from WooCommerce.<\/p>\n\n\n\n

              \n\n\n\n

              How the WooCommerce Payment Flow Works<\/strong><\/h2>\n\n\n\n

              Appointment Booking<\/strong><\/h4>\n\n\n\n
                \n
              1. A patient selects a service and proceeds to payment.<\/li>\n\n\n\n
              2. KiviCare automatically creates a hidden Simple Product<\/strong> in WooCommerce:\n
                  \n
                • Product price = Appointment cost<\/li>\n\n\n\n
                • Product type = Virtual<\/li>\n\n\n\n
                • Catalog visibility = Hidden<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                • Applicable KiviCare taxes are added as Fees<\/strong> in the WooCommerce cart.<\/li>\n<\/ol>\n\n\n\n

                  Checkout Process<\/strong><\/h4>\n\n\n\n
                    \n
                  1. The patient is redirected to the WooCommerce Checkout page<\/strong>.<\/li>\n\n\n\n
                  2. The patient completes payment using any enabled WooCommerce payment method.<\/li>\n<\/ol>\n\n\n\n
                    \n\n\n\n

                    Order & Appointment Status Mapping<\/strong><\/h2>\n\n\n\n

                    The appointment status in KiviCare is automatically updated based on the WooCommerce order status:<\/p>\n\n\n\n

                    WooCommerce Order Status<\/th>KiviCare Appointment Status<\/th>Status ID<\/th><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                    Completed<\/td>Booked<\/td>1<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                    Processing<\/td>Pending<\/td>2<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                    Failed \/ Cancelled<\/td>Cancelled<\/td>0<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                    Important:<\/strong> Appointments are Booked only<\/strong> when the WooCommerce order status becomes Completed<\/strong>.<\/p>\n\n\n\n

                    \n\n\n\n

                    Auto-Cancellation Mechanism<\/strong><\/h2>\n\n\n\n

                    To avoid appointment slot blocking due to unpaid bookings, KiviCare includes an automatic cancellation feature:<\/p>\n\n\n\n

                    If a patient is redirected to WooCommerce checkout but does not complete payment<\/strong>, the appointment is automatically cancelled.<\/p>\n\n\n\n

                    Troubleshooting<\/strong><\/h2>\n\n\n\n
                    Common Issues and Solutions<\/strong><\/h5>\n\n\n\n
                    WooCommerce Not Active Error<\/strong><\/h6>\n\n\n\n

                    Ensure the WooCommerce plugin is installed and activated.<\/p>\n\n\n\n

                    Redirect Loop or 404 on Checkout<\/strong><\/h6>\n\n\n\n
                      \n
                    • Verify WooCommerce pages:\n
                        \n
                      • Go to WooCommerce > Status > Tools<\/strong><\/li>\n\n\n\n
                      • Click Create default WooCommerce pages<\/strong><\/li>\n<\/ul>\n<\/li>\n\n\n\n
                      • Confirm that a valid Checkout page<\/strong> is assigned.<\/li>\n<\/ul>\n\n\n\n
                        Appointment Not Confirmed<\/strong><\/h6>\n\n\n\n
                          \n
                        • Check the WooCommerce order status.<\/li>\n\n\n\n
                        • Appointments are confirmed only when the order status is Completed<\/strong>.<\/li>\n\n\n\n
                        • Some gateways keep orders in Processing<\/strong> status:\n
                            \n
                          • Manually complete the order, or<\/li>\n\n\n\n
                          • Use a plugin to auto-complete virtual orders.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
                            \n\n\n\n

                            Best Practices<\/strong><\/h2>\n\n\n\n
                              \n
                            • Use Virtual + Auto-Complete Order<\/strong> settings for smoother confirmation.<\/li>\n\n\n\n
                            • Test the full booking flow after enabling a new WooCommerce payment gateway.<\/li>\n\n\n\n
                            • Regularly monitor WooCommerce orders linked to appointments.<\/li>\n<\/ul>\n\n\n\n

                              <\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"

                              This document explains how to configure and use the WooCommerce Payment Gateway within the KiviCare Clinic Management System. This integration allows KiviCare to leverage WooCommerce\u2019s checkout and payment ecosystem for appointment payments. Overview The WooCommerce integration enables clinics to accept payments for KiviCare appointments using any payment gateway supported by WooCommerce. When a patient books […]<\/p>\n","protected":false},"author":12,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[71],"tags":[],"class_list":["post-2579","post","type-post","status-publish","format-standard","hentry","category-payment-integration-kivicare-pro"],"featured_image_src":null,"author_info":{"display_name":"wordpressadminiq","author_link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/author\/wordpressadminiq\/"},"_links":{"self":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/2579","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/comments?post=2579"}],"version-history":[{"count":9,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/2579\/revisions"}],"predecessor-version":[{"id":2844,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/2579\/revisions\/2844"}],"wp:attachment":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/media?parent=2579"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/categories?post=2579"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/tags?post=2579"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}