Jump to content

Tap Checkout For WHMCS

From WHMCS Tech Lab Documentation

Tap Checkout For WHMCS

[edit | edit source]

Overview

[edit | edit source]

Tap Checkout For WHMCS allows you to accept secure online payments through Tap Payments directly inside WHMCS.

Features

[edit | edit source]
  • Secure Hosted Payment Gateway
  • Invoice Payments
  • Multi Currency Support
  • Webhook Support
  • Automatic Invoice Payments
  • Sandbox & Live Mode

Requirements

[edit | edit source]
Requirement Version
WHMCS 8.x+
PHP 8.1+
SSL Required

Installation

[edit | edit source]

Upload Files

[edit | edit source]

Upload the module files to:

<syntaxhighlight lang="bash"> /modules/gateways/ </syntaxhighlight>

Activate Gateway

[edit | edit source]

Navigate to:

System Settings > Payment Gateways

Activate:

  • Tap Checkout

Configuration

[edit | edit source]

API Credentials

[edit | edit source]

Collect the following credentials from your Tap Payments dashboard:

  • Public Key
  • Secret Key

Gateway Setup

[edit | edit source]

Navigate to:

System Settings > Payment Gateways > Tap Checkout

Fill the following fields:

Field Description
Public Key Tap publishable key
Secret Key Tap secret API key
Sandbox Mode Enable for testing

Webhooks

[edit | edit source]

Callback URL

[edit | edit source]

Configure this webhook URL inside Tap Dashboard:

<syntaxhighlight lang="text"> https://yourdomain.com/modules/gateways/callback/tapcheckout.php </syntaxhighlight>

Supported Events

[edit | edit source]
  • payment.authorized
  • payment.captured
  • payment.failed

Supported Currencies

[edit | edit source]
  • USD
  • EUR
  • AED
  • SAR
  • KWD
  • BHD

Troubleshooting

[edit | edit source]

Callback Not Working

[edit | edit source]

Check:

  • SSL certificate
  • Callback URL
  • Firewall restrictions

Invalid API Keys

[edit | edit source]

Verify:

  • Sandbox keys
  • Live keys
  • Correct permissions

Invoice Not Marked Paid

[edit | edit source]

Ensure webhook events are enabled correctly.

Does this support recurring billing?

[edit | edit source]

Yes, depending on your Tap account configuration.

Does this support sandbox mode?

[edit | edit source]

Yes.

Is WHMCS 8.x supported?

[edit | edit source]

Yes.

Changelog

[edit | edit source]

Version 1.0.0

[edit | edit source]
  • Initial Release
  • WHMCS 8.x Support
  • Tap Payments Integration