Tarjetas regalo

Podemos crear tarjetas regalo añadiendo tantas actividades del catálogo de actividades como queramos. La estructura de datos para añadir tarjetas regalo al carrito se detalla en la sección añadir al carrito.

Tras la compra de la tarjeta se genera un código único para poder canjearla. En el momento del canje es cuando se elegirán las fechas y las sesiones (si procede) de las actividades.

Para realizar el proceso de canje, los productos que componen la tarjeta se añaden al carrito indicando el código de la tarjeta regalo a la que pertenecen. La estructura de datos para indicar que una actividad pertenece a una tarjeta regalo se detalla en la sección añadir al carrito.

Comprobar tarjeta regalo

Con este método podemos comprobar si una tarjeta regalo es canjeable a partir de un código de canje.

Método de acceso

GET /activity/giftcard

Estructura de la petición

• GiftCardIdentifier: (string). Código de canje.
• LanguageCode: (string) Opcional. Define el idioma en que se mostrarán los textos. Por defecto se devolverá el idioma configurado para el colaborador.

Ejemplo de petición

Default languageSpecific language

{
    "GiftCardIdentifier": "3167250411491835499"
}

{
    "GiftCardIdentifier": "3167250411491835499",
    "LanguageCode": "en"   
}

Estructura de la respuesta

• GiftCardIdentifier: (string). Código de canje.
• SaleId: (string). Identificador de la venta.
• PartnerSaleId: (string). Identificador del colaborador.
• IsExchanged: (boolean). Indica si la tarjeta ya ha sido canjeada.
• HoursInAdvanceOfGiftCardExchange: (short). Horas de antelación del canje respecto a las 00:00 del día siguiente al de la visita. Por ejemplo, si una tarjeta tiene HoursInAdvanceOfGiftCardExchange = 4, y un cliente realiza el canje para el 15 de Agosto, el límite de tiempo que tiene la tarjeta para canjearse son las 20:00 del propio 15 de Agosto (es decir, 4 horas antes de las 00:00 del 16 de Agosto). Esto es importante, por ejemplo, para que un cliente no canjee una tarjeta para un día cuando el recinto ya está a cerrado.
• Message: (string). Mensaje del comprador de la tarjeta dirigido a la persona que va a canjearla.
• Client: (object). Datos del cliente que va a canjear la tarjeta.
  • CreatedDate: (dateTime). Fecha en que se dio de alta.
  • FullName: (string). Nombre.
  • Surname: (string). Apellidos.
  • CountryCode: (string). Código de país.
  • LanguageCode: (string). Código de idioma.
  • Gender: (byte). Género.
  • AcceptsEmailContact: (boolean). Acepta recibir comunicaciones comerciales.
  • AllowCustomerProfiling: (boolean). Acepta la creación de un perfil de cliente.
• Success (boolean): valor que indica si la llamada ha sido procesada correctamente o no.
• Timestamp (dateTime): instante de tiempo en el que se procesó la petición. Formato ISO 8601 (yyyy-MM-ddThh:mm:ss.fffffff).
• ErrorMessage (string): mensaje de error explicando por qué la petición no ha sido correcta. En caso que haya sido correcta, devolverá null.
• ErrorCodes (string[]): lista de códigos que identifican los errores que se hayan producido en la llamada.
• ErrorEntityBreakDown (list): Lista que contiene objetos con el nombre e ID en caso de error.
  • Id (string): Identificador
  • Name (string): Nombre relacionado del identificador.

Ejemplo de respuesta

{
    "GiftCardIdentifier": "3167250411491835499",
    "SaleId": "4000795350002495741",
    "Message": "",
    "Client": {
        "CreatedDate": "2025-06-05T09:32:18",
        "FullName": "Sara Cruz",
        "Surname": "Sara Cruz",
        "Email": "sara.cruz@gmail.com",
        "CountryCode": "es",
        "LanguageCode": "es",
        "Gender": 0,
        "AcceptsEmailContact": false,
        "AllowCustomerProfiling": false
    },
    "PartnerSaleId": "9031552178833_102",
    "Products": [
        {
            "Id": "154864ftfmxh",
            "Name": "Nombre del producto 1"
        },
        {
            "Id": "gimas51204d",
            "Name": "Nombre del producto 2"
        }
    ],
    "HoursInAdvanceOfGiftCardExchange": 0,
    "IsExchanged": false,
    "Success": true,
    "Timestamp": "2025-06-13T10:47:42"
}