# Connect your Xendit account

> Take cards, QRIS, e-wallets and bank transfers in Southeast Asia with your own Xendit account. In Settings > Payments, click Set up Xendit, paste your secret API key and webhook verification token, choose your country, add our webhook URL in Xendit, switch it on and click Save settings.

Help Centre / Payments - Updated 19 November 2026

Xendit is a payment provider for businesses in Indonesia, the Philippines, Vietnam, Thailand, Singapore and Malaysia. When you connect your Xendit account, your customers can pay by card, by scanning a QRIS code, with e-wallets such as OVO, DANA, GoPay, ShopeePay, GCash and Maya, by bank transfer to a virtual account, or at a retail outlet, depending on the payment methods you have turned on in Xendit. Payments go straight to your Xendit account, and Shoprocket takes 0%.

When a customer clicks **Pay now**, they go to Xendit's secure payment page to choose how to pay, then come back to your shop. Card details go straight to Xendit and never pass through Shoprocket.

## Before you start

You need a Xendit account and three things from your Xendit dashboard:

1. Your **secret API key**, from **Settings > API keys**. When you create the key, give it write access to **Money-in**, so it can take payments and refunds.
2. Your **webhook verification token**, from **Settings > Webhooks**.
3. The country your Xendit account is registered in.

## Connect Xendit

1. In your dashboard, go to **Settings > Payments**.
2. On the Xendit card in **Payment gateways**, click **Set up Xendit**.
3. Paste your **Secret API key** and your **Webhook verification token** into the fields with the same names.
4. Under **Country**, choose the country your Xendit account is registered in.
5. Copy the **Webhook URL** shown under the fields.
6. In your Xendit dashboard, go to **Settings > Webhooks**. Paste the URL into the webhook fields for **Payment Session**, **Payments** and **Refunds**, and save them.
7. Back in Shoprocket, turn Xendit's switch to **On** and click **Save settings**.

![The Xendit card in Settings > Payments: the secret key, webhook token and country fields, with the webhook URL to copy below them](https://shoprocket.io/img/help/connect-xendit/xendit-setup.webp)

When you save, Shoprocket checks your secret key with Xendit. If Xendit rejects it, nothing is saved and a message at the top of the screen says why. The most common mistake is pasting the public key, which starts with `xnd_public_`. The secret key starts with `xnd_development_` or `xnd_production_`.

The card then says **Connected**, and Xendit appears at your checkout.

## Why the webhook URL matters

Many customers in Southeast Asia finish paying outside your shop. A customer might scan a QRIS code with their banking app, approve an e-wallet payment on their phone, or pay a virtual account hours later. Xendit tells Shoprocket about each payment through the webhook URL. Shoprocket then checks the payment with Xendit before it marks the order paid.

Without the webhook, an order paid this way can stay **Processing** until the customer comes back to your shop. Please add the URL in Xendit before you start selling.

## The currency your account takes

Each Xendit account takes payments in its own country's currency: Indonesian rupiah, Philippine pesos, Vietnamese dong, Thai baht, Singapore dollars or Malaysian ringgit. The country you choose sets the currency, and the card shows it once you save.

If your shop is priced in a different currency, the card warns you. Xendit can't be your main card gateway in that case, but you can still offer it to customers paying in its currency. To do that, add that currency under **Card gateway by currency**, as [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md) explains.

Xendit takes rupiah in whole amounts. If a price has cents, it is rounded to the nearest rupiah when the customer pays.

## Try it in test mode

Xendit gives every account a test mode with its own secret key, which starts with `xnd_development_`. Paste the test key to try your checkout without moving real money. The card then shows **Test credentials: no real money moves**. On Xendit's test payment page you can simulate a successful payment for each payment method.

When you are ready to sell, click **Edit Xendit credentials**, paste your live secret key (it starts with `xnd_production_`), choose your country again and click **Save settings**. The webhook verification token and the webhook URLs are set separately for test mode and live mode in Xendit, so add the URL in live mode too.

## How customers pay

- **By card**: the customer types their card on Xendit's page. If their bank needs to check the payment, the check opens there too.
- **With QRIS or an e-wallet**: the customer scans the code or approves the payment in their e-wallet app. The order is confirmed as soon as Xendit tells us the payment went through.
- **By virtual account or at a retail outlet**: the customer gets a number to pay to. The order waits as **Processing** until they pay, and the items stay reserved while Xendit's payment page is open.

If a customer leaves Xendit's page without paying, they can click **Pay now** again from their cart to get back to the same page. Once the page expires, a new one opens.

## Refunds

When you refund an order paid with Xendit, the money goes back to the customer automatically, in full or in part. See [Refund an order](https://shoprocket.io/help/refund-an-order.md). Some e-wallets and bank payment methods can't be refunded in part, or at all, through Xendit. If that happens, the refund shows as failed with the reason. You can then refund the full amount or pay the customer back yourself. A refund you make in your Xendit dashboard also appears on the order in Shoprocket.

Refunds come out of your Xendit balance, so keep enough in it to cover them.

## Subscriptions

Xendit can't renew subscriptions on Shoprocket yet. If you sell subscriptions, keep another card gateway that renews them, such as Stripe, for those products.

## Changing your credentials or turning it off

After you connect Xendit, its button reads **Edit Xendit credentials**. Your saved credentials are stored encrypted and never shown again. To keep them, leave the fields blank. To replace them, fill in all three fields and click **Save settings**.

To stop offering Xendit, turn its switch to **Off** and click **Save settings**. Your credentials stay saved, so you can switch it back on at any time. Payments that customers had already started still complete.

## Related

- [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md)
- [Refund an order](https://shoprocket.io/help/refund-an-order.md)
- [Take a test order](https://shoprocket.io/help/take-a-test-order.md)

[Open Payments in your dashboard](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/help/connect-xendit
- Language: English (en)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-xendit.md), [Deutsch](https://shoprocket.io/de/hilfe/xendit-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-xendit.md), [Español](https://shoprocket.io/es/ayuda/conectar-xendit.md), [Français](https://shoprocket.io/fr/aide/connecter-xendit.md), [עברית](https://shoprocket.io/he/help/connect-xendit.md), [हिन्दी](https://shoprocket.io/hi/help/connect-xendit.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-xendit.md), [Italiano](https://shoprocket.io/it/aiuto/collega-xendit.md), [日本語](https://shoprocket.io/ja/help/connect-xendit.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-xendit-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-xendit-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/xendit-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-xendit.md), [Português](https://shoprocket.io/pt/ajuda/conectar-xendit.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-xendit.md), [Русский](https://shoprocket.io/ru/help/connect-xendit.md), [ไทย](https://shoprocket.io/th/help/connect-xendit.md), [Türkçe](https://shoprocket.io/tr/yardim/xendit-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-xendit.md)
