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.


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”


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

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


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)

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.