# 连接你的 Payfast 账户

> 用你自己的 Payfast 账户在南非收取银行卡、Instant EFT 和 Masterpass 付款。在 设置 > 支付 中点击 设置 Payfast，粘贴 Merchant ID、Merchant Key 和 Passphrase，选择正式或 Test，开启后点击 保存设置。

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

Payfast 是面向南非商户的支付服务商。连接你的 Payfast 账户后，顾客可以用银行卡、通过自己银行的 Instant EFT，或用 Masterpass 付款。款项直接进入你的 Payfast 账户，Shoprocket 收取 0%。

顾客点击 **立即支付** 后，一个安全的 Payfast 窗口会在你的结账页面上方打开。顾客在窗口里完成付款，全程都留在你的店铺中。银行卡和银行信息直接发送给 Payfast，不会经过 Shoprocket。

## 开始之前

你需要一个 Payfast 账户，以及 Payfast 后台里的三项信息：

1. 你的 **Merchant ID** 和 **Merchant Key**，在 **Settings > Merchant Details** 中。
2. 一个 **passphrase**（密码短语）。如果还没有设置，请在 **Settings > Integration** 中添加。选一个较长、且没在其他地方用过的短语。Payfast 用它为每笔付款签名，所以 Shoprocket 里的 passphrase 必须与 Payfast 里的完全一致。

## 连接 Payfast

1. 在后台中，进入 **设置 > 支付**。
2. 在 **支付网关** 下的 Payfast 卡片上，点击 **设置 Payfast**。
3. 把你的 **Merchant ID**、**Merchant Key** 和 **Passphrase** 粘贴到同名字段中。
4. 在 **Mode** 下选择 **正式**。
5. 把 Payfast 的开关切换为 **开启**，然后点击 **保存设置**。

![设置 > 支付 中的 Payfast 卡片：Merchant ID、Merchant Key、Passphrase 和模式字段](https://shoprocket.io/img/help/connect-payfast/payfast-setup.webp)

保存时，Shoprocket 会向 Payfast 核对你的 Merchant ID 和 passphrase。如果 Payfast 拒绝，则不会保存任何内容，屏幕顶部会有一条消息说明原因。最常见的错误是 passphrase 与 **Settings > Integration** 中的不一致，哪怕只是末尾多了一个空格。

之后卡片会显示 **已连接**，Payfast 会出现在你的结账页面上。

无需设置 Webhook。Shoprocket 会自己告诉 Payfast 把每笔付款通知发到哪里。在把订单标记为已付款之前，Shoprocket 会向 Payfast 核实这条通知。

## Payfast 只接受兰特

Payfast 以南非兰特（ZAR）收款。保存后，卡片会显示 **你的 Payfast 账户以 ZAR 收款。**

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

## 用 Payfast 沙盒账户试一试

Payfast 的测试环境是一个独立的账户。请在 sandbox.payfast.co.za 注册一个，它有自己的 Merchant ID、Merchant Key 和 passphrase。

要在不动用真钱的情况下试用你的结账页面：

1. 点击 **编辑 Payfast 凭据**。
2. 粘贴你的 **沙盒** 账户的 Merchant ID、Merchant Key 和 passphrase。
3. 在 **Mode** 下选择 **Test（Payfast 沙盒账户）**，然后点击 **保存设置**。

之后卡片会显示 **测试凭据：不会动用真钱**。在测试模式下，**立即支付** 会把顾客带到 Payfast 沙盒的支付页面，而不是在你的结账页面上方打开窗口，因为 Payfast 的沙盒不提供这个窗口。用 Payfast 的测试卡付款，你就会带着已确认的订单回到你的店铺。

准备好销售后，再次点击 **编辑 Payfast 凭据**，粘贴你正式 Payfast 账户的信息，选择 **正式**，然后点击 **保存设置**。

## 顾客如何付款

- **用银行卡**：顾客在 Payfast 窗口中输入卡信息。如果银行需要验证这笔付款，验证也会在那里打开。
- **用 Instant EFT**：顾客在 Payfast 窗口中登录自己的银行并批准付款。一旦 Payfast 通知我们款项已到账，订单就会确认。
- **用 Masterpass**：顾客用银行 App 扫描二维码。

如果顾客没付款就关闭了 Payfast 窗口，会回到购物车，可以再次点击 **立即支付** 重试。

## 退款

当你为使用 Payfast 付款的订单退款时，Shoprocket 会把退款发送给 Payfast，可全额也可部分。请参阅 [为订单退款](https://shoprocket.io/zh/help/refund-an-order.md)。

只有当你的 Payfast 账户拥有 API 权限时，Payfast 才允许通过 Shoprocket 退款。如果没有，第一次退款会显示为失败并说明原因。这时请在你的 Payfast 后台向顾客退款，然后在 Shoprocket 中再次为该订单退款。Shoprocket 会请你确认款项是你自己转出的，并把这次退款记录在订单上。在测试模式下付款的订单一律按这种方式退款，因为 Payfast 的沙盒没有退款功能。

退款会从你的 Payfast 余额中扣除，所以请确保余额足够。

## 订阅

Payfast 目前还不能在 Shoprocket 中为订阅续费。如果你销售订阅，请为这些商品保留另一个能续费的银行卡网关，例如 Stripe 或 Paystack。

## 更改凭据或关闭

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

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

## 相关文章

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