Set up PayTabs, Quickpay, Freekassa, Worldpay, or Square

Open **Payments → Payment Gateways → Add Gateway**, select the provider, and choose **Continue**. Enter **Name**, select **Processing Currency**, and complete that provider's required fields below. Use credentials from the same live merchant account and keep secret values private. After reviewing optional settings and **Limits**, choose **Save Gateway**.

Leave provider sandbox or try-environment switches off. Leave optional custom endpoint and SDK URL fields blank to use the built-in integration. The currency and methods must also be enabled by the provider on your merchant account. Common optional fees, **Custom Exchange Rate (1 USD)**, **Mask Description** where present, and **Disable** are described in the gateway setup guides.

PayTabs

**Required provider fields:** **Account Region**, **Billing Country**, **Profile ID**, **Server Key**.

**Optional provider fields:** **Checkout Language**, **Payment Methods**, **Framed Checkout**, **Default Customer Email**, **Default Customer Phone**, **Default Customer Name**, **Billing Street**, **Billing City**, **Billing State**, **Billing ZIP**.

Choose **Account Region** and a **Processing Currency** enabled on that PayTabs account, then set the default **Billing Country**, **Profile ID**, and **Server Key**. Optional billing defaults fill missing order details. Leave **Payment Methods** blank to use the account's enabled methods. Enable **Framed Checkout** only if PayTabs has enabled it for the account.

Quickpay

**Required provider fields:** **API Key**, **Private Key**.

**Optional provider fields:** **Capture Mode**, **Checkout Language**, **Payment Methods**, **Branding ID**, **Payment Deadline Minutes**, **Auto Fee**, **Framed Checkout**, **Default Customer Email**.

Use the **API Key** and **Private Key** from your Quickpay manager and an enabled processing currency. **Capture Mode** offers auto_capture and authorize_only. Auto capture is recommended by the setup for digital orders; authorize_only reserves an amount and does not capture it immediately. Leave **Payment Methods** blank for all account-enabled methods. **Auto Fee** and **Framed Checkout** require the corresponding Quickpay setup; optional branding, language, and payment deadline settings follow your provider account.

Freekassa

**Required provider fields:** **Merchant ID**, **Secret Word**, **Secret Word 2**.

**Optional provider fields:** **Payment Method ID**, **Checkout Language**, **Default Customer Email**, **Default Customer Phone**, **Verify Freekassa IP**.

Use the Freekassa shop **Merchant ID**, **Secret Word**, and **Secret Word 2**. The first secret signs the payment request and the second verifies payment notifications. Configure the merchant-specific Result URL / URL opoveshcheniya displayed in setup, using POST notifications and confirmation if offered. Leave **Payment Method ID** blank to let the payer choose. **Verify Freekassa IP** optionally restricts notifications to the provider's documented notification IPs.

Worldpay

**Required provider fields:** **API Username**, **API Password**, **Entity**, **Statement Name**.

**Optional provider fields:** **Settlement Mode**, **Checkout Language**, **Checkout Expiry Minutes**.

Enter **API Username**, **API Password**, **Entity**, and **Statement Name** for the same live Worldpay account. Statement Name accepts letters and numbers up to 24 characters. Keep **Try Environment** off. **Settlement Mode** offers auto_settle and authorize_only; authorize_only reserves an amount without immediate settlement. Optional language and checkout expiry settings control the provider page. PayerOne order status does not replace your provider's payout or settlement records.

Square

**Required provider fields:** **Seller Country**, **Access Token**, **Location ID**.

**Optional provider fields:** **Default Customer Email**, **Support Email**.

Select **Seller Country** and a **Processing Currency** matching your Square location. Enter the live **Access Token** and **Location ID** for that seller. **Support Email** can be shown on the Square checkout; **Default Customer Email** is used only when the order omits an email. Leave **Sandbox Mode** off.

Check a new connection

Use a fresh checkout to confirm the expected provider name, processing currency, and total. If saving fails, recheck the required fields, live-account credentials, and currency selection. If the provider records a payment but the order does not update, keep the provider reference and order reference and ask support to review them before asking the customer to pay again. Never include secret values in that request.