Payfast es una pasarela de pago sudafricana que permite a tu organización aceptar donaciones en Rand sudafricano, a través de pagos con tarjeta, Instant EFT, códigos QR, Mobicred y más de una docena de otros métodos que los donantes sudafricanos ya utilizan.
Esta guía te guiará a través de la instalación del complemento, la habilitación de la pasarela, la configuración de tu moneda a Rand, la adición de tus credenciales de comerciante, las pruebas en el entorno de pruebas y la puesta en marcha.
¿Qué hay en esta guía?
Antes de empezar
- La integración de pagos Payfast está disponible en los planes Básico y superiores en el Plugin Charitable Pro. Si aún no estás en Pro, puedes crear tu cuenta ahora » Aquí tienes una guía para ayudarte a instalar Charitable Pro »
- A continuación, deberás instalar el complemento Charitable Payfast. Te mostraremos cómo hacerlo a continuación. El complemento Payfast viene con el plugin Charitable Pro. Después de comprar un plan, puedes instalarlo, junto con cualquier otro complemento incluido, desde el menú de complementos sin coste adicional.
- Necesitarás tu propia cuenta de comerciante Payfast antes de empezar. Si aún no tienes una, regístrate en payfast.io.
Payfast está diseñado para el mercado sudafricano y liquida en cuentas bancarias sudafricanas. Charitable se conecta a tu propia cuenta Payfast, por lo que los detalles de tu donante y tus transacciones se mantienen entre tú y Payfast.
Payfast no cobra ninguna tarifa de configuración ni tarifa mensual. Pagas por transacción, y la tarifa depende del método que elija tu donante. Consulta payfast.io para ver las tarifas actuales.
El complemento requiere Charitable 1.3 o superior y PHP 5.3 o superior. Cualquier versión de PHP actualmente compatible está cómodamente por encima de ese mínimo.
Empecemos.
Instalación del Complemento Payfast
Ve a Charitable » Complementos y busca Payfast en la lista. Haz clic en “Instalar Complemento”, luego haz clic en “Activar” una vez que la instalación finalice.
Si prefieres instalar desde un archivo zip, puedes descargar el complemento y subirlo tú mismo.
- En tu cuenta de Charitable, ve a la pestaña Descargas y desplázate hacia abajo hasta el complemento Payfast. Descarga el complemento aquí.
- En tu panel de WordPress, ve a Plugins » Añadir Nuevo » Subir Plugin.
- Elige el archivo zip, haz clic en “Instalar ahora” y luego en “Activar plugin”.
Si no estás seguro de cómo instalar el complemento Payfast, te recomendamos que primero leas nuestra guía para instalar extensiones de Charitable »
Habilitación de la pasarela
Ve a Charitable » Ajustes » Pasarelas de Pago. Verás Payfast listado con las otras pasarelas. Activa su interruptor, luego haz clic en “Guardar Cambios”.
Aparecerá un botón verde “Ajustes” junto a Payfast. Ahí es donde añadirás tus credenciales de comerciante en un momento.
Nota: El interruptor “Activar Modo de Prueba” en la parte inferior de esta misma página es lo que usarás más tarde para probar Payfast antes de ponerlo en marcha.
Configuración de tu moneda a Rand
Payfast liquida en Rand sudafricano, por lo que Rand tiene que ser tu moneda base en Charitable. Una vez que habilites la pasarela, Charitable lo comprobará por ti y mostrará un aviso si tu moneda está configurada en algo diferente.
Haz clic en “Cambiar ahora” y la divisa se establecerá automáticamente. No tienes que hacer nada más. Puedes confirmarlo en Caritativo » Ajustes » General » Configuración, donde el menú desplegable de divisa mostrará el Rand sudafricano (R).
Nota: Que el Rand sea tu divisa base no impide que los donantes internacionales te den. La función de Precios Multidivisa de Payfast permite a un donante elegir su propia divisa en el proceso de pago de Payfast, y Payfast la convierte y te paga en Rand. Funciona con Visa y Mastercard, pero no con American Express. Actívala desde tu cuenta de Payfast, no desde Caritativo.
Añadir tus credenciales de Payfast
Haz clic en el botón verde “Ajustes” junto a Payfast para abrir la configuración de la pasarela. Encontrarás las 3 credenciales en el área de configuración de tu cuenta de Payfast.
- Etiqueta de la pasarela es el nombre que los donantes leen en tu formulario de donación. Déjalo como Payfast, o cámbialo a algo que tus patrocinadores reconozcan.
- ID de comerciante es tu identificador de comerciante de Payfast.
- Clave de comerciante es la clave emparejada con ese ID de comerciante.
- Frase de paso es el valor que Payfast utiliza para firmar la solicitud. Establece la misma frase de paso en tu cuenta de Payfast y en Caritativo, o tus donaciones serán rechazadas. Las guías antiguas la llaman la sal.
Haz clic en “Guardar Cambios” cuando hayas terminado.
Importante: Si estás probando, obtén estos detalles de sandbox.payfast.co.za en lugar de tu cuenta de Payfast real. Las credenciales de sandbox y las reales no son intercambiables.
Vídeo de configuración
Este breve tutorial cubre la instalación del complemento, la adición de tus credenciales de Payfast y la recepción de una donación.
Métodos de pago disponibles con Payfast
Payfast ofrece a tus donantes una amplia gama de opciones de pago populares en Sudáfrica, incluidas las siguientes.
- Pagos con tarjeta (Visa, Mastercard)
- Tarjetas de débito (Maestro, Visa Electron)
- EFT instantáneo
- SiD Secure EFT
- Pagos con código QR
- Apple Pay
- Google Pay
- Samsung Pay
- Capitec Pay
- Absa Pay
- Mobicred
- MoreTyme (de TymeBank)
- Payflex
- MukuruPay
- MTN MoMoPay
- SnapScan
- Zapper
- Escanear para pagar
- SCode
- Tarjetas de tienda (RCS)
- PayPal
Nota: Los métodos de pago cambian de vez en cuando, y los que puedes ofrecer dependen de lo que esté habilitado en tu propia cuenta de Payfast. Consulta la página de métodos de pago de Payfast para ver la lista actual.
Aceptar donaciones recurrentes con Payfast
Payfast funciona junto con la función de Donaciones Recurrentes de Caritativo, por lo que un donante puede configurar un regalo recurrente una vez y Caritativo factura cada renovación a partir de entonces. Donaciones Recurrentes está disponible en los planes Plus y superiores, mientras que la pasarela Payfast comienza en Básico, por lo que en un plan Básico puedes aceptar donaciones únicas de Payfast pero no recurrentes.
Pruebas antes de salir en vivo
Siempre recomendamos probar una nueva pasarela antes de aceptar donaciones reales. Payfast ejecuta un sandbox separado, por lo que probar significa usar credenciales de sandbox en lugar de las reales.
- Inicia sesión en sandbox.payfast.co.za y obtén el ID de comerciante, la Clave de comerciante y la Frase de paso de allí.
- Ve a Caritativo » Ajustes » Pasarelas de pago y activa “Activar modo de prueba” en la parte inferior de la página. Haz clic en “Guardar cambios”.
- Abre la configuración de tu pasarela Payfast, pega las credenciales del sandbox y haz clic en “Guardar cambios”.
- Realiza una donación en tu propio sitio web y elige Payfast como método de pago. Serás enviado a la página de pago alojada de Payfast.
- Cuando termines, volverás a tu sitio web. Ve a Charitable » Donaciones y comprueba que la donación está ahí y marcada como Pagada.
- Cuando la donación de prueba se vea correcta, desactiva el modo de prueba, reemplaza las credenciales de sandbox con las reales y haz clic de nuevo en “Guardar Cambios”.
Importante: Tus donaciones de prueba se realizaron contra una cuenta de Payfast diferente, así que elimínalas de Charitable » Donaciones antes de pasar a producción si no quieres que aparezcan en tus informes.
Establecer Payfast como pasarela predeterminada
Si tienes más de una pasarela habilitada, la predeterminada es la que se selecciona para tus donantes cuando se carga tu formulario de donaciones. Ve a Charitable » Ajustes » Pasarelas de Pago, elige Payfast en la columna “Predeterminada” y haz clic en “Guardar Cambios”.
Consejo Pro: Si la mayoría de tus donantes están en Sudáfrica, hacer de Payfast la opción predeterminada pone la transferencia bancaria instantánea y las opciones de tarjeta locales delante de ellos de inmediato, en lugar de dejar que la busquen en una lista.
Seguridad y datos de los donantes
Cada donación de Payfast se completa en un formulario de pago compatible con PCI alojado en el propio sitio web de Payfast. Los donantes llegan a él después de enviar tu formulario de donaciones, y los números de tarjeta nunca tocan tu sitio web ni tu base de datos.
Payfast es un nombre que los donantes sudafricanos reconocen, lo que significa que pueden donar sin preocuparse de quién está manejando los detalles de su tarjeta.
Preguntas frecuentes sobre Payfast
¿Necesito mi propia cuenta de Payfast para usar este complemento?
Sí. El complemento se conecta a una cuenta de comerciante que abras directamente con Payfast. Si aún no tienes una, regístrate en payfast.io antes de empezar.
¿Qué divisa necesito usar?
Rand sudafricano. Payfast liquida en Rand, por lo que el Rand es tu divisa base en Charitable. Cuando habilites la pasarela, Charitable mostrará un aviso con un botón “Cambiar ahora” que lo configura por ti.
¿Pueden los donantes internacionales donar en su propia divisa?
Sí, a través de la función Precios Multidivisa de Payfast. Tu donante elige su divisa en el checkout de Payfast, ve el importe convertido y Payfast te paga en Rand. Cubre Visa y Mastercard, pero no American Express, y lo activas en tu cuenta de Payfast en lugar de en Charitable.
¿Dónde encuentro mi ID de comerciante, Clave de comerciante y Frase de contraseña?
Los 3 provienen del área de configuración de tu cuenta de Payfast. El ID de comerciante y la Clave de comerciante identifican tu cuenta. La Frase de contraseña se utiliza para firmar cada solicitud y debe coincidir en ambos lados, así que establece el mismo valor en Payfast y en Charitable. Las guías antiguas la llaman 'salt'.
¿Dónde introducen los donantes los detalles de su tarjeta?
En un formulario de pago compatible con PCI alojado por Payfast, al que los donantes acceden después de enviar tu formulario de donaciones. Los números de tarjeta nunca llegan a tu sitio web ni a tu base de datos.
¿Qué plan necesito para Payfast?
Básico y superior. Las donaciones recurrentes a través de Payfast necesitan la función de Donaciones Recurrentes, que comienza en el plan Plus.
¿Cuánto cobra Payfast?
No hay tarifa de configuración ni tarifa mensual. Payfast cobra por transacción, y la tarifa depende del método de pago que elija tu donante. Consulta payfast.io para ver las tarifas actuales.
¿Cómo puedo probar Payfast sin recibir dinero real?
Utiliza el entorno de pruebas de Payfast en sandbox.payfast.co.za. Emite su propio ID de comerciante, clave de comerciante y contraseña, separados de tu cuenta real. Introdúcelos en Charitable con el modo "Activar modo de prueba" activado.
Mis donantes llegan a Payfast pero la donación nunca regresa como Pagada. ¿Qué debo comprobar?
Comprueba primero la contraseña, ya que una contraseña configurada en Payfast pero no en Charitable, o viceversa, es la causa más común. Luego, confirma que tu ID de comerciante y clave de comerciante provienen de la misma cuenta y del mismo modo, ya que un ID de comerciante real emparejado con una clave de entorno de pruebas fallará.
