API · Obtener un cupón

API v1

POST /api/v1/getCoupon

Qué hace#

Devuelve un cupón puntual.

Autenticación#

Requiere el token bearer del API en el header Authorization — ver autenticación.

Parámetros#

keystringrequerido#

Key de la integración Tilopay.

idstringrequerido#

Id del cupón.

Ejemplo de request#

Los valores <...> son marcadores: reemplazalos por tus credenciales y datos.

{
  "key": "<api_key>",
  "id": "1"
}

Respuesta#

{
  "type": "200",
  "message": "Success",
  "data": {
    "id": 10788,
    "recurrent_id": 10,
    "code": "E6RMS339",
    "active_users": 1,
    "type_discount": 1,
    "discount": "40.00",
    "expire": "2026-10-20",
    "email_group": 1,
    "email": "cliente@ejemplo.com, otro@ejemplo.com",
    "usage": 1,
    "renews": 2,
    "renews_by_user": 2,
    "usage_counter": 0,
    "created_at": "2026-09-02T20:12:01.000000Z",
    "updated_at": "2026-09-02T20:12:01.000000Z",
    "deleted_at": null
  }
}

email es una cadena con correos separados por coma, no un arreglo, y discount viene como cadena, no como número. Esta operación devuelve created_at en formato ISO, más recurrent_id, updated_at y deleted_at; el listado de cupones devuelve otra forma del mismo cupón — ver convenciones de las respuestas.

Para interpretar una respuesta que no es de éxito, ver cómo leer una respuesta de error.

Última verificación: 2026-09-02 · Responsable: equipo-integraciones

Ver como Markdown crudo