# Conecta tu cuenta de Payfast

> Cobra con tarjeta, Instant EFT y Masterpass en Sudáfrica con tu propia cuenta de Payfast. En Configuración > Pagos, haz clic en Configurar Payfast, pega tu Merchant ID, tu Merchant Key y tu Passphrase, elige Live o Test, actívalo y haz clic en Guardar ajustes.

Centro de ayuda / Pagos - Actualizado el 19 de noviembre de 2026

Payfast es un proveedor de pagos para empresas de Sudáfrica. Cuando conectas tu cuenta de Payfast, tus clientes pueden pagar con tarjeta, con Instant EFT desde su propio banco o con Masterpass. Los pagos van directo a tu cuenta de Payfast y Shoprocket cobra un 0 %.

Cuando un cliente hace clic en **Paga ahora**, se abre una ventana segura de Payfast sobre tu pago. Paga allí y se queda en tu tienda todo el tiempo. Los datos de la tarjeta y del banco van directo a Payfast y nunca pasan por Shoprocket.

## Antes de empezar

Necesitas una cuenta de Payfast y tres datos de tu panel de Payfast:

1. Tu **Merchant ID** y tu **Merchant Key**, en **Settings > Merchant Details**.
2. Una **passphrase**. Si todavía no has creado una, añádela en **Settings > Integration**. Elige algo largo que no uses en ningún otro sitio. Payfast la usa para firmar cada pago, así que la passphrase de Shoprocket tiene que coincidir exactamente con la de Payfast.

## Conectar Payfast

1. En tu panel, ve a **Configuración > Pagos**.
2. En la tarjeta de Payfast, en **Pasarelas de pago**, haz clic en **Configurar Payfast**.
3. Pega tu **Merchant ID**, tu **Merchant Key** y tu **Passphrase** en los campos con el mismo nombre.
4. En **Mode**, elige **En vivo**.
5. Pon el interruptor de Payfast en **Activado** y haz clic en **Guardar ajustes**.

![La tarjeta de Payfast en Configuración > Pagos: los campos de Merchant ID, Merchant Key, Passphrase y modo](https://shoprocket.io/img/help/connect-payfast/payfast-setup.webp)

Al guardar, Shoprocket comprueba tu Merchant ID y tu passphrase con Payfast. Si Payfast los rechaza, no se guarda nada y un mensaje en la parte superior de la pantalla explica por qué. El error más común es una passphrase distinta de la de **Settings > Integration**, aunque solo sea por un espacio al final.

La tarjeta muestra entonces **Conectado**, y Payfast aparece en tu pago.

No hay que configurar ningún webhook. Shoprocket le indica a Payfast dónde debe avisar de cada pago. Antes de marcar un pedido como pagado, Shoprocket comprueba ese aviso con Payfast.

## Payfast solo acepta rand

Payfast cobra en rand sudafricanos (ZAR). Al guardar, la tarjeta muestra **Tu cuenta de Payfast cobra en ZAR.**

Si los precios de tu tienda están en otra moneda, la tarjeta te avisa. Payfast no podrá ser entonces tu pasarela de tarjeta principal, pero aun así puedes ofrecerlo a los clientes que paguen en rand. Para ello, añade ZAR en **Pasarela de tarjeta por moneda**, como explica [Elegir una pasarela de pago](https://shoprocket.io/es/ayuda/elegir-una-pasarela-de-pago.md).

## Pruébalo con una cuenta sandbox de Payfast

El entorno de pruebas de Payfast es una cuenta aparte. Regístrate en sandbox.payfast.co.za. Tiene su propio Merchant ID, su propio Merchant Key y su propia passphrase.

Para probar tu pago sin mover dinero real:

1. Haz clic en **Editar credenciales de Payfast**.
2. Pega el Merchant ID, el Merchant Key y la passphrase de tu cuenta **sandbox**.
3. En **Mode**, elige **Test (cuenta sandbox de Payfast)** y haz clic en **Guardar ajustes**.

La tarjeta muestra entonces **Credenciales de prueba: no se mueve dinero real**. En modo de prueba, **Paga ahora** lleva al cliente a la página de pago sandbox de Payfast en lugar de abrir la ventana sobre tu pago, porque el sandbox de Payfast no ofrece esa ventana. Paga con una de las tarjetas de prueba de Payfast y vuelves a tu tienda con el pedido confirmado.

Cuando estés listo para vender, haz clic de nuevo en **Editar credenciales de Payfast**, pega los datos de tu cuenta real de Payfast, elige **En vivo** y haz clic en **Guardar ajustes**.

## Cómo pagan tus clientes

- **Con tarjeta**: el cliente escribe los datos de su tarjeta en la ventana de Payfast. Si su banco necesita comprobar el pago, la comprobación se abre allí mismo.
- **Con Instant EFT**: el cliente inicia sesión en su propio banco en la ventana de Payfast y aprueba el pago. El pedido se confirma en cuanto Payfast nos avisa de que el dinero ha llegado.
- **Con Masterpass**: el cliente escanea el código con la app de su banco.

Si un cliente cierra la ventana de Payfast sin pagar, vuelve a su carrito y puede hacer clic en **Paga ahora** para intentarlo de nuevo.

## Reembolsos

Cuando reembolsas un pedido pagado con Payfast, Shoprocket envía el reembolso a Payfast, total o parcial. Consulta [Reembolsa un pedido](https://shoprocket.io/es/ayuda/reembolsa-un-pedido.md).

Payfast solo permite reembolsar desde Shoprocket cuando tu cuenta de Payfast tiene acceso a la API. Si no lo tiene, el primer reembolso aparece como fallido y lo indica. Reembolsa al cliente en tu panel de Payfast y luego vuelve a reembolsar el pedido en Shoprocket. Shoprocket te pedirá entonces que confirmes que has enviado tú el dinero y registrará el reembolso en el pedido. Los pedidos pagados en modo de prueba se reembolsan siempre así, porque el sandbox de Payfast no tiene reembolsos.

Los reembolsos salen de tu saldo de Payfast, así que asegúrate de que tenga fondos suficientes para cubrirlos.

## Suscripciones

Payfast todavía no puede renovar suscripciones en Shoprocket. Si vendes suscripciones, mantén otra pasarela de tarjeta que las renueve, como Stripe o Paystack, para esos productos.

## Cambiar tus credenciales o desactivarlo

Cuando Payfast está conectado, su botón dice **Editar credenciales de Payfast**. Tus credenciales guardadas se almacenan cifradas y no se vuelven a mostrar. Para conservarlas, deja los campos en blanco. Para sustituirlas, rellena los cuatro campos y haz clic en **Guardar ajustes**.

Para dejar de ofrecer Payfast, pon su interruptor en **Desactivado** y haz clic en **Guardar ajustes**. Tus credenciales siguen guardadas, así que puedes volver a activarlo cuando quieras. Los pagos que tus clientes ya habían empezado se completarán igualmente.

## Artículos relacionados

- [Elegir una pasarela de pago](https://shoprocket.io/es/ayuda/elegir-una-pasarela-de-pago.md)
- [Reembolsa un pedido](https://shoprocket.io/es/ayuda/reembolsa-un-pedido.md)
- [Haz un pedido de prueba](https://shoprocket.io/es/ayuda/hacer-un-pedido-de-prueba.md)

[Abrir Pagos en tu panel](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/es/ayuda/conectar-payfast
- Language: Español (es)
- 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), [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), [中文](https://shoprocket.io/zh/help/connect-payfast.md)
