Payment GatewaysTap Payments

Tap Payments

Connect Tap Payments to PayLexer to accept card and digital wallet payments across the Middle East and GCC through a secure hosted checkout.

Tap Payments is a Middle East and North Africa (MENA) focused payment gateway that processes card, digital wallet, and local payment methods through a secure, hosted checkout page. Through PayLexer, Tap supports one-time payments with separate Test (Sandbox) and Live (Production) environments so you can validate the full payment flow before going live.

  • Supported Regions (Merchant Accounts): GCC and wider MENA markets (UAE, Saudi Arabia, Kuwait, Bahrain, Oman, Qatar, and more)

  • Supported Currencies: AED, BHD, EUR, GBP, KWD, OMR, QAR, SAR, USD

Supported Features

  • Card and digital wallet payments via Tap's hosted checkout page

  • Test (Sandbox) and Live (Production) environments selected automatically by your API key prefix

  • Coverage across GCC and wider MENA markets

  • One-time payments only - subscriptions and refunds are not supported through PayLexer for Tap

Before You Start

Make sure you have:

Looking for a different payment processor? View all supported gateways →

Configuring Tap Payments

You need a Secret API Key from Tap for this integration. Tap issues a single secret key per environment, and the key prefix decides which environment it belongs to:

  • Test (Sandbox) keys start with sk_test_

  • Live (Production) keys start with sk_live_

You generate both keys from the same Tap Dashboard.

Getting API Credentials

Open API Credentials in the Tap Dashboard

Log in to your Tap Dashboard, then go to Developers → API Credentials.

Generate and copy your Secret API Key

Click Generate Key to reveal your Secret API Key, then copy it. Repeat for both environments so you have a sk_test_ key for testing and a sk_live_ key for production.

Your Secret API Key is a server-side credential. Never expose it in front-end code, share it in chat, email, or a support ticket. If you suspect it has been exposed, regenerate it in the Tap Dashboard and update PayLexer with the new value.

Adding Credentials to PayLexer

Open PayLexer Dashboard

Log in to your PayLexer dashboard and navigate to Payment Gateways → Tap Payments.

PayLexer Payment Gateways section with Tap Payments listed
PayLexer Payment Gateways section with Tap Payments listed

Enter your credentials

Paste your Live and Test keys into the respective fields:

  • Secret API Key (Live) - your sk_live_ key from the Tap Dashboard

  • Secret API Key (Test) - your sk_test_ key from the Tap Dashboard

PayLexer Tap Payments credentials form with Live and Test Secret API Key fields
PayLexer Tap Payments credentials form with Live and Test Secret API Key fields

Understanding Live/Production and Sandbox Settings:

EnvironmentPurpose
Live / Production (Mandatory)Used for real transactions. Cannot be empty, even when testing.
Test / Sandbox (Optional)Used for testing only. No real money is processed.

How PayLexer selects credentials:

  • Debug/Test mode ON → Test credentials are used

  • Debug/Test mode OFF → Live credentials are used

Save your configuration

Click Save Configuration. PayLexer validates the key against Tap's API and shows Connected when authentication succeeds.

Credentials saved. You can now enable Tap Payments on any of your websites.

Integrate Tap Payments to Your Website

If you have already added and configured your site, you can enable Tap Payments in your existing setup.

Go to Websites

Navigate to Websites in your PayLexer dashboard.

PayLexer Websites list showing added websites
PayLexer Websites list showing added websites

Edit your website

Click the Edit Icon of your added website.

Enable Tap Payments

Click the checkbox to enable Tap Payments for the website.

PayLexer website edit page with Tap Payments checkbox enabled
PayLexer website edit page with Tap Payments checkbox enabled

Tap Payments is now active for this website. Run a test transaction before switching off Debug/Test mode.

If you haven't added a website yet, Continue to Add Your Website →

Troubleshooting

Best Practices

  • Run at least one full test transaction in Sandbox before switching Debug/Test mode off. Use your platform's Test Mode toggle together with your sk_test_ key.

  • Keep your Secret API Key server-side at all times. Never paste it into chat, email, or a support ticket. If you suspect it has been exposed, regenerate it from the Tap Dashboard and update PayLexer immediately.

  • Confirm the checkout currency matches your Tap merchant account configuration. If your Tap account is not enabled for a currency, Tap will reject the charge.

  • Double-check the key prefix before saving. A sk_test_ key in the Live field (or the reverse) is the most common cause of failed connections.

FAQs

Still Have Questions?

For Tap Payments API references and advanced configuration, see the Tap Payments developer documentation.

Was this page helpful?