# 连接你的 Xendit 账户

> 用你自己的 Xendit 账户在东南亚收取银行卡、QRIS、电子钱包和银行转账付款。在 设置 > 支付 中点击 设置 Xendit，粘贴密钥和 Webhook 验证令牌，选择你的国家，在 Xendit 中添加我们的 Webhook URL，开启后点击 保存设置。

帮助中心 / 支付 - 更新于 2026年11月19日

Xendit 是面向印度尼西亚、菲律宾、越南、泰国、新加坡和马来西亚商户的支付服务商。连接你的 Xendit 账户后，顾客可以用银行卡、扫描 QRIS 码、OVO、DANA、GoPay、ShopeePay、GCash 和 Maya 等电子钱包、转账到虚拟账户，或在线下门店付款，具体取决于你在 Xendit 中开启了哪些付款方式。款项直接进入你的 Xendit 账户，Shoprocket 收取 0%。

顾客点击 **立即支付** 后，会进入 Xendit 的安全支付页面选择付款方式，然后回到你的店铺。卡信息直接发送给 Xendit，不会经过 Shoprocket。

## 开始之前

你需要一个 Xendit 账户，以及从 Xendit 后台获取的三样东西：

1. 你的 **密钥（secret API key）**，在 **Settings > API keys** 中。创建密钥时，请授予 **Money-in** 的写入权限，这样它才能收款和退款。
2. 你的 **Webhook 验证令牌**，在 **Settings > Webhooks** 中。
3. 你的 Xendit 账户注册所在的国家。

## 连接 Xendit

1. 在后台中，前往 **设置 > 支付**。
2. 在 **支付网关** 中 Xendit 的卡片上，点击 **设置 Xendit**。
3. 把你的 **Secret API key** 和 **Webhook verification token** 粘贴到同名字段中。
4. 在 **Country** 下，选择你的 Xendit 账户注册所在的国家。
5. 复制字段下方显示的 **Webhook URL**。
6. 在你的 Xendit 后台，前往 **Settings > Webhooks**。把该网址粘贴到 **Payment Session**、**Payments** 和 **Refunds** 的 Webhook 字段中并保存。
7. 回到 Shoprocket，把 Xendit 的开关切换为 **开启**，然后点击 **保存设置**。

![设置 > 支付 中的 Xendit 卡片：密钥、Webhook 令牌和国家字段，下方是可复制的 Webhook URL](https://shoprocket.io/img/help/connect-xendit/xendit-setup.webp)

保存时，Shoprocket 会向 Xendit 验证你的密钥。如果 Xendit 拒绝，就不会保存任何内容，屏幕顶部的消息会说明原因。最常见的错误是粘贴了以 `xnd_public_` 开头的公钥。密钥以 `xnd_development_` 或 `xnd_production_` 开头。

随后卡片会显示 **已连接**，Xendit 会出现在你的结账页面中。

## Webhook URL 为什么重要

东南亚的许多顾客是在你的店铺之外完成付款的。顾客可能用银行 App 扫描 QRIS 码，在手机上批准电子钱包付款，或者几小时后才转账到虚拟账户。Xendit 会通过 Webhook URL 把每笔付款告知 Shoprocket。Shoprocket 会先向 Xendit 核实这笔付款，再把订单标记为已付款。

没有 Webhook，以这种方式付款的订单可能会一直停留在 **处理中**，直到顾客回到你的店铺。请在开始销售之前，先在 Xendit 中添加这个网址。

## 你的账户接受的币种

每个 Xendit 账户接受其所在国家的货币：印尼盾、菲律宾比索、越南盾、泰铢、新加坡元或马来西亚林吉特。你选择的国家决定了币种，保存后卡片会显示它。

如果你的店铺标价使用其他币种，卡片会提醒你。这种情况下，Xendit 不能作为你的主要银行卡网关，但你仍然可以把它提供给用其币种付款的顾客。方法是在 **按币种设置银行卡网关** 下添加该币种，详见 [选择支付网关](https://shoprocket.io/zh/help/choose-a-payment-gateway.md)。

Xendit 接受的印尼盾为整数金额。如果价格带有小数，顾客付款时会四舍五入到最接近的整数印尼盾。

## 用测试模式试一试

Xendit 为每个账户提供测试模式，并有单独的密钥，以 `xnd_development_` 开头。粘贴测试密钥，就能在不动用真钱的情况下试用结账。这时卡片会显示 **测试凭据：不会动用真钱**。在 Xendit 的测试支付页面上，你可以为每种付款方式模拟一次成功的付款。

准备好开始销售时，点击 **编辑 Xendit 凭据**，粘贴正式密钥（以 `xnd_production_` 开头），再次选择你的国家，然后点击 **保存设置**。Webhook 验证令牌和 Webhook URL 在 Xendit 中是测试模式和正式模式分别设置的，所以请在正式模式中也添加这个网址。

## 顾客如何付款

- **银行卡**：顾客在 Xendit 的页面上输入卡信息。如果他们的银行需要核实付款，核实也会在那里打开。
- **QRIS 或电子钱包**：顾客扫描二维码，或在电子钱包 App 中批准付款。Xendit 一通知我们付款已完成，订单就会确认。
- **虚拟账户或线下门店**：顾客会得到一个付款号码。订单会一直保持 **处理中**，直到他们付款，而在 Xendit 的支付页面打开期间，商品会保持预留。

如果顾客没有付款就离开了 Xendit 的页面，可以从购物车再次点击 **立即支付** 回到同一个页面。页面过期后，会打开一个新的页面。

## 退款

当你为用 Xendit 付款的订单退款时，钱会自动退回给顾客，可以全额退款，也可以部分退款。请参阅 [为订单退款](https://shoprocket.io/zh/help/refund-an-order.md)。有些电子钱包和银行付款方式无法通过 Xendit 部分退款，甚至完全无法退款。如果发生这种情况，退款会显示为失败并附上原因。你可以改为退全额，或自己把钱退给顾客。你在 Xendit 后台办理的退款，也会显示在 Shoprocket 的订单上。

退款会从你的 Xendit 余额中扣除，所以请保留足够的余额来支付。

## 订阅

Xendit 目前还不能为 Shoprocket 的订阅续费。如果你销售订阅，请为这些商品另外保留一个可以续费的银行卡网关，比如 Stripe。

## 更改凭据或关闭

连接 Xendit 后，它的按钮会显示 **编辑 Xendit 凭据**。已保存的凭据以加密方式存储，不会再次显示。要保留它们，请让字段留空。要替换它们，请填写全部三个字段并点击 **保存设置**。

要停止提供 Xendit，请把它的开关切换为 **关闭** 并点击 **保存设置**。你的凭据仍然保存着，所以可以随时重新开启。顾客已经开始的付款仍会完成。

## 相关文章

- [选择支付网关](https://shoprocket.io/zh/help/choose-a-payment-gateway.md)
- [为订单退款](https://shoprocket.io/zh/help/refund-an-order.md)
- [下测试订单](https://shoprocket.io/zh/help/take-a-test-order.md)

[在后台打开“支付”](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/zh/help/connect-xendit
- Language: 中文 (zh)
- 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), [English](https://shoprocket.io/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)
