Consultar listado de Planes
GET/plan
Consultar listado de Planes
Request
Query Parameters
Máximo de registros a regresar
Número de página
Possible values: [actualizacion, creacion, estado, frecuencia, id, monto, nombre, puede_suscribir, tipo_periodo]
Valor que será usado como referencia en la búsqueda
Possible values: [asc, desc]
Podrá ser de orden Ascendente (asc) o Descendente (desc)
Responses
- 200
- 400
- 401
- 404
- 4XX
- 5XX
Listado de objetos tipo Plan
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Possible values: [success, fail, error]
Estatus de la petición
Possible values: [200, 400, 401, 404, 500]
Código http de respuesta en el header
Fecha y hora de creación del plan
Tiempo Unix o POSIX
data
object
planes
object
data
object[]
Id de Plan
Identificador único de Plan en plataforma del comercio
Fecha de creación del objeto
Fecha de última edición
Nombre de Plan
Monto que será cobrado en la suscripción
Determina si podrán crearse suscripciones con montos variables
Monto máximo para suscripcioones con monto variable
Monto mínimo para suscripcioones con monto variable
Possible values: >= 3 characters and <= 3 characters
Identificador de moneda de tres caracteres de acuerdo al estándar ISO 4217
Possible values: >= 3 characters and <= 3 characters
Default value: MEX
Identificador de país de tres caracteres
Possible values: >= 1
Determina cuantas veces debe repetirse el tipo de periodo para que se realice el siguiente cobro
Possible values: [dia, semana, mes, anio]
Puede ser "dia", "semana", "mes", o "anio"
Possible values: <= 10
Máximo de reintentos (uno por día) que serán realizados antes de cancelar una suscripción, en el caso por defecto se realizarán 3 reintentos, será posible realizar un máximo de 10 reintentos
Possible values: [activo, inactivo]
Estado del plan ('activo' / 'inactivo')
Determina si podrán crearse nuevas suscripciones en un plan
Possible values: >= 1
Determina cuantas veces debe repetirse el tipo de periodo para que se designe el día de primer cobro (al término del periodo de prueba)
Possible values: [dia, semana, mes, anio]
Puede ser "dia", "semana", "mes", o "anio"
Determina si podrán crearse múltiples suscripciones a un mismo plan por un mismo cliente
Default value: 1
Determina el número máximo de suscripciones, por usuario, a un mismo plan cuándo la bandera puede_duplicar está activa
Índice de inicio
Índice de fin
Possible values: >= 5 and <= 100
Default value: 25
Número de registros por página
Possible values: >= 1
Página actual de registros
Possible values: >= 1
Número de última página
Total de registros en la página actual
Total de registros
{
"status": "success",
"http_code": 200,
"datetime": "2024-05-22T21:56:52.910Z",
"timestamp": 0,
"data": {
"planes": {
"data": [
{
"id": "string",
"id_externo": "string",
"creacion": "2024-05-22T21:56:52.911Z",
"actualizacion": "2024-05-22T21:56:52.911Z",
"nombre": "string",
"monto": 129.99,
"monto_variable": false,
"monto_minimo": 0,
"monto_maximo": 0,
"moneda": "MXN",
"pais": "MEX",
"frecuencia": 0,
"tipo_periodo": "dia",
"max_reintentos": 0,
"estado": "activo",
"puede_suscribir": true,
"prueba_frecuencia": 0,
"prueba_tipo_periodo": "dia",
"puede_duplicar": false,
"max_suscripcion_usuario": 1
}
],
"desde": 0,
"hasta": 0,
"registros_por_pagina": 25,
"pagina_actual": 0,
"ultima_pagina": 0,
"total_pagina": 0,
"total": 0
}
}
}
Error en petición
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.911Z",
"timestamp": 0,
"data": {}
}
No autorizado
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.911Z",
"timestamp": 0,
"data": {}
}
No se ha encontrado el recurso solicitado
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.911Z",
"timestamp": 0,
"data": {}
}
Error en petición
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.911Z",
"timestamp": 0,
"data": {}
}
Error interno
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.911Z",
"timestamp": 0,
"data": {}
}