Cómo integrar Razorpay con systeme.io

En este artículo aprenderás a integrar tu cuenta de Razorpay con tu cuenta de systeme.io.

Para empezar, necesitarás:

1. Configuración y puesta en marcha

1. Para conectar tu cuenta de Razorpay a tu cuenta de systeme.io, haz clic en tu foto de perfil y luego en Configuración (1). 

En el menú izquierdo de la página, haz clic en Pasarelas de pago (2), luego en Conectar (3).

2. Ingresa tus credenciales de Razorpay en tu cuenta de systeme.io y haz clic en Guardar (4).

2. Generación de las claves de la API ID/Secret

Para obtener la información del ID de la clave API y la clave secreta API de tu cuenta de Razorpay, inicia sesión en tu cuenta de Razorpay, ve a Configuración (4) y luego a Websites & API Keys (5).

Genera y copia las claves API ID/secret (6)

De forma alternativa, inicia sesión en tu cuenta y ve a https://dashboard.razorpay.com/app/keys para generar y copiar las claves API ID/secret

3. Configurar los webhooks de Razorpay:

Copia el webhook URL y el webhook secret desde la sección de Razorpay en tu cuenta de systeme.io.

Haz clic en Configuración (7) en tu cuenta de Razorpay y ve a Webhooks (8) y haz clic en Agregar un webhook nuevo (9).

En la ventana emergente pega la URL del webhook y el webhook secret.

Selecciona los siguientes campos para configurar los eventos.

a. Payment Events:

  • payment.authorized
  • payment.failed
  • payment.captured

b. Order Events:

  • order.paid

c. Invoice Events:

  • invoice.paid

d. Subscription Events:

  • subscription.authenticated
  • subscription.paused
  • subscription.resumed
  • subscription.activated
  • subscription.pending
  • subscription.halted
  • subscription.charged
  • subscription.cancelled
  • subscription.completed
  • subscription.updated

e. Refund Events:

  • refund.processed
  • refund.created

IMPORTANTE: asegúrate de seleccionar los eventos listados arriba. Sin ellos, systeme.io no podrá acceder a la información requerida para capturar las transacciones/suscripciones y los clientes no tendrán acceso a los recursos.

Nota: para que la integración con Razorpay funcione correctamente, tus páginas de pago deben incluir estos campos obligatorios:  correo, nombre, apellido y teléfono. Sin ellos,  los pagos no pueden ser procesados a través de la pasarela de Razorpay.

4. Monedas compatibles y restricciones

Antes de recibir pagos, asegúrate de que tus túneles y productos estén configurados usando una de las monedas compatibles para esta pasarela.

Razorpay tiene reglas específicas dependiendo de si estás procesando pagos únicos o suscripciones:

  • Compradores compatibles: India (IN)
  • Pagos recurrentes (suscripciones): Sí, pero solo se admiten en INR.
  • Monedas compatibles (pagos únicos): INR, LKR, PEN y VND.
  • Restricciones para el comerciante: Tu cuenta de comerciante de Razorpay debe estar registrada en India (IN).

¿Qué sucede cuando hay un error en un pago de Razorpay?

Además del intento de pago principal, se efectuarán tres intentos, con un día entre cada uno. El retraso entre cada intento no puede ser modificado. Sin embargo, el vendedor tiene la opción de hacer un nuevo intento de débito directo desde el panel de Razorpay sin tener que esperar el retraso de un día. Pero es importante tener en cuenta que esto no afectará el número máximo de intentos.