Stripe Payment Gateway

This document explains how to configure and use the Stripe Payment Gateway Addon within the KiviCare Clinic Management System. It is intended for administrators who want to accept card payments directly during appointment booking.

Overview

The Stripe Payment Gateway Addon allows clinics to accept credit and debit card payments seamlessly within the KiviCare booking flow.

The integration uses Stripe Checkout (Embedded Mode), ensuring:

• Secure card handling
• PCI compliance via Stripe
• A smooth, in-page payment experience for patients

Prerequisites

Before configuring Stripe, ensure the following requirements are met:

1. KiviCare Stripe Addon
   • The Stripe Addon must be installed and activated.
2. Stripe Account
   • A valid Stripe account created at stripe.com.
3. SSL Certificate
   • Your website must use HTTPS (required by Stripe).

Stripe Configuration in KiviCare

Step 1: Navigate to Payment Settings

1. Log in to your WordPress Admin Dashboard.
2. Go to KiviCare > Settings > Payment Settings.

Step 2: Enable Stripe Gateway

1. Locate Stripe in the list of available payment gateways.
2. Toggle the Enable switch (Green).
3. Click Manage (or the edit icon) to open Stripe settings.

Step 3: Configure Stripe Settings

Fill in the following fields:

• Enable Stripe
  Must be checked to activate Stripe payments.
• Mode
  Must be checked to activate Stripe payments.
  • Sandbox (Test) – For testing payments
  • Live – For real transactions
• Secret API Key
  Enter your Stripe Secret Key (starts with sk_).
• Publishable Key
  Enter your Stripe Publishable Key (starts with pk_).
• Currency
  Choose the currency in which payments will be processed (e.g., USD, EUR, INR).

Step 4: Save Settings

Click the Save button to apply and store your Stripe configuration.

How to Obtain Stripe API Keys

Follow these steps to retrieve your Stripe API keys:

1. Log in to the Stripe Dashboard.
2. Navigate to Developers > API Keys.

Test Mode Keys

1. Enable Test Mode using the toggle at the top-right.
2. Copy the Publishable Key (e.g., pk_test_...).
3. Reveal and copy the Secret Key (e.g., sk_test_...).

Live Mode Keys

1. Disable Test Mode.
2. Copy the Publishable Key (e.g., pk_live_...).
3. Reveal and copy the Secret Key (e.g., sk_live_...).

Important: Test keys work only in Sandbox mode, and Live keys work only in Live mode.

Payment Flow

• Patient books an appointment.
• Patient selects Stripe as the payment method.
• Stripe Checkout (Embedded Mode) loads securely on the booking page.
• Patient enters card details and completes payment.
• Upon successful payment:
  • Appointment status is updated to Confirmed.
  • Payment details are stored in KiviCare.

If payment fails or is cancelled, the appointment remains Cancelled.

Troubleshooting

Common Issues and Solutions

Payment Failed

• Verify the Secret Key and Publishable Key are correct.
• Ensure keys match the selected Mode (Test or Live).
• Confirm that your Stripe account is fully activated for live payments.

Currency Not Supported

• Ensure the selected currency is supported by Stripe.
• Check currency availability in your Stripe account settings.

“Stripe gateway is not properly configured” Error

• This error indicates the Secret API Key is missing or invalid.
• Re-check the Stripe settings in KiviCare.

Stripe Form Not Loading

Ensure your site is using HTTPS.

Best Practices

• Always test payments using Sandbox mode before switching to Live.
• Keep your Secret API Key confidential.
• Regularly review transactions from the Stripe Dashboard.