Set up PayTabs
The PayTabs gateway takes card payments on PayTabs’ payment page. A client can save their card there, and their invoices are then charged to it automatically, as with PayPal Auto-Pay and Stripe’s saved cards.
Before you start
Section titled “Before you start”- Recurring mode. Charging a saved card needs PayTabs to turn on Recurring mode for your profile. Ask your PayTabs account manager, or write to customercare@paytabs.com, and name the profile ID. Without it, paying on PayTabs’ page and saving cards still work, but each automatic charge is refused (“Method/Class/Currency combination not supported”).
- The server key. In PayTabs, open Developers → Key management and use an API key (the server key). The SDK and client keys are not used.
- Currencies. A PayTabs profile takes only the currencies PayTabs set up for it (shown on Profile, under Available payment methods). Invoices in other currencies need Convert to for processing, below.
Set it up
Section titled “Set it up”- Install PayTabs on System → Payment Gateways and open it.
- Choose your Region: the one of your PayTabs dashboard (for example Egypt for merchant-egypt.paytabs.com).
- Copy the Profile ID and the server key into the Live fields.
- Fill in Convert to for processing if your invoices are in a currency PayTabs does not take for you.
- Turn on Enabled and select Update Gateway. ClientFence checks the profile ID and the key with PayTabs before it saves them.
ClientFence gives PayTabs its own address with each payment, so there is nothing to set in PayTabs. PayTabs sends its notices only to https addresses.
Test it first
Section titled “Test it first”A PayTabs account comes with a test profile (switch profiles in PayTabs’ dashboard). Turn on Test mode, fill in the Test fields with the test profile’s ID and server key, and pay an invoice with one of PayTabs’ test cards. Ask PayTabs to turn on Recurring mode for the test profile too, to test automatic charges.
Settings
Section titled “Settings”| Setting | What it does |
|---|---|
| Pay with the saved card | A Pay now button on the invoice that pays at once (on by default). |
| Pay once without saving the card | A Pay once with a card button (on by default). Off: clients can only pay by saving their card. |
| Set up on the Payment methods page | Clients save a card without paying an invoice: PayTabs checks the card without charging it (on by default). |
| Free orders | After a free order that renews, such as a free trial, a client without a saved payment method goes to PayTabs to save a card (on by default). |
| Convert to for processing | A currency code of this portal, such as EGP. Invoices in other currencies are charged in it at the portal’s exchange rates (System → Settings → Currency). Empty: each invoice is charged in its own currency. |
With Convert to for processing, an invoice of 10 USD is charged as its EGP value, and the payment pays the invoice in full. A refund sends back the same share of the EGP payment. The transaction shows what PayTabs took, for example “PayTabs: 540.30 EGP.”
How clients pay
Section titled “How clients pay”On the invoice, the account owner selects Pay with a card and set up automatic payments, or, once a card is saved, Pay now with that card. Anyone with the invoice can select Pay once with a card. The saved card is the client’s saved method, charged as described in Saved cards and PayPal accounts. Staff can charge it now with Charge on the invoice.
When the card’s bank asks the cardholder to confirm a charge, the charge fails and the client gets the failed payment email with a link to pay the invoice. A payment PayTabs holds for review shows as Payment pending: select Process again on its transaction once PayTabs settles it. Removing the card on the Payment methods page also deletes it at PayTabs.
Moving from WHMCS
Section titled “Moving from WHMCS”The WHMCS import moves invoices and services that use WHMCS’s PayTabs gateway to this gateway (see Import from WHMCS). WHMCS’s PayTabs module saves no cards, so clients save their card once, on their next payment or on the Payment methods page.

