Para realizar la conexión correctamente, primero debes contar con las credenciales de integración de PayPal. Actualmente, PayPal utiliza aplicaciones REST API con Client ID y Client Secret para autenticar las integraciones. (PayPal Developer)
📌 En este artículo
¿Qué necesitas antes de comenzar?
¿Cómo obtener las credenciales de PayPal?
¿Cómo configurar PayPal en Zolutium?
¿Cómo realizar una prueba?
¿Cómo pasar de Sandbox a producción?
⚠️ Recomendaciones importantes
1. 📋 Requisitos previos
Antes de comenzar, asegúrate de contar con:
Una cuenta PayPal Business.
Acceso al PayPal Developer Dashboard.
Una aplicación REST API creada en PayPal.
Client ID.
Client Secret.
Acceso a Zolutium para configurar la integración.
PayPal indica que se necesita una cuenta Business para poner una integración en producción y para realizar pruebas fuera de Estados Unidos. (PayPal Developer)
2. 🔑 Crear las credenciales de PayPal
Primero debes obtener las credenciales que utilizarás para conectar PayPal con Zolutium.
Paso 1: Ingresar al portal de desarrolladores
Ingresa al portal de desarrolladores de PayPal y accede con tu cuenta.
Paso 2: Acceder a Apps & Credentials
Ingresa a Apps & Credentials.
Selecciona el entorno que deseas utilizar:
Sandbox: para realizar pruebas.
Live: para pagos reales.
Selecciona Create App.
Ingresa el nombre de tu aplicación.
Crea la aplicación.
PayPal mostrará las credenciales de la aplicación, incluyendo el Client ID y el Client Secret. (PayPal)
3. 🧪 Utilizar Sandbox para realizar pruebas
Si todavía estás configurando la integración, se recomienda comenzar con Sandbox, que es el entorno de pruebas de PayPal.
Desde el Developer Dashboard puedes administrar cuentas Sandbox y utilizarlas para simular transacciones sin utilizar dinero real. (PayPal Developer)
📌 Flujo de prueba
PayPal Sandbox
⬇️
Crear aplicación
⬇️
Obtener Client ID + Client Secret
⬇️
Configurar integración en Zolutium
⬇️
Realizar pago de prueba
4. ⚙️ Configurar PayPal en Zolutium
Una vez que tengas las credenciales:
Ingresa a Zolutium.
Dirígete a Configuración.
Busca la sección de Integraciones.
Selecciona PayPal.
Ingresa las credenciales solicitadas.
Selecciona el entorno correspondiente, si la configuración lo permite.
Guarda los cambios.
Comprueba que la integración aparezca como conectada.
💡 Importante: los nombres exactos de algunos campos pueden variar según la versión de Zolutium. Utiliza las credenciales proporcionadas por PayPal para la aplicación correspondiente.
5. 🔐 ¿Qué son el Client ID y Client Secret?
Estas dos credenciales permiten identificar y autenticar la aplicación que se conecta con PayPal.
🆔 Client ID
Identifica la aplicación creada en PayPal.
🔑 Client Secret
Es una credencial privada utilizada para autenticar la aplicación.
⚠️ Nunca compartas públicamente el Client Secret. PayPal lo utiliza junto con el Client ID para obtener un token de acceso mediante OAuth 2.0. (PayPal Developer)
6. 💳 ¿Cómo funciona la conexión?
Una vez configurada la integración, el proceso puede entenderse de la siguiente manera:
👤 Cliente
⬇️
💳 Selecciona PayPal como método de pago
⬇️
🔗 Se genera/procesa el pago
⬇️
🌐 PayPal procesa la transacción
⬇️
✅ Pago confirmado
⬇️
📊 Zolutium puede utilizar la información correspondiente al pago
La integración utiliza la autenticación de PayPal para permitir que las aplicaciones realicen operaciones mediante sus APIs. (PayPal Developer)
7. 🧪 Realizar una prueba
Antes de utilizar PayPal para pagos reales:
Configura la aplicación en Sandbox.
Utiliza las credenciales Sandbox.
Conecta la integración.
Realiza una transacción de prueba.
Verifica que el proceso de pago funcione correctamente.
Comprueba que Zolutium reciba o procese correctamente la información esperada.
PayPal proporciona cuentas Sandbox de prueba para simular compradores y vendedores. (PayPal Developer)
8. 🚀 Pasar de Sandbox a Live
Cuando hayas terminado las pruebas y quieras comenzar a recibir pagos reales:
Ingresa nuevamente a Apps & Credentials.
Cambia de Sandbox a Live.
Crea u obtén las credenciales Live.
Utiliza el Client ID y Client Secret de producción.
Actualiza la configuración correspondiente en Zolutium.
Realiza una prueba de pago real de forma controlada.
PayPal utiliza un entorno de producción separado del Sandbox y, para las APIs REST, el host de producción es api-m.paypal.com. (PayPal Developer)
⚠️ Puntos importantes
🔐 No compartas tu Client Secret.
🧪 Utiliza Sandbox para las primeras pruebas.
💳 Para pagos reales utiliza las credenciales Live.
🏢 Verifica que tu cuenta PayPal Business esté correctamente configurada.
🔎 Comprueba que las credenciales correspondan al mismo entorno que estás configurando.
✅ Realiza una prueba antes de comenzar a recibir pagos de clientes.
📌 En resumen
La configuración puede resumirse así:
PayPal Developer
⬇️
Crear aplicación
⬇️
Obtener Client ID + Client Secret
⬇️
Zolutium → Configuración → Integraciones → PayPal
⬇️
Ingresar credenciales
⬇️
🧪 Probar en Sandbox
⬇️
🚀 Configurar Live
⬇️
💳 Recibir pagos
💡 Recomendación: realiza primero toda la configuración en Sandbox. Una vez comprobado que el proceso funciona correctamente, cambia a las credenciales Live para comenzar a procesar pagos reales.