Payment Gateways
The gateways your platform operator has granted you. Until at least one is live, customers can search, choose and fill in passenger details — and then cannot pay.
| Section | Payments |
| Panel route | /admin/gateways |
| Access needed | Gateway → View list |
Gateways are granted to you. If the list is empty, none has been granted yet — ask your platform operator.
The two sections
The screen splits your gateways by who owns the merchant account behind them.
| Dedicated (yours) | Shared | |
|---|---|---|
| Merchant account | Yours | The platform's |
| Credentials | You enter them | Nothing to fill in |
| Needs a wallet balance | Yes | No |
| Money arrives | In your own merchant account | Via the platform |
Status on each card
| Badge | Meaning |
|---|---|
| Ready | Nothing left for you to fill in. A dedicated gateway is still offered only while your wallet can cover the payment, see below |
| Credentials required | Cannot take payments until you enter its credentials |
A banner at the top counts how many gateways still need credentials, because that state is easy to miss and costs you every sale that would have used them.
Each card also lists the services that gateway is allowed to take payment for. A card saying no service has been allowed yet cannot take payments at all — that allowance comes from your platform operator, not from you. A card showing All services has no restriction.
Wallet top-up is one of those services. A gateway takes payment for a customer topping up their wallet only when it is on the card — see Wallet Top-up.
What you can do
- Enter credentials on a dedicated gateway that has none
- Replace credentials on one that already has them
- Set fee on a dedicated gateway — a percentage plus a fixed amount
- See your platform wallet balance, which decides whether dedicated gateways can run
Entering credentials
- Choose Enter credentials on the gateway card.
- Paste each value from your provider's own dashboard. For some providers the form opens with a note on which values to get.
- Choose Save credentials.
Once saved they are stored securely and never displayed back to you. Replace credentials replaces every value for that gateway, not just the one you want to change — have them all to hand before you start.
The wallet dependency
This is the part that catches people out.
A dedicated gateway is removed from checkout whenever your platform wallet balance cannot cover the payment and its fee. Payments customers have started through your dedicated gateways, and not yet finished, are held against the balance, so less may be available than the number you see. Nothing tells you or the customer why: the option is simply not offered, and if it was the only one, the customer is told that no payment provider is available.
That is why this screen shows your wallet balance. Keep it comfortably above your largest typical booking.
The cover is not only a check. Once a customer's payment through a dedicated gateway is confirmed, the payment amount moves from your platform wallet to that customer's wallet on your store, which pays for the booking; the money itself is already in your own merchant account. The fee moves back to you.
The check uses the balance in the gateway's own currency, the one on its card. A USD gateway draws on the USD balance shown here; an IRR gateway draws on your platform's rial balance, which the panel does not show.
The gateway fee
Each dedicated gateway carries a fee you set with Set fee on its card. Shared gateways have no fee setting.
| Field | Accepts |
|---|---|
| Percentage fee (%) | Required. 0 to 100, up to two decimals |
| Fixed fee | Required. An amount in the gateway's own currency, up to two decimals. Enter 0 for none |
The fee is added on top of every payment made through that gateway. The customer pays it, and you keep it. Until you set one, the form shows the platform default, with a note saying so. Once you save a fee it replaces the default for good: saving 0 and 0 charges no fee at all, and the panel has no way back to the platform default.
The card states the fee in force, for example Fee: 2% + 1 USD.
A fee is not a markup. A markup raises the product price for everyone; a gateway fee is a surcharge attached to one payment method.
What customers see
A secure checkout page listing the available providers, carrying your store name, your refund policy, your privacy policy and a support link. Card details are entered on the provider's own page, never on your site.
Each provider in the list states its processing fee, for example +2% + $1 processing fee, and once one is chosen the payment summary shows the fee and the Total to pay. The fixed part is converted from the gateway's currency into the currency the customer is quoted in.
The fee is worked out on the whole charge, fee included, so it comes to slightly more than the bare percentage of the payment: a 2% fee on a 100 USD payment shows as 2.04 USD, for a Total to pay of 102.04 USD. The fee row still names the percentage you set.
If a gateway has been removed since they started, the list refreshes and asks them to pick again. If your wallet stops covering a dedicated gateway after the list has loaded, the payment is refused with This provider can't take this payment, and the list refreshes too. If the gateway they chose is no longer allowed for the service they are paying for, the payment is refused with This provider can't be used for this payment, and the list refreshes as well.
Questions
Why does a gateway appear for hotels but not flights? Each gateway is allowed a set of services. The card lists them.
Why can't customers top up their wallet through this gateway? Wallet top-up is not among the services on its card. Your platform operator decides that.
Can I see the credentials I entered? No. Replacing them requires every value, not just one.
Do shared gateways need a wallet balance? No. Only dedicated ones.
A customer says there is no way to pay. Work down the list in Troubleshooting.
Saving says this gateway is no longer mine to edit. Either it was withdrawn from you, or your role does not include Gateway → Set Credentials (for credentials) or Gateway → Set Fee (for the fee). The panel shows the same message in both cases, and refreshes the list.
Related
- Get paid — the full setup
- How money moves
- Wallet · Wallet Top-up · Incoming Payments · Receipts