Servicio de suscripciones - Información general

Servicio de suscripciones - Información general

Este servicio permite a los comercios utilizar la funcionalidad de suscribir a sus clientes a cobros automáticos recurrentes en una ventana de tiempo establecida.

La funcionalidad actual, solo permite el pago mensual de las suscripciones creadas, es decir, se rebajará de las tarjetas de sus clientes cada “x” cantidad de meses mientras la suscripción esté activa. 

Todos los endpoints a consumir que se encuentran en este artículo, son del ambiente de Sandbox.

Además, este servicio maneja los siguientes estados para las suscripciones creadas:

  1. Not Paid : Se produce cuando el pago al crear la suscripción falla.
  2. Active : Suscripción activa
  3. On Hold : Suscripción con tres reintentos automáticos de pago  fallidos.
  4. Pending :  Suscripción pendiente de pago (El pago calendarizado falló en la autorización del Banco).
  5. Cancelled : Suscripción cancelada, una vez la suscripción sea cancelada no se podrá activar nuevamente.

Pre requisitos

  1. Tener credenciales de acceso al ambiente sandbox, si no es así, puede crear la cuenta de sandbox en https://sandbox-dashboard.greenpay.me/merchants/new .
  2. Tener tokens de tarjetas registradas en Greenpay, si no es así, visite el  nuestro "Servicio de tokenización de tarjetas".
  3. Tener configurado un URL webhook al cual se enviarán las respuestas de los pagos ejecutados según la recurrencia registrada.


En esta sección se muestra cómo integrarse a las siguientes funcionalidades:

  1. Crear suscripciones
  2. Cancelar suscripciones
  3. Actualizar el monto de una suscripción
  4. Cambiar el token de la tarjeta
  5. Ejecutar un pago manual
  6. Listar suscripciones de un comercio
  7. Listar los pagos de una suscripción


En POSTMAN podrá observar el API de sandbox en funcionamiento.



    • Related Articles

    • Información general

      1. ¿Qué es el checkout o pasarela de pagos en Greenpay? El proceso de checkout es una funcionalidad que le permite a los comercios realizar débitos a las tarjetas o tokens de tarjeta de sus clientes. 2. ¿Cómo integro el checkout de Greenpay? Existen ...
    • Listar pagos de suscripciones

      Para este servicio se debe consumir el siguiente endpoint: https://sandbox-merchant.greenpay.me/subscriptions/list/payments A continuación, se muestra el paso a paso para ejecutar un pago manual de una suscripción en nuestro API de forma exitosa: ...
    • Suscripciones del comercio

      Consideraciones Para utilizar la funcionalidad de suscripciones debe considerar lo siguiente: El comercio debe estar habilitado, si esta deshabilitado no podrá ingresar y utilizar la funcionalidades del dashboard. Si desconoce el estado de su ...
    • Información general

      GreenPay brinda la posibilidad de integrar la pasarela de pagos en las principales plataformas de comercio electrónico por medio de complementos y extensiones. Plugins Si tiene una tienda en las plataformas Wordpress o Magento puede integrar la ...
    • Información General

      Esta funcionalidad les permite guardar tarjetas (tokenización) de los cliente para futuros pagos. Para este servicio se proveen dos formas A través de API totalmente. Con el formulario de registro de tarjetas de Greenpay. ¿Para que sirve? Es ...