Connect Xendit step by step (API key and webhook)
Create a Xendit API key with the right permissions, connect it in Godo, add the invoice webhook, and test before going live.
Xendit lets your clients pay invoices with GCash, Maya, cards, online banking, QR Ph and more. The money goes to your own Xendit account. Godo only records it. Connecting Xendit needs the Business plan.
Before you start: sign up at xendit.co. You can test right away in Test mode. To receive real payments, finish Xendit's account activation.
Use the switch at the top left of the Xendit dashboard to move between Test and Live mode. Keys and webhooks are separate for each mode.
1. Create a secret API key
- In the Xendit dashboard (in Test mode), go to Settings › Developers › API Keys.
- Generate a new secret key and give it a name such as Godo.
- Set the permissions:
- Write for money-in (invoices), so Godo can create the payment page.
- Read for Balance, so Godo can test the connection. Leave everything else off.
- Copy the key. Test keys start with
xnd_development_. Xendit shows it only once.
2. Connect it in Godo
- Go to Settings › Online payments and tick Turn on online payments.
- On the Online payments tab, under Choose your gateway, pick Xendit. (Godo uses one gateway at a time, so this replaces PayMongo if it was connected.)
- Under Connect your account, paste the key in Secret key.
- Under What clients can pay with, tick the methods that are active in your Xendit account.
- Enter your authenticator code (or password) and click Save settings.
You should see Connected to Xendit · Test mode. Use Test saved key again any time to re-check the saved key. Bank transfer is on its own tab and can stay on alongside Xendit. If Godo says the key is missing a permission, edit the key in Xendit and add Read for Balance.
3. Add the webhook
- In Godo, copy the Webhook address shown on Settings › Online payments. It ends in
/api/pay/webhook/xendit. - In Xendit, go to Settings › Webhooks.
- Click View Webhook Verification Token (Xendit asks for your password) and copy the token.
- In the webhook URL list, choose Invoice, paste the Godo address, and save. You can click Test to send a test message.
- Back in Godo (step 3, Add the webhook), paste the token in Webhook signing secret (Xendit calls it the verification token) and save with your authenticator code.
4. Test a payment
Issue a small invoice to yourself, open the pay link, choose a method and pay on Xendit's test page. Back in Godo the invoice is Paid and a Xendit clearing account appears under Banking.
5. Go live
Switch Xendit to Live mode, create a live secret key (xnd_production_…) with the same permissions, paste it in Godo, and set the live Invoice webhook and its verification token. Pay a small real invoice yourself before telling clients.
Something not working? See Online payments: troubleshooting.