Installation

There are 2 ways to integrate WHMCS with Xendit:

How to Integrate from GitHub Repository

  • Extract the zip file and you will see the folder name modules.
  • Copy folder modules to the root WHMCS directory
    • Copy modules/gateways/xendit to your <root directory>/modules/gateway
    • Copy modules/gateways/callback/xendit.php to your <root directory>/modules/gateways/callback
  • Verify the folder is copied correctly
    • Go to modules/gateways and check the folder xendit and file xendit.php are already there
    • Go to modules/gateways/callback and check file xendit.php is already there
  • Activate the Xendit module
    • Login to the admin dashboard
    • Go to System settings > Payment Gateways > All Payment Gateways
    • Activate Xendit Payment Gateways
  • Xendit Payment Settings
    On the Payment Gateways page, click in the tab Manage Existing Gateways and fill in the input Public key/Secret key. Get your API keys from here.
    • API Secret Key Permission:
      • Money in: WRITE
      • Money out: NONE
    • You can choose to enable Test Mode for testing.
      Note: for test mode, use the API keys from your Test mode Xendit account. For live transactions, use your API keys from your Live mode Xendit account.
  • Verify on the checkout page
    Now you can try to add a product to your cart and go to the checkout page to see if the Xendit Payment Gateway is enabled.

Optional: Firewall Whitelisting

If you happen to use firewall, there's an optional step, which is to whitelist Xendit Callback URLs in order to avoid unreceived callback:

  • WHMCS:<merchant_site>/modules/gateways/callback/xendit.php

You can input these URLs when creating firewall rules. Example below is the display if you're using Cloudflare:

Last Updated on 2023-11-29