# ¡Bienvenid@ a Reveniu! 👋

El éxito de tu negocio depende de la solidez del producto, su propuesta de valor para los clientes, y de tu capacidad de cobrar bien.&#x20;

Con la **API** **Reveniu** puedes gestionar el cobro de suscripciones y pagos recurrentes de la forma más rápida y *ad hoc* al modelo de cobros de tu negocio para que aumentes tu "*speed to market*" (cuando tu equipo es pequeño y requiere elegir sus batallas para crecer) o para cuando necesitas enfocarte en el producto, en vez de gastar dinero y energía en procesar cobros de suscripciones, pagos recurrentes y lidiar con problemas de información de cobros y clientes.

### Por qué usar Reveniu&#x20;

**Gastar tiempo y esfuerzo en crear y mantener un sistema de pagos propio no es la mejor estrategia en la mayoría de los casos.** Por eso es preferible usar una plataforma - como la nuestra - especializada en gestionar el proceso 360 de manejo de suscripciones, cobros, notificaciones y datos de clientes y planes, a la que delegar este problema, mientras tú te ocupas de lo que hace a tu negocio un *negocio* 🎉.&#x20;

La **API Reveniu** está diseñada para ahorrarte dolores de cabeza y para que puedas cobrar y administrar suscripciones, pagos recurrentes y clientes de forma clara en tu aplicación, de forma programática.

**Reveniu** **encapsula toda la lógica de registros, devoluciones, cobros recurrentes y maneja todo desde un único API simple de usar.** Adicionalmente te ofrece una vista completa donde puedes manejar tus pagos (si por ejemplo no deseas crear una vista interna de clientes, planes y suscripciones en tu propio sistema) y no debes pasar por pruebas de certificación, seguridad, etc, porque el proceso de pago se encuentra ya validado dentro de **Reveniu.**

### El API REST de Reveniu 👀 <a href="#id-3a2a" id="id-3a2a"></a>

A través de un sencillo API [Rest](https://en.wikipedia.org/wiki/Representational_state_transfer) ⚡️, **Reveniu** te permite integrar el sistema de suscripciones de tu servicio o negocio y cobrar recurrentemente a las tarjetas de tus clientes, mientras puedes actualizar el estatus de pago y tomar decisiones al respecto (ejemplo: deseas cancelar el acceso a tu sistema si la suscripción expira) en tiempo real,&#x20;

### ¿Qué casos de uso puedes implementar en Reveniu? <a href="#b75e" id="b75e"></a>

1. Integrar el proceso de pagos únicos o recurrentes directamente en tu sistema, iniciándolo en tu propio sitio o aplicación y regresando al sitio que configures.
2. Tomar decisiones de negocio relacionadas al estatus de pago de una suscripción.
3. Activar procesos (ej. envío, acceso a servicios) dependiendo de la respuesta de un pago.
4. Básicamente, usar la API para cualquier proceso que tenga que ver con cobrarle a tus clientes.

**Reveniu** provee un ambiente *sandbox* para que puedas desarrollar tu integración y probarla sin riesgos. Sólo tienes que crear [una cuenta en dicho ambiente](https://sandbox.reveniu.com/) y generar tu clave secreta.

Una vez que esté lista tu integración, debes generar una nueva clave desde la cuenta de producción en tu negocio y apuntar los servicios a los correctos.

![API Key Reveniu](https://miro.medium.com/max/1400/1*XYb5tU68GrrqaLOi9h_LAQ.jpeg)

### Alcance de esta versión (en constante actualización) <a href="#id-1358" id="id-1358"></a>

Para esta versión nos enfocamos en hacer un API muy liviano, que te permitirá:

1. Integrar el proceso de compra de tu cliente con la mínima presencia de Reveniu y aumentar el protagonismo de tu marca.
2. Los procesos de éxito y fracaso pueden ser capturados en las páginas que tú decidas.
3. A través de *webhooks* tu sistema será notificado de diferentes eventos ocurridos a las suscripciones de tu comercio: suscripciones creadas, pagos exitosos, pagos fallidos, recuperaciones, etc.

### Límites <a href="#id-1d1f" id="id-1d1f"></a>

Para el uso del API Rest, tienes un límite de **hasta 100 peticiones** por minuto.

### Queremos tu feedback

Si tienes dudas, propuestas de mejoras o quieres solicitar nuevas funcionalidades, escríbenos a <developers@reveniu.com>. Respondemos de una.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.reveniu.com/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
