Resumen de IA
¿Te gustaría aceptar pagos de clientes en Nigeria, Ghana, Kenia o Sudáfrica? Los compradores de estos países esperan pagar con los métodos que ya utilizan a diario, como tarjetas locales, transferencias bancarias y dinero móvil.
El complemento Paystack conecta tus formularios con Paystack para que los compradores completen su pago en una ventana emergente segura sin salir de tu sitio. Este tutorial te mostrará cómo instalar y usar el complemento Paystack con WPForms.
Requisitos:
- Necesitarás una licencia Pro o superior para acceder al complemento Paystack.
- Asegúrate de haber instalado WPForms versión 2.0.2.2 o superior para cumplir con la versión mínima requerida para el complemento Paystack.
- Necesitarás una cuenta de Paystack registrada en Nigeria, Ghana, Kenia o Sudáfrica.
Antes de empezar, asegúrate de instalar y activar WPForms en tu sitio de WordPress. Después de verificar tu licencia, podrás instalar y activar rápidamente el complemento Paystack.
Conectar Paystack a tu sitio
Una vez instalado y activado el complemento Paystack, deberás conectar tu cuenta de Paystack con WPForms. Para ello, copiarás tus claves API de tu panel de Paystack a la configuración de pagos de WPForms. Te guiaremos paso a paso a continuación.
Obtener tus claves API de Paystack
Para empezar, inicia sesión en tu panel de Paystack. Luego haz clic en Configuración en la parte inferior del menú de la izquierda.
Una vez allí, abre la pestaña Claves API y Webhooks.
Paystack muestra las claves del modo en que se encuentra tu panel. Para aceptar pagos reales, necesitarás tus claves en vivo, que aparecen en Configuración de API – Modo en vivo.
Nota: Las nuevas cuentas de Paystack comienzan en Modo de prueba, y las claves en vivo solo estarán disponibles después de que Paystack active tu negocio. Para activarlo, abre la página Cumplimiento en tu panel de Paystack, completa cada sección y haz clic en Activar negocio. Tu panel cambiará a Modo en vivo una vez que Paystack apruebe tus datos. Para ver los pasos completos, consulta la guía de Paystack para activar tu negocio.
Mientras esperas la aprobación, aún puedes probar el complemento con tus claves de prueba. Consulta la sección Probar pagos con Paystack a continuación.
A continuación, haz clic en el icono del ojo junto a tu Clave Secreta en Vivo. Paystack te pedirá la contraseña de tu cuenta antes de mostrar la clave. Luego, copia la clave.
Después de eso, copia tu Clave Pública en Vivo del campo que está debajo.
Mantén esta página abierta. Pegarás ambas claves en WPForms en el siguiente paso, y volverás aquí para añadir la URL de tu webhook.
Finalizar la conexión en WPForms
En tu área de administración de WordPress, ve a WPForms » Ajustes y haz clic en la pestaña Pagos.
Primero, comprueba el ajuste de Moneda en la parte superior de la página. Debe coincidir con la moneda del país donde está registrada tu cuenta de Paystack. Por ejemplo, una cuenta keniana necesita el chelín keniano (KES).
Nota: Cada cuenta de Paystack procesa pagos en una sola moneda, establecida por el país que elegiste al registrarte. Si la moneda de WPForms no coincide, verás una advertencia en la configuración de tus pagos y los pagos no se procesarán hasta que las monedas coincidan.
A continuación, desplázate hacia abajo hasta la sección Paystack. Pega tu clave secreta en el campo Clave Secreta en Vivo. Luego, pega tu clave pública en el campo Clave Pública en Vivo.
Cuando hayas terminado, haz clic en Guardar Ajustes.
WPForms verifica tu clave secreta con Paystack y comprueba que ambas claves pertenecen al modo en el que te encuentras. Si una clave está mal escrita o pertenece al otro modo, verás un error de inmediato. Las claves en vivo comienzan con sk_live_ y pk_live_, mientras que las claves de prueba comienzan con sk_test_ y pk_test_. Cuando la conexión funciona, el Estado de la conexión muestra Conectado a Paystack en modo en vivo.
Nota: El modo de prueba y el modo en vivo utilizan cada uno su propio par de claves. Para probar la integración de Paystack de tu formulario antes de aceptar pagos reales, consulta la sección Pruebas de Pagos de Paystack a continuación.
Configurar webhooks de Paystack
Los webhooks son la forma en que Paystack informa a tu sitio sobre las actualizaciones de pago que ocurren después de que un cliente envía tu formulario. Por ejemplo, un webhook permite a WPForms saber cuándo llega una transferencia bancaria o cuándo reembolsas un pago desde tu panel de Paystack.
Paystack no permite que WPForms añada un webhook por ti, así que copiarás una URL de WPForms y la pegarás en tu panel de Paystack tú mismo. Solo lleva un minuto y solo necesitas hacerlo una vez por cada modo.
Después de guardar tus claves, aparecerán 2 nuevos ajustes en la sección de Paystack. Deja Habilitar Webhooks activado. Luego, haz clic en el icono de copiar junto al campo Punto de Conexión de Webhooks para copiar tu URL de webhook.
Ahora vuelve a la página Claves API y Webhooks en tu panel de Paystack. Pega la URL en el campo URL de Webhook en Vivo. Luego, haz clic en Guardar cambios.
WPForms recibirá ahora actualizaciones de pago de Paystack.
Nota: Paystack mantiene ajustes de webhook separados para el Modo de Prueba y el Modo en Vivo, pero WPForms utiliza la misma URL para ambos. Si estás probando primero, pega la URL en el campo URL de Webhook de Prueba. Si usas ambos modos, añádela a ambos campos.
Añadir Paystack a tus formularios
Después de conectar tu cuenta, estarás listo para aceptar pagos en tus formularios. Para empezar, crea un formulario nuevo o edita uno existente para abrir el constructor de formularios.
Tu formulario necesita al menos un campo de pago que establezca una cantidad, como Artículo único, Artículos múltiples, Artículos de casilla de verificación o Artículos desplegables. También necesita un campo de correo electrónico, ya que Paystack requiere la dirección de correo electrónico del cliente. No hay un campo de Paystack separado para agregar. Paystack recopila los detalles del pago en su propio popup cuando se envía el formulario.
A continuación, ve a Pagos » Paystack en el constructor de formularios y activa el interruptor Activar pagos de Paystack.
Luego, completa la configuración para los pagos de este formulario:
- Descripción del pago: Una breve descripción del pago, como el nombre de tu producto o servicio. Aparece en los detalles del pago en tu panel de Paystack.
- Correo electrónico del cliente: El campo en tu formulario que contiene la dirección de correo electrónico del cliente. Esta configuración es obligatoria. Paystack necesita una dirección de correo electrónico para crear el pago y envía el recibo a esta dirección.
- Nombre del cliente: El campo en tu formulario que contiene el nombre del cliente. Aparece en los detalles del pago en tu panel de Paystack.
Si tu formulario ya tiene un campo de correo electrónico y un campo de nombre, WPForms los selecciona por ti.
Nota: Los pagos de Paystack necesitan el envío de formularios AJAX, que está activado por defecto para los formularios nuevos. Si está desactivado, WPForms te lo recordará cuando guardes el formulario. Para volver a activarlo, ve a Configuración » General, abre la sección Avanzado y marca Activar envío de formularios AJAX.
Cuando hayas terminado, guarda tu formulario. Ahora está listo para aceptar pagos.
Cómo pagan los clientes con Paystack
Cuando un cliente envía tu formulario, se abre un popup de Paystack sobre la página. El formulario solo se envía después de que se complete el pago.
Las opciones de pago en el popup dependen de la moneda de tu cuenta de Paystack:
- Naira nigeriana (NGN): Tarjeta y transferencia bancaria
- Cedi ghanés (GHS): Tarjeta y dinero móvil
- Chelín keniano (KES): Tarjeta y dinero móvil
- Rand sudafricano (ZAR): Tarjeta
Una vez que el pago se realiza con éxito, el popup se cierra y el cliente ve el mensaje de confirmación de tu formulario.
Probar pagos con Paystack
Antes de empezar a aceptar pagos reales, es una buena idea realizar tú mismo un pago a través de tu formulario. El modo de prueba de Paystack te permite completar todo el flujo sin que se mueva dinero.
Activar el modo de prueba
Para asegurarte de que no se procesan pagos reales mientras estás probando, ve a WPForms » Configuración y haz clic en la pestaña Pagos.
En Paystack, activa el interruptor Modo de prueba. Los campos Clave secreta de prueba y Clave pública de prueba aparecerán en lugar de los reales.
Nota: El modo de prueba y el modo real se configuran por separado, por lo que deberás agregar tus claves de prueba aquí, incluso si ya has conectado tus claves reales. WPForms te lo recordará cuando cambies de modo.
A continuación, vuelve a la página Claves API y Webhooks en tu panel de Paystack. Si tu panel está en Modo en vivo, usa el interruptor en la parte superior derecha del panel para cambiar al Modo de prueba.
Copia tu Clave Secreta de Prueba y pégala en el campo Clave Secreta de Prueba en WPForms. Luego haz lo mismo con tu Clave Pública de Prueba.
Haz clic en Guardar Ajustes. El Estado de la Conexión dirá Conectado a Paystack en modo de Prueba.
Para recibir webhooks mientras pruebas, pega también la URL de tu Punto de Conexión de Webhooks en el campo URL de Webhook de Prueba en tu panel de Paystack.
Realizar un pago de prueba
A continuación, abre una página con tu formulario de Paystack y rellénala como lo haría un cliente. Luego envía el formulario para abrir la ventana emergente de Paystack.
En modo de prueba, la opción Tarjeta muestra escenarios de prueba en lugar de campos de tarjeta. Selecciona Éxito y haz clic en el botón Pagar para completar un pago de prueba exitoso. Para ver cómo tu formulario maneja un pago fallido, elige Rechazado en su lugar.
Para introducir los detalles de la tarjeta tú mismo, haz clic en Usar otra tarjeta y utiliza una de las tarjetas de prueba de Paystack. Por ejemplo, el número de tarjeta 4084 0840 8408 4081 con CVV 408 y cualquier fecha de caducidad futura completa un pago exitoso. La misma página enumera los números de prueba para transferencias bancarias y de dinero móvil.
Ver tus pagos de prueba
Para encontrar tus pagos de prueba, ve a WPForms » Pagos y activa el interruptor Datos de Prueba.
Haz clic en un pago para ver sus detalles. Desde allí, el enlace Ver en Paystack abre la transacción en tu panel de Paystack.
Para más información sobre detalles de pagos, estados y tendencias, consulta nuestra guía para ver y gestionar pagos.
Configurar lógica condicional (opcional)
La lógica condicional te permite decidir cuándo se debe procesar un cargo de Paystack, basándose en lo que el cliente selecciona en tu formulario. Por ejemplo, es posible que solo quieras cobrar a los clientes que elijan una opción de pago.
Para configurar esto, ve a Pagos » Paystack en el constructor de formularios y activa Habilitar Lógica Condicional. Luego crea la regla que decida cuándo procesar el cargo.
Para más ejemplos, consulta nuestro tutorial sobre cómo usar la lógica condicional.
Preguntas frecuentes
A continuación, hemos abordado algunas de las preguntas más comunes sobre el uso del complemento de Paystack.
¿Qué países y divisas puedo usar con el complemento Paystack?
El complemento funciona con cuentas de Paystack registradas en Nigeria, Ghana, Kenia y Sudáfrica. Cada cuenta procesa pagos en la moneda de su país: Naira Nigeriana (NGN), Cedi Ghanés (GHS), Chelín Keniano (KES) o Rand Sudafricano (ZAR). Establece la moneda correspondiente en WPForms » Ajustes » Pagos.
¿Por qué mi pago de Paystack está marcado como Pendiente?
Las transferencias bancarias y los pagos con dinero móvil pueden tardar un poco más en confirmarse que los pagos con tarjeta. Si un cliente elige una de estas opciones y cierra la ventana emergente antes de que Paystack confirme el pago, WPForms guarda la entrada y marca el pago como Pendiente.
Hasta que el pago no se confirme, WPForms retiene los correos electrónicos de notificación del formulario. También espera para activar las cuentas creadas con el complemento User Registration y para contar el uso de cualquier cupón. Una vez que Paystack confirma el pago, WPForms lo marca como Completado y finaliza estos pasos. Con los webhooks configurados, esto suele tardar unos segundos. Sin ellos, puede tardar hasta 30 minutos.
¿Necesito configurar webhooks?
Lo recomendamos. Sin webhooks, WPForms comprueba con Paystack cada 15 minutos y actualiza los pagos que aún están pendientes, por lo que las transferencias bancarias y los pagos por dinero móvil aún se completan. Los pagos con tarjeta permanecen Procesados hasta por 30 minutos hasta que esa comprobación los marca como Completados. Sin embargo, los reembolsos que realices en tu panel de Paystack no se sincronizarán con WPForms.
Si WPForms detecta que los pagos solo se actualizan a través de estas comprobaciones, muestra un aviso en tu panel de administración de WordPress pidiéndote que revises la configuración de tu webhook. Para solucionarlo, copia la URL del Webhooks Endpoint de WPForms » Settings » Payments en el campo Webhook URL para el modo que estés utilizando en tu panel de Paystack.
¿Por qué mi formulario dice “Pagos actualmente no disponibles”?
Este mensaje aparece cuando WPForms no puede procesar un pago de Paystack en tu formulario. Estas son las causas más comunes y cómo solucionarlas:
- Paystack no está conectado en el modo actual: Por ejemplo, el modo de prueba está activado, pero no hay claves de prueba guardadas. Ve a WPForms » Ajustes » Pagos y añade las claves para el modo que estés utilizando.
- Las divisas no coinciden: Paystack solo procesa pagos en la divisa de tu cuenta, por lo que cambiar la divisa de WPForms pausa los pagos. Vuelve a establecer la divisa para que coincida con tu cuenta de Paystack.
- La sumisión de formularios AJAX está desactivada: Los pagos de Paystack necesitan la sumisión de formularios AJAX, y algunas plantillas de formularios, incluidas las plantillas de Registro de usuarios, la tienen desactivada por defecto. Para activarla, abre los Ajustes » Generales de tu formulario, expande Avanzados y marca Habilitar sumisión de formularios AJAX.
¿Por qué veo “El importe del pago está por debajo del mínimo permitido”?
Paystack establece un importe mínimo para cada divisa, y WPForms comprueba el total antes de abrir la ventana emergente. Los mínimos son 50 NGN, 0.10 GHS, 3 KES y 1 ZAR. Si el total de tu formulario puede caer por debajo de este importe, ajusta tus precios o utiliza la lógica condicional para omitir el cargo de esos pedidos.
¿Almacena WPForms los detalles de la tarjeta de mis clientes?
No. La ventana emergente de Paystack está alojada por Paystack, por lo que los detalles de la tarjeta van directamente a Paystack y nunca tocan tu sitio. WPForms solo guarda el registro del pago, junto con la marca de la tarjeta y los últimos 4 dígitos para tu referencia.
¡Eso es todo! Ahora puedes aceptar pagos con tarjeta, transferencia bancaria y dinero móvil a través del complemento Paystack de WPForms.
¿A continuación, quieres vigilar más de cerca los pagos que llegan a través de tus formularios? Consulta nuestra guía para ver y gestionar pagos para obtener información sobre los detalles de los pagos, los estados y los reembolsos.
