Recursos para IA
Suscripciones
La API de Suscripciones permite crear y gestionar cobros recurrentes automáticos. Define la frecuencia y el monto; Mercado Pago se encarga de los cobros y los reintentos si un pago es rechazado. Esta referencia describe los endpoints disponibles y cómo interactuar con ellos.
¿Buscas los pasos de integración? Ir a la documentación de Suscripciones
Endpoints disponibles
Todos los endpoints que componen la integración con la API de Suscripciones.
Una suscripción es el objeto central de la integración. Puede crearse directamente con un medio de pago del suscriptor o vincularse a un plan existente.
| Operación | Path | Descripción |
| Crear suscripciónPOST | /preapproval | Crea una suscripción con monto, frecuencia y medio de pago del suscriptor; puede vincularse a un plan o configurarse de forma independiente. |
| Buscar en suscripcionesGET | /preapproval/search | Busca suscripciones por filtros como estado, preapproval_plan_id o pagador; devuelve resultados paginados. |
| Obtener suscripciónGET | /preapproval/{id} | Obtiene el estado y detalle de una suscripción a partir de su ID. |
| Actualizar suscripciónPUT | /preapproval/{id} | Actualiza los datos de una suscripción, como el estado, el monto o el medio de pago. |
| Exportar suscripcionesGET | /preapproval/export | Exporta un archivo CSV con las suscripciones que coinciden con los parámetros de búsqueda. |
Un plan define los parámetros de cobro compartidos por un grupo de suscriptores: monto, frecuencia y configuración del método de pago.
| Operación | Path | Descripción |
| Crear plan de suscripciónPOST | /preapproval_plan | Crea una plantilla de suscripción con frecuencia y monto fijos para vincular múltiples suscriptores. |
| Buscar en planesGET | /preapproval_plan/search | Busca planes de suscripción por filtros como estado o nombre; devuelve resultados paginados. |
| Obtener plan de suscripciónGET | /preapproval_plan/{id} | Obtiene el detalle de un plan de suscripción a partir de su ID. |
| Actualizar plan de suscripciónPUT | /preapproval_plan/{id} | Actualiza los datos de un plan de suscripción existente. |
Una factura representa cada cobro recurrente generado por la suscripción, con el estado y el resultado del intento de cobro correspondiente.
| Operación | Path | Descripción |
| Obtener datos de facturaGET | /authorized_payments/{id} | Obtiene el detalle de una factura (cobro autorizado) de una suscripción a partir de su ID. |
| Buscar en facturasGET | /authorized_payments/search | Busca facturas por filtros como preapproval_id o estado; devuelve resultados paginados. |
Los pagos son las transacciones vinculadas a las facturas de la suscripción. Úsalos para verificar el estado y el detalle final de cada cobro procesado.
| Operación | Path | Descripción |
| Buscar en pagosGET | /v1/payments/search | Busca los pagos asociados a una suscripción por filtros como fecha o estado; cubre los últimos 12 meses. |
| Obtener pagoGET | /v1/payments/{id} | Obtiene el estado y detalle de un pago a partir de su ID. |
¿Todo listo para empezar?
Ve al primer endpoint y empieza a crear tus primeras suscripciones.