This document explains how to configure, enable, and use the PayPal Payment Gateway in the KiviCare Clinic Management System. It is intended for administrators and site owners who want to accept online payments from patients during appointment booking.

Overview

The PayPal payment gateway allows clinics to securely accept online payments from patients using PayPal. The integration is built using the PayPal REST API, ensuring secure and reliable transaction processing.

With PayPal enabled, patients can complete appointment payments using:

• PayPal balance
• Credit cards
• Debit cards (supported by PayPal)

Prerequisites

Before configuring PayPal in KiviCare, make sure you have the following:

• A PayPal Business Account
• Access to the PayPal Developer Dashboard
• A valid SSL certificate (HTTPS enabled) on your website

PayPal 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 PayPal Gateway

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

Step 3: Configure PayPal Settings

Fill in the following fields:

• Enable PayPal
• Ensure this option is checked to activate PayPal payments.
• Mode
• Choose the environment:
  • Sandbox (Test Mode) – For testing transactions
  • Live – For accepting real payments
• Client ID
• Enter your PayPal REST API Client ID.
• Client Secret
• Enter your PayPal REST API Client Secret.
• Currency
• Select the currency you want to accept payments in (e.g., USD, EUR, INR).

Step 4: Save Settings

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

How to Obtain PayPal API Credentials

Follow these steps to generate PayPal API credentials:

1. Log in to the PayPal Developer Dashboard.
2. Navigate to Apps & Credentials.
3. Select the environment:
   • Sandbox for testing
   • Live for production payments
4. Click Create App.
5. Enter an app name (e.g., KiviCare Clinic) and click Create App.
6. After the app is created, you will see:
   • Client ID
   • Secret (click Show to reveal it)
7. Copy these values and paste them into the KiviCare PayPal settings.

Important: Sandbox credentials will only work in Sandbox mode, and Live credentials will only work in Live mode.

Payment Flow

1. Patient books an appointment.
2. Patient selects PayPal as the payment method.
3. Patient is redirected to PayPal to complete the payment.
4. After successful payment, the appointment is confirmed in KiviCare.
5. Payment status is recorded in the system.

Troubleshooting

Common Issues and Solutions

Payment Failed

• Verify that the Client ID and Client Secret are correct.
• Ensure the selected Mode matches the credentials (Sandbox or Live).
• Confirm that your PayPal account is verified and active.

Currency Not Supported

• Make sure the selected currency is supported by PayPal.
• Check PayPal documentation for supported currencies.

SSL / TLS Error

• PayPal requires HTTPS.
• Ensure your website has a valid SSL certificate installed and active.

PayPal Option Not Visible

• Confirm PayPal is enabled in KiviCare > Settings > Payment Settings.
• Clear cache and refresh the page.