Configura la REST API de PayPal para integrar pagos modernos en tu tienda online

La REST API de PayPal es la nueva generación de APIs que reemplaza a las APIs clásicas NVP/SOAP. Ofrece mejor seguridad, mayor flexibilidad y es más fácil de implementar.

Requisitos previos

Antes de comenzar necesitas:

  • Una cuenta PayPal Business activa
  • Acceso al panel de desarrollador de PayPal
  • Tu tienda online configurada

Si no tienes una cuenta PayPal Business, puedes crearla siguiendo nuestra guía completa.


Paso 1: Acceder al panel de desarrollador

Lo primero es acceder al Panel de Desarrollador de PayPal e iniciar sesión con tu cuenta PayPal Business.

Panel de Desarrollador de PayPal - inicio de sesión
Dashboard del Panel de Desarrollador de PayPal


Paso 2: Crear una nueva aplicación

Una vez dentro del panel, sigue estos pasos:

  1. Haz clic en “My Apps & Credentials” en el menú principal
  2. Selecciona la pestaña “Live” para el entorno de producción (o “Sandbox” para pruebas)
  3. Haz clic en el botón “Create App”
Sección My Apps and Credentials en PayPal Developer
Formulario Create App en PayPal Developer


Paso 3: Configurar los datos de la aplicación

Completa el formulario con la siguiente información:

  1. Nombre de la aplicación: Introduce un nombre descriptivo (por ejemplo: “Mi Tienda Online”)
  2. Cuenta del comerciante: Selecciona tu cuenta PayPal Business de la lista desplegable
  3. Características: Marca las casillas según necesites:
    • Accept payments (Aceptar pagos) - Obligatorio
    • Access seller information - Para obtener información del vendedor
    • Payouts - Solo si necesitas enviar pagos
Formulario de configuración de datos de la aplicación PayPal

Haz clic en “Create App” para continuar.


Paso 4: Obtener las credenciales

Una vez creada la aplicación, PayPal te mostrará las credenciales necesarias:

Client ID. Es un identificador público de tu aplicación. Se muestra directamente en pantalla y puedes copiarlo.

Secret Key.Es la clave privada y confidencial. Para verla:

  1. Haz clic en “Show” junto a “Secret”
  2. Copia la clave que aparece
  3. ¡Importante! Guarda esta clave de forma segura, no la compartas
Client ID de la aplicación PayPal en el panel de desarrollador
Secret Key de la aplicación PayPal - opción Show


Paso 5: Configurar en tu tienda online

Con las credenciales obtenidas, configura PayPal en tu tienda:

  1. Ve a Ajustes > Métodos de pago en tu panel
  2. Selecciona PayPal REST API
  3. Introduce las credenciales:
    • Client ID: El identificador que copiaste
    • Secret Key: La clave secreta que obtuviste
  4. Selecciona el entorno (Sandbox para pruebas, Live para producción)
Configuración de PayPal REST API en el panel de ajustes de la tienda
Demostración de configuración de PayPal REST API en la tienda online

Nota importante: Al activar PayPal REST API se desactivará automáticamente PayPal Classic si lo tenías configurado anteriormente. Esto es normal y necesario, ya que ambas APIs no pueden funcionar simultáneamente para evitar conflictos en el procesamiento de pagos.


Paso 6: Realizar una prueba

Para asegurarte de que todo funciona correctamente:

  1. En Sandbox (pruebas):
    • Realiza una compra de prueba
    • Usa las cuentas de prueba de PayPal
    • Verifica que se procese el pago
  2. En Live (producción):
    • Realiza una pequeña compra real
    • Confirma que el pago llega a tu cuenta PayPal
    • Verifica que se envíe la confirmación al cliente

Diferencias entre Sandbox y Live

Sandbox (Entorno de pruebas):

  • Para realizar pruebas sin dinero real
  • Usa cuentas ficticias de PayPal
  • Los pagos no son reales

Live (Entorno de producción):

  • Para recibir pagos reales de clientes
  • Usa tu cuenta PayPal Business real
  • Los pagos se procesan con dinero real


¡Y listo! Ya tienes configurada la REST API de PayPal. Ya puedes empezar a recibir pagos.