Payment Configuration

2.3k переглядів Markdown

Connect your payment provider account to WISECP; choose the 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 offered methods, their order and the card storage provider.

All Modules offers name search, status and, where available, category and region filters; on narrow screens, open Filters & Search.

Fields

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

Provider Settings

A module card 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. A negative rate is not saved. Changing the rate or disabling the method recalculates the unpaid invoices on this method at the new rate. Invoices with a partial payment are not changed. The change is recorded in the invoice history. Invoices left without commission are not recalculated when the method is re-enabled. In 5.0-beta.3 and earlier, open invoices keep the old rate.
  • Provider Fee Rate (%): the share the provider keeps from each payment. It is used only for the estimated provider cost in reports and is never charged to the client. Leave empty if unknown. Not available in 5.0-beta.3 and earlier.
  • Converting Currency: sets the currency sent to the provider. None applies no forced conversion.
  • Accepted Amount Range: lower and upper bounds, and their currency.
  • Accepted Countries: empty means no country restriction. When populated, the method appears in those countries. Unaccepted Countries excludes selected countries. Both follow the billing country (outside checkout, the default billing profile's country).
  • Update Subscription Fee: supported modules apply price changes to existing subscriptions. See Subscriptions.
  • Callback URL, Success URL, Failed URL: addresses that provider settings may require; the module guide says where each belongs.

Tasks

Connect a Provider Account

  1. Prepare your provider account and access credentials. Follow the module guide below for account approval, API credentials and notification settings.
  2. Open the provider’s card under All Modules; where present, check Status → Enable to make the settings editable.
  3. Complete account credentials and the options you need.
  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; selection 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, then 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 commission and installment charge.

Things to Watch

Keep a Payment Option Available

Methods outside their amount or country conditions are hidden, as is a method whose limit currency cannot be converted. Guests never see Bank Transfer or Account Balance; if only these fit an order, checkout asks the guest to sign in. Keep at least one method for your clients’ amounts and countries, and one that guests can use.

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

Saved cards belong to their provider; choosing another module does not move them. Check card storage, automatic payment and subscription support in the module guide.

Declined Payments Leave a Trace

When a provider refuses the payment, the checkout page shows a failure notice. Any reason the provider sent appears under that notice and in Tools → Module Logs, on that provider’s row.

When a Setting Cannot Be Saved

If saving reports that a file cannot be written, nothing was saved. The named file or its folder belongs to another user, often root. Make them owned by the user your site runs as, or ask your hosting provider, then save again. Scheduled Tasks Setup explains how to run the cron job as that user.

Deprecated

A module with this badge works only where it is already enabled; once switched off, it cannot be enabled again.

Turkish Lira Only (iPara, PosFix)

iPara and PosFix charge in Turkish lira only. Invoices in another currency are refused at the card step unless Converting Currency is TRY; then the amount is converted and the payment is recorded in TRY.

Required Privileges

Managing these settings requires the Payment Gateways privilege.

For module installation and list management, see Module Management.

Ця стаття була корисною?

Дякуємо за відгук!

Досі потрібна допомога?

Наша служба підтримки на зв’язку цілодобово з усього, чого ви не знайшли вище.