Editing Tap Checkout For WHMCS

= Tap Checkout For WHMCS =

== Overview ==

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

== Features ==

* Secure Hosted Payment Gateway
* Invoice Payments
* Multi Currency Support
* Webhook Support
* Automatic Invoice Payments
* Sandbox & Live Mode

== 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"
|-
! Field
! Description
|-
| Public Key
| Tap publishable key
|-
| Secret Key
| Tap secret API key
|-
| Sandbox Mode
| Enable for testing
|}

== 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 ===

* Initial Release
* WHMCS 8.x Support
* Tap Payments Integration