Integrar PayPal con GlobalSuite PR

PayPal es uno de los métodos de pago más reconocidos del mundo. Al integrarlo con GlobalSuite PR, tus clientes podrán pagar sus facturas con su cuenta PayPal o con tarjeta de crédito/débito a través de la plataforma de PayPal.

💡
¿Stripe o PayPal?

Puedes tener ambos activos al mismo tiempo. Stripe es generalmente preferido para pagos con tarjeta directa (sin cuenta PayPal), mientras que PayPal es ideal si tus clientes ya tienen una cuenta PayPal activa. Muchos negocios ofrecen las dos opciones.

Lo que necesitas antes de empezar

  • Una cuenta PayPal Business activa y verificada. Una cuenta personal no funciona para cobros de negocios.
  • La cuenta Business debe estar asociada a una cuenta bancaria para recibir los pagos.
  • Acceso al PayPal Developer Portal (developer.paypal.com) — se usa el mismo usuario y contraseña de tu cuenta PayPal.

Paso 1 — Crear cuenta PayPal Business

Si ya tienes una cuenta PayPal Business activa, salta al Paso 2.

1

Ve a paypal.com/us/business

Haz click en Get Started o Sign Up.

2

Selecciona "Business Account"

Es importante elegir cuenta Business, no Personal. La cuenta Business permite recibir pagos de clientes de manera profesional.

3

Llena los datos del negocio

Nombre legal del negocio, email de negocio, tipo de empresa (sole proprietor, LLC, etc.), EIN y dirección en Puerto Rico.

4

Verifica y vincula tu banco

PayPal te pedirá verificar la cuenta con un depósito de prueba de centavos. Una vez verificado, los pagos pueden transferirse a tu banco.

Paso 2 — Obtener las credenciales API de PayPal

GlobalSuite PR usa la API REST de PayPal, que requiere un Client ID y un Client Secret.

1

Abre el Developer Portal

Ve a developer.paypal.com y haz click en Log into Dashboard. Usa el mismo email y contraseña de tu cuenta PayPal Business.

2

Ve a Apps & Credentials

En el menú superior, haz click en Apps & Credentials.

3

Cambia a modo Live

En la parte superior hay un toggle Sandbox / Live. Selecciona Live para obtener las credenciales de producción.

4

Crea una nueva app

Haz click en Create App. Ponle un nombre (ej. GlobalSuite PR CRM), selecciona tu cuenta Business y haz click en Create App.

5

Copia el Client ID y Client Secret

En la página de tu app verás el Client ID (visible) y el Client Secret (haz click en Show para verlo). Cópialos en un lugar seguro.

⚠️
El Client Secret es como una contraseña

Nunca compartas el Client Secret públicamente. Si sospechas que fue comprometido, regresa al Developer Portal y genera uno nuevo.

Paso 3 — Conectar PayPal en GlobalSuite PR

1

Ve a Payment Gateways

En GlobalSuite PR, ve a Setup → Finance → Payment Gateways.

2

Selecciona PayPal

Haz click en PayPal en la lista de gateways disponibles.

3

Pega las credenciales

Ingresa el Client ID y Client Secret de tu app de PayPal Live.

4

Configura el modo

Asegúrate de que el modo esté en Live (no Sandbox). El modo Sandbox es solo para pruebas.

5

Activa y guarda

Activa el toggle de PayPal y haz click en Save.

PayPal activo

A partir de ahora, el botón de PayPal aparecerá en las facturas que envíes. Cuando tu cliente pague, la factura se marcará como pagada automáticamente y recibirás el dinero en tu cuenta PayPal (desde donde puedes transferirlo a tu banco).

Comisiones de PayPal

  • Pagos dentro de EE.UU. (incluyendo PR): 3.49% + tarifa fija (varía por moneda)
  • Pagos internacionales: 4.99% + tarifa fija
  • Tarifa fija para USD: $0.49 por transacción

Ejemplo: en una factura de $500, PayPal retiene aproximadamente $17.94 (3.49% + $0.49).

💡
Stripe tiene comisiones más bajas

Para la mayoría de los negocios, Stripe (2.9% + $0.30) resulta más económico que PayPal (3.49% + $0.49). Si quieres minimizar las comisiones, considera ofrecer Stripe como opción principal y PayPal como alternativa.

Probar con Sandbox

Antes de activar en producción, puedes probar la integración con el entorno Sandbox de PayPal:

  1. En el Developer Portal, cambia al modo Sandbox y crea una app de prueba.
  2. Copia las credenciales Sandbox (Client ID y Secret del Sandbox).
  3. En GlobalSuite PR, configura PayPal con esas credenciales y selecciona modo Sandbox.
  4. Usa las cuentas de prueba de PayPal Sandbox para simular pagos.
  5. Cuando todo funcione correctamente, reemplaza con las credenciales Live.
🔍