Installation
There are 2 ways to integrate WHMCS with Xendit:
- From GitHub repository: https://github.com/xendit/xendit-whmcs/releases
- From WHMCS Marketplace: https://marketplace.whmcs.com/product/6411-xendit-payment-gateway
How to Integrate from GitHub Repository
- Go to GitHub repository, and download the latest version.
![](/_next/image?url=https%3A%2F%2Fres.cloudinary.com%2Fdpvzoteik%2Fimage%2Fupload%2Fv1652776565%2FStore%2520Channels%2FWHMCS%2Fd8f92e26-2b4e-4684-9d22-dfb84f8abefb_by1q26.png&w=1200&q=75)
- Extract the zip file and you will see the folder name
modules
.
![](/_next/image?url=https%3A%2F%2Fres.cloudinary.com%2Fdpvzoteik%2Fimage%2Fupload%2Fv1652776565%2FStore%2520Channels%2FWHMCS%2F1a5f3bdf-f7c7-4f9b-8236-c09af2ed055b_zaoo4x.png&w=1200&q=75)
- 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
- Copy
- Verify the folder is copied correctly
- Go to
modules/gateways
and check the folderxendit
and filexendit.php
are already there - Go to
modules/gateways/callback
and check filexendit.php
is already there
- Go to
- Activate the Xendit module
- Login to the admin dashboard
- Go to System settings > Payment Gateways > All Payment Gateways
- Activate Xendit Payment Gateways
![](/_next/image?url=https%3A%2F%2Fres.cloudinary.com%2Fdpvzoteik%2Fimage%2Fupload%2Fv1652776565%2FStore%2520Channels%2FWHMCS%2F29e0e99a-b503-4fc3-825e-8e79e0da4373_expksm.png&w=1200&q=75)
![](/_next/image?url=https%3A%2F%2Fres.cloudinary.com%2Fdpvzoteik%2Fimage%2Fupload%2Fv1652776566%2FStore%2520Channels%2FWHMCS%2Fed320ff3-6805-4658-9fe7-a22162ed8937_munmix.png&w=1200&q=75)
- 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.
- API Secret Key Permission:
![](/_next/image?url=https%3A%2F%2Fres.cloudinary.com%2Fdpvzoteik%2Fimage%2Fupload%2Fv1652776565%2FStore%2520Channels%2FWHMCS%2F58b119dc-e914-4f12-aabe-6e3c0afb666a_vfoybz.png&w=1200&q=75)
- 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.
![](/_next/image?url=https%3A%2F%2Fres.cloudinary.com%2Fdpvzoteik%2Fimage%2Fupload%2Fv1652776565%2FStore%2520Channels%2FWHMCS%2Fad122a67-3d49-4daf-b4e7-588ae25ff5a6_pgql6f.png&w=1200&q=75)
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:
![](/_next/image?url=https%3A%2F%2Fres.cloudinary.com%2Fdpvzoteik%2Fimage%2Fupload%2Fw_1120%2Ch_1120%2Cc_limit%2Fv1671765771%2FStore%2520Channels%2FWooCommerce%2Ffirewall-whitelisting_j30zfv.png&w=1200&q=75)
Last Updated on 2023-11-29