OSOSS Help Center
العربيةOpen Dashboard

Payment Gateways

Payment Gateways is where the online payment providers behind your checkout are connected and priced. Each gateway in the list is a provider OSOSS can talk to; opening its configuration is where you paste the credentials from your provider agreement, declare which currencies it accepts, and decide who absorbs the provider's transaction fee - you or the customer. Nothing takes a real payment until this is filled in.

Menu path: Settings > Gateways

How gateways work in OSOSS

There are three layers, and confusing them is the usual source of trouble:

LayerWhat it is
GatewayThe provider account: credentials, currencies, fees. Configured on this page.
Payment methodWhat the customer actually sees and clicks at checkout. Configured under Payment Methods.
TransactionEach attempt and its result, recorded under Online Payments.

So a gateway is plumbing. It has no effect on a customer until a payment method points at it, and its results are only auditable once transactions start arriving.

Some providers are not single accounts but families - a processor that fronts several banks or wallets. Those expose a Sub gateway selector at the top of the configuration, and choosing a sub gateway reloads the form with that sub gateway's own credential fields and its own fee settings. Configure each sub gateway you intend to use; they are saved separately.

Configure a gateway

  1. Find the provider in the list and open its settings icon. The configuration drawer opens.
  2. If a Sub gateway selector appears, choose the one you are configuring first. The rest of the form depends on it.
  3. Set the display Name and upload a Logo if you want the customer to see the provider's branding rather than the default.
  4. Fill in the provider's required fields. These are generated from what the provider needs - merchant identifiers, keys, terminal numbers - and come from your agreement with them, not from OSOSS.
  5. Enter the Fixed fee and Rate fee the provider charges you. These are what OSOSS uses to calculate the fee on each transaction.
  6. Choose the Currencies the gateway may take, and set Unsupported currency handling: either reject an order in a currency the gateway does not accept, or convert it to your default currency first.
  7. In the fees section, decide who pays: fees on company, fees on customer, or a custom split where you enter the percentage the company absorbs.
  8. Click Save.

Reading the fee choice correctly

The fee setting is a commercial decision that reaches your customer. With fees on the company, the customer pays the order total and the provider's cut comes out of your revenue. With fees on the customer, the fee is added on top of what they expected to pay - which is legitimate in some markets and a checkout abandonment cause in others. The custom split lets you absorb a percentage and pass on the rest, which is the usual compromise on high-value orders.

Tip: After any credential change, put a small real transaction through the live checkout and then confirm it appears under Online Payments. A gateway that saves cleanly can still fail at the provider's end, and the place you do not want to discover that is a customer's basket.
Note: Gateways distributed as add-ons are configured from the Marketplace instead of here, from the installed card's own settings. If a provider you expect is missing from this list, look for it there.
Warning: Currencies and unsupported-currency handling change what happens to real orders. Setting the handling to reject on a gateway with a narrow currency list turns away paying customers without an explanation they can act on.

Related pages