# Payment Configuration

https://docs.wisecp.com/uk/payment-modules

Connect your payment provider account to WISECP and choose the payment methods, display order and card storage option offered to clients.

## Reaching the Screen

Go to **Settings → Financial → Payment Gateways**: `{admin}/module/payment`.

## What Is on the Screen

First open the provider’s card under **All Modules** and complete its account settings. Then use **Initial** to manage available methods, their display order and the card storage provider.

**All Modules** includes name search and a status filter. Use category and region filters where available. On narrow screens, open **Filters & Search**.

## Fields

- ****Enabled Module Selection****: Select at least one suitable method to accept payments. You can select multiple modules and drag the selected items to arrange their order on the client’s screen.
- ****Card Storage Module****: Optional. Select a compatible provider so clients can reuse their cards for later payments. Leave **None** selected if you do not need card storage.

### Provider Settings

A module card under **All Modules** may include these shared options alongside account credentials. Available fields differ between providers.

- **Status → Enable**: makes the module available. Account fields may be disabled while this is unchecked.
- **Commission Rate (%)**: the percentage added to a client’s payment when they select this method. Leave empty for no extra charge.
- **Converting Currency**: sets the currency sent to the provider. **None** applies no forced conversion.
- **Accepted Amount Range**: lower and upper bounds, and their currency. Leave any unwanted bound empty.
- **Accepted Countries**: empty means no country restriction. When populated, the method appears in those countries. **Unaccepted Countries** excludes selected countries. The restriction follows the billing country the customer enters at checkout: while no country is selected yet, methods that restrict by country are not listed, and the list refreshes as soon as the customer picks their country.
- **Update Subscription Fee**: supported modules apply price changes to existing subscriptions. See [Subscriptions](https://docs.wisecp.com/en/subscriptions).
- **Callback URL**, **Success URL**, **Failed URL**: addresses that provider settings may require. Check the module guide for where each address belongs.

## Tasks

### Connect a Provider Account

1. Prepare your provider account and access credentials. Follow the relevant module guide below for account approval, API credentials and notification settings.
2. Open the provider’s card under **All Modules**. Where present, check **Enable** under **Status** to make the settings editable.
3. Complete account credentials and the options you need. Configure the provider’s notification or webhook settings as described in its module guide.
4. Click **Save Changes**. Saving an enabled module adds it to your payment methods; check its selection under **Initial**.

### Choose Methods to Offer Clients

1. Open **Initial**.
2. Under **Enabled Module Selection**, select the methods you configured and remove those you do not want to offer.
3. Click **Save Changes**. Eligible methods appear on the client’s payment screen. Selecting a method here does not complete provider account setup.

### Reorder Payment Methods

1. Under **Initial → Enabled Module Selection**, drag a selected module to its new position.
2. Click **Save Changes**. Checkout, invoice payment, bulk payment and adding funds list eligible methods in this order, with the first eligible method selected.

### Choose a Card Storage Provider

1. Under **Initial → Card Storage Module**, choose your configured provider. The list contains only modules that support card storage.
2. The provider also stays selected under **Enabled Module Selection**. To remove it there, first change the card storage provider or select **None**.
3. Click **Save Changes**. New card storage operations use this provider. Clients see **Credit or Debit Card** at its position in the list.

### Set Amount Limits

1. Open the provider’s card under **All Modules** and find **Accepted Amount Range**, if available.
2. Fill in **Minimum Accepted Amount** and **Maximum Accepted Amount**. Select the **Limit Currency**. Leave unwanted bounds empty; the upper bound cannot be below the lower bound.
3. Click **Save Changes**. The method is offered when the payable total is within the range. The check uses the total before this method’s commission and installment charge.

## Things to Watch

> **Keep a Payment Option Available**
> 
> Methods outside their amount or country conditions are hidden. Limits in another currency are converted; failed conversion hides the method. Keep at least one method covering your intended clients’ amounts and countries.

> **Verify Before Going Live**
> 
> Use the provider’s test account and module guide to check that payment results reach WISECP. Testing with a live account can create a real charge.

> **Changing Card Storage**
> 
> Existing saved cards belong to their providers; choosing another module does not move cards to the new provider. Check card storage, automatic payment and subscription support separately in the module guide.

> **Declined Payments Leave a Trace**
> 
> When a provider refuses the payment and sends the client back, the checkout page shows a failure notice. If the provider sent a reason, it appears under that notice. The same reason is kept in Tools → Module Logs, on that provider’s row. Open the row to read the provider’s response before asking the client to try again.

> **When a Setting Cannot Be Saved**
> 
> If saving reports that a file cannot be written, the save did not complete. The file named in the message, or its folder, belongs to another user. When scheduled tasks run as root, that user is often root. Make them owned by the user your site runs as, then save again. Until then the payment method is not switched on or off. Your hosting provider can do this for you. [Scheduled Tasks Setup](https://docs.wisecp.com/en/scheduled-tasks-setup) explains how to run the cron job as that user.

## Required Privileges

Managing these settings requires the **Payment Gateways** privilege.

## Provider Guides

- [Stripe (Checkout) Module](https://docs.wisecp.com/en/stripe-checkout-module)
- [Stripe (Tokenized) Module](https://docs.wisecp.com/en/stripe-tokenized-module)
- [PayPal Module](https://docs.wisecp.com/en/paypal-module)
- [PayTR Module](https://docs.wisecp.com/en/paytr-module)
- [iyzico Module](https://docs.wisecp.com/en/iyzico-module)

For module installation and list management, see [Module Management](https://docs.wisecp.com/en/module-management).