Xendit is an additional plugin available for purchase from the Aikeedo
Marketplace. Install it from your
admin panel before following this guide.
Prerequisites
Before you begin, ensure you have:- A Xendit business account
- The Xendit plugin installed on your Aikeedo installation
- Access to your Aikeedo admin panel
Supported currencies
Xendit supports the following Southeast Asian currencies:| Currency | Country |
|---|---|
| IDR | Indonesia |
| PHP | Philippines |
| VND | Vietnam |
| THB | Thailand |
| SGD | Singapore |
| MYR | Malaysia |
Step 1: Obtain your API key and webhook token
- Log in to your Xendit Dashboard.
- Navigate to Settings > API Keys.
- Copy your Secret API Key (starts with
xnd_).
- In the Xendit Dashboard, navigate to Settings > Webhooks.
- Copy the Webhook Verification Token shown at the top of the page. Aikeedo uses this token to verify that incoming webhook events are genuine.
Step 2: Configure the webhook
- In the Xendit Dashboard, navigate to Settings > Webhooks.
- Under the relevant event types, add your webhook URL:
- Enable at minimum the Subscription events to keep subscription status in sync.
- Save the webhook configuration.
Step 3: Enable Xendit in Aikeedo
- Log in to your Aikeedo admin panel.
- Navigate to Settings > Payments > Xendit.
- Toggle the switch to enable Xendit.
- Enter your Secret API Key.
- Enter your Webhook Verification Token.
- Click Save changes.
Xendit is now enabled on your platform.
Payment flows
One-time payments — Aikeedo creates a Xendit payment session (payment link) and redirects the customer to the Xendit-hosted payment page. After payment, the customer is redirected back to your platform. Recurring subscriptions — Aikeedo creates a Xendit recurring plan and redirects the customer to an authorization page for the initial payment. Subsequent billing cycles are charged automatically. When a subscription is cancelled in Aikeedo, the corresponding Xendit recurring plan is inactivated.Xendit recurring plans do not support billing dates on days 29–31. If a
subscription would fall on one of those days, Aikeedo automatically shifts the
anchor date to the 1st of the following month.
Testing
Xendit provides a test mode accessible with test-mode API keys. To test your integration:- In the Xendit Dashboard, switch to Test Mode and copy your test-mode Secret API Key.
- Enter the test key in Settings > Payments > Xendit in Aikeedo.
- Use Xendit’s test payment methods to simulate one-time and recurring payment scenarios.
- Verify that webhook events are received and subscription statuses are updated correctly in Aikeedo.
Troubleshooting
- Payments not completing: Verify that your secret API key is correct and that the account is active in Xendit.
- Webhooks not received: Confirm that the webhook URL is publicly accessible and that the correct event types are subscribed in the Xendit Dashboard.
- Webhook verification failures: Ensure the Webhook Verification Token in Aikeedo matches the token shown in the Xendit Dashboard under Settings > Webhooks.
- Recurring plan errors: Check that your Xendit account is enabled for recurring payments and that the selected currency is supported in your account region.
Need Help?
If you need assistance with Aikeedo:Professional Support
Get expert help from our team with a paid support subscription
Troubleshooting Guide
Check common issues and solutions