Skip to content

Getting Started & Installation

System requirements, installation guide, 3-step setup wizard, and first-time configuration for GatewayKit.

Buy Pro Pro GitHub

Install GatewayKit, run the 3-step setup wizard, and configure your basic currency and receipt settings in less than five minutes.

System Requirements

Before installing GatewayKit, verify your server meets these lightweight requirements:

RequirementMinimumRecommendedNotes
WordPress6.27.1+Block Editor / Gutenberg fully supported
PHP7.48.0 / 8.1 / 8.2 / 8.3Platform pinned to 7.4+
DatabaseMySQL 5.7+ / MariaDB 10.3+LatestUses WordPress $wpdb tables
HTTPS (SSL)RequiredRequiredMandatory for Stripe, PayPal, and modern payment APIs
ElementorOptionalGatewayKit works 100% standalone; Elementor Free/Pro supported if installed

No Elementor requirement: GatewayKit does not require Elementor or Elementor Pro. It includes its own visual Form Builder, native Gutenberg block, and universal shortcode. If you already use Elementor, GatewayKit provides seamless integration out of the box.

Installation Guide

Step 1 — Install GatewayKit (Free)

Option A — From WordPress.org (recommended)

  1. Go to WordPress Admin → Plugins → Add New.
  2. Search for “GatewayKit”.
  3. Click Install Now, then Activate.

Option B — Manual upload

  1. Download the GatewayKit ZIP from WordPress.org or GitHub.
  2. Go to Plugins → Add New → Upload Plugin.
  3. Choose the ZIP file, click Install Now, then Activate.

Step 2 — 3-Step Setup Wizard

Upon first activation, GatewayKit launches an intuitive 3-Step Setup Wizard (accessible anytime from the admin):

  1. Currency Setup: Choose your primary transaction currency (e.g. USD, EUR, GBP, CAD, AUD, INR).
  2. Gateway Activation: Select which payment processors you want to activate (Stripe, PayPal, Mollie, Crypto, etc.) and paste your API keys.
  3. Starter Forms: Automatically generate ready-to-use sample forms (Donation Form, Simple Checkout) and an automatic Payment Receipt page (/payment-receipt/).

Step 3 — Install GatewayKit Pro (Optional Add-on)

  1. Purchase GatewayKit Pro and download the gatewaykit-pro.zip package from your Freemius receipt.
  2. Go to Plugins → Add New → Upload Plugin and upload the ZIP.
  3. Click Activate.
  4. Enter your license key on the GatewayKit Pro account screen to unlock premium features.

The order matters: GatewayKit core must be activated first. If you activate Pro while GatewayKit is absent, Pro displays a friendly notice: “GatewayKit Pro requires GatewayKit to be installed and activated.” Both plugins install into separate folders (gatewaykit/ and gatewaykit-pro/).

Activation Behavior

On activation, GatewayKit:

  • Creates its database tables (transactions, logs, discounts, discount usage) with the complete final schema in one step.
  • Records the current database version so no migration prompt appears on fresh installs.
  • Schedules a daily cleanup of old payment logs (30-day retention by default).
  • Sets sensible default options without tracking or phone-home telemetry.

First-Time Setup

Fine-tune your global payment configuration in the WordPress Admin under GatewayKit → Settings:

  1. Store Currency: Choose your default store currency. Only currencies supported by your active gateway(s) are shown to prevent checkout errors.
  2. Receipt Email: Set the From name, From email, and subject for receipts emailed automatically to customers after payment.
  3. Log Level: Select Error (recommended for production) or Debug (useful when troubleshooting webhooks).
  4. Print Mode: Choose whether printing a receipt outputs only the receipt card or the full page.
  5. Rate Limiting: Configure per-endpoint submission limits to protect against automated card testing and bot attacks.

Admin Menu Structure

GatewayKit adds a dedicated top-level GatewayKit menu in the WordPress admin bar:

PagePurpose
Payment FormsVisual list of all forms (gatewaykit_form CPT). Create, edit, duplicate, or preview forms.
Add New FormOpen the visual drag-and-drop form editor with starter templates.
DashboardOverview of totals, success rate, gateway stats, and recent transactions.
TransactionsSearchable, filterable list of all payments; date-range filtering; CSV export (Pro).
Payment LinksGenerate shareable Stripe checkout links for a fixed amount — no form needed. Send by email, WhatsApp, or Telegram.
Analytics ProRevenue charts, gateway breakdown, success rate, and top forms. Previewable on Free.
Discounts ProCreate promo coupon codes (fixed/percentage) with expiry dates and usage limits. Previewable on Free.
Subscriptions ProMonitor recurring Stripe subscriptions, renewals, and cancellations. Previewable on Free.
SettingsCurrency, receipt email, log level, rate limits, gateway credentials, webhooks, and White Label.
LogsStructured payment logs with level/transaction filtering, copy & export.
Usage GuideIn-plugin quick-start guide and shortcode reference.

Need more help?