The Apple Pay Payment Gateway module for WHMCS requires PHP 5.6 or higher, WHMCS 7.x, OpenSSL with TLS 1.1 or higher, IonCube Loader v10.1.x or higher, and the PHP extensions cURL with TLS 1.1+, DOM, Hash, and OpenSSL. You also need an Apple Developer account, a supported Apple device for testing, and a Braintree merchant account verified to support Apple Pay. These are the precise conditions under which our developers have tested the module. Meeting them ensures the module can decode correctly, establish secure API connections to Braintree and Apple, validate merchant identity, and process tokenized transactions without runtime or security failures.

The module may work under different conditions, but has only been tested by our developers in these scenarios. This article assumes that your system, server and PHP installation meets the requirements of WHMCS itself. Deviations in TLS support or loader versions commonly produce white screens, fatal errors on activation, or failed callback handling. The following sections supply concrete explanations for each item, verification steps, and pitfalls to avoid so you can deploy the gateway with confidence.

#System Requirements

  • Clear understanding of using WHMCS as well as uploading, installing and configuring addons and gateways. Without this baseline proficiency, incorrect file paths, missing database entries, or improper gateway activation frequently block the module from appearing in the WHMCS payment options.
  • PHP 5.6 or higher. Earlier versions lack the updated stream handling, cipher suites, and security patches required to interact safely with Braintree and Apple Pay endpoints.
  • WHMCS 7.x (we do not support alpha, beta or release candidate builds). The module depends on stable hooks, payment API structures, and invoice handling introduced in the 7 series; pre-release code can change without notice.
  • OpenSSL (or any SSL library) w/ TLS 1.1+ support. Payment processors reject older protocols; insufficient TLS support results in connection failures during tokenization or webhook delivery.
  • Ioncube loader v10.1.x or higher. The module is encoded for distribution; an incompatible or absent loader produces immediate parse errors when the gateway file is included.

#PHP Extension Requirements

  • cURL w/ TLS 1.1+ support. This extension performs every outbound request to Braintree for authorization and to Apple servers for payment session setup and merchant validation. Without current TLS, these calls are refused.
  • DOM. Required to parse XML-formatted responses and error documents returned by the payment processors during transaction flows.
  • Hash. Supplies the cryptographic hash functions used to sign and verify data exchanged with Apple Pay and Braintree.
  • OpenSSL. Provides PHP-level access to encryption primitives that complement the system library during certificate handling and payload encryption.

#Apple and Braintree Requirements

  • An Apple Developer account. If you do not have one, you may signup through Apple. The account is used to register your domain, generate Apple Pay merchant certificates, and obtain the merchant ID required by Braintree.
  • A supported device. Refer to the list at https://support.apple.com/en-us/HT208531. Testing on a compatible iPhone, iPad, or Mac with Safari is mandatory to verify the full Apple Pay sheet and authentication flow.
  • A Braintree Merchant Account. If you do not have one, you may sign up through Braintree. After creation, verify that your Braintree Merchant account supports Apple Pay and that the feature is enabled in the control panel before configuring the WHMCS gateway.

#Requirements Test Script

We offer a PHP script that will quickly and easily check your PHP and WHMCS installation for any missing requirements. The tool can be downloaded here - https://billing.aspnix.com/dl.php?type=d&id=138. Upload the file to the root of your WHMCS installation, then access it directly via browser. It inspects PHP version, loaded extensions, TLS capabilities, IonCube presence, and WHMCS path detection, then outputs a concise report listing any gaps. Run this script before purchasing or installing the module to prevent deployment surprises.

After all requirements are confirmed, install the module using standard WHMCS procedures, enter your Braintree credentials and Apple merchant identifier, and test end-to-end in sandbox mode. Keep PHP, extensions, and TLS libraries current to maintain PCI compliance and uninterrupted service. A properly validated environment lets the gateway deliver fast, secure Apple Pay transactions with minimal support overhead.