Consultar un Plan por medio de id_externo
GET/plan/id_externo/:id_externo
Consultar un Plan por medio de id_externo
Request
Path Parameters
Identificador único de Plan en plataforma del comercio
Responses
- 200
- 400
- 401
- 404
- 4XX
- 5XX
Objeto tipo Plan
- application/json
- Schema
- Example (from schema)
Schema
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
plan
object
Objeto Plan de Suscripción
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
{
"status": "success",
"http_code": 200,
"datetime": "2024-05-22T21:56:52.919Z",
"timestamp": 0,
"data": {
"plan": {
"id": "string",
"id_externo": "string",
"creacion": "2024-05-22T21:56:52.919Z",
"actualizacion": "2024-05-22T21:56:52.919Z",
"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
}
}
}
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.920Z",
"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.920Z",
"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.920Z",
"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.920Z",
"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.920Z",
"timestamp": 0,
"data": {}
}