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 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 articulo, 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

      Esta funcionalidad les permite crear tokens a las tarjetas de los clientes. Para este servicio se proveen dos formas, la primera consiste en realizar llamados directamente al API donde se le envía la información cifrada de la tarjeta  La segunda ...
    • 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: ...
    • Información general - plugins

      GreenPay brinda la posibilidad de integrarse al servicio de checkout en las plataformas de Magento 1.9 y Wordpress por medio de plugins. Las funcionalidades que se brindan por cada plugin son las siguientes: Magento Checkout por medio de web forms ...
    • 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

      1. ¿Qué es el checkout o pasarela de pagos en Greenpay? El checkout es un funcionalidad que le permite a los comercio realizar débitos a las tarjetas o tokens de tarjeta de sus clientes. 2. ¿Cómo integro el checkout de Greenpay? Para integrar este ...