Jump to content

Tap Checkout For WHMCS: Difference between revisions

From WHMCS Tech Lab Documentation
Tap Payment Gateway for WHMCS
 
No edit summary
 
Line 1: Line 1:
= Tap Checkout For WHMCS =
= Tap Checkout For WHMCS =


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


== Features ==
== Features ==
Line 10: Line 10:
* Invoice Payments
* Invoice Payments
* Multi Currency Support
* Multi Currency Support
* Callback/Webhook Handling
* Webhook Support
* WHMCS Order Integration
* Automatic Invoice Payments
* Automatic Invoice Marking
* Sandbox & Live Mode


== Requirements ==
== Requirements ==
{| class="wikitable"
|-
! Requirement
! Version
|-
| WHMCS
| 8.x+
|-
| PHP
| 8.1+
|-
| SSL
| Required
|}
== Installation ==
=== Upload Files ===
Upload the module files to:
<syntaxhighlight lang="bash">
/modules/gateways/
</syntaxhighlight>
=== Activate Gateway ===
Navigate to:
System Settings > Payment Gateways
Activate:
* Tap Checkout
== Configuration ==
=== API Credentials ===
Collect the following credentials from your Tap Payments dashboard:
* Public Key
* Secret Key
=== Gateway Setup ===
Navigate to:
System Settings > Payment Gateways > Tap Checkout
Fill the following fields:
{| class="wikitable"
{| class="wikitable"
!Requirement
!Version
|-
|-
|WHMCS
! Field
|8.x+
! Description
|-
| Public Key
| Tap publishable key
|-
|-
|PHP
| Secret Key
|8.1+
| Tap secret API key
|-
|-
|SSL
| Sandbox Mode
|Required
| Enable for testing
|}
|}


== Documentation ==
== Webhooks ==
 
=== Callback URL ===
 
Configure this webhook URL inside Tap Dashboard:
 
<syntaxhighlight lang="text">
https://yourdomain.com/modules/gateways/callback/tapcheckout.php
</syntaxhighlight>
 
=== Supported Events ===
 
* payment.authorized
* payment.captured
* payment.failed
 
== Supported Currencies ==
 
* USD
* EUR
* AED
* SAR
* KWD
* BHD
 
== Troubleshooting ==
 
=== Callback Not Working ===
 
Check:
 
* SSL certificate
* Callback URL
* Firewall restrictions
 
=== Invalid API Keys ===
 
Verify:
 
* Sandbox keys
* Live keys
* Correct permissions
 
=== Invoice Not Marked Paid ===
 
Ensure webhook events are enabled correctly.
 
== FAQ ==
 
=== Does this support recurring billing? ===
 
Yes, depending on your Tap account configuration.
 
=== Does this support sandbox mode? ===
 
Yes.
 
=== Is WHMCS 8.x supported? ===
 
Yes.
 
== Changelog ==
 
=== Version 1.0.0 ===


* [[Tap Checkout For WHMCS/Installation|Installation]]
* Initial Release
* [[Tap Checkout For WHMCS/Configuration|Configuration]]
* WHMCS 8.x Support
* [[Tap Checkout For WHMCS/Supported Currencies|Supported Currencies]]
* Tap Payments Integration
* [[Tap Checkout For WHMCS/Webhooks|Webhooks]]
* [[Tap Checkout For WHMCS/Troubleshooting|Troubleshooting]]
* [[Tap Checkout For WHMCS/FAQ|FAQ]]
* [[Tap Checkout For WHMCS/Changelog|Changelog]]

Latest revision as of 08:57, 26 May 2026

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