Enviar Solicitud de Cancelación de Transacción

Este método permite que Colaborador pueda solicitar la cancelación de una transacción en el sistema de Experticket.

1. Método de Acceso

Parámetro

Descripción

URL

https://demo.api.experticket.com/api/cancellationrequest

Verbo HTTP

POST

 

2. Estructura de Datos de Envío

La API requiere que se envíen los siguientes parámetros en el cuerpo de la solicitud (POST):

Campo

Descripción

ApiKey

Clave única y privada del colaborador. Mantener en secreto.

IsTest

true: prueba sin acción real, false: solicitud real.

SaleId

Obligatorio. Identificador de la venta.

Reason

Código del motivo de cancelación (ver lista).

ReasonComments

Comentarios adicionales sobre la cancelación.

api-version

Versión del API (3.47 por defecto).

 

3. Motivos de Cancelación Disponibles

Código

Motivo

1

Cambio en fechas de acceso

2

Cambio de productos

3

Cambio en cantidad de asistentes

4

Enfermedad común

5

Gestión indebida de venta de entradas

6

Problemas con la integración

7

Error en el pago

 


 

4. Ejemplo de Solicitud POST

🔹 Cancelar una transacción por cambio en fechas de acceso

{

    "ApiKey": "xyz123",

    "SaleId": "5254956087182040038",

    "Reason": 1,

    "ReasonComments": "El cliente solicitó una nueva fecha de acceso."

}

5. Estructura de la Respuesta

Campo

Descripción

CancellationRequestId

Identificador único de la solicitud de cancelación.

Success

true si la solicitud se registró correctamente.

Timestamp

Marca de tiempo de la respuesta.

ErrorMessage

Mensaje de error si la solicitud falla.

ErrorCodes

Lista de códigos de error, si aplica.

ErrorEntityBreakDown

Información detallada en caso de error.

 

6. Ejemplo de Respuesta Exitosa

{

    "CancellationRequestId": "81e8hfmxa16s6",

    "Success": true,

    "Timestamp": "2021-02-18T17:02:27.8165916",

    "ErrorEntityBreakDown": []

}

7. Consideraciones Finales

  • ✅ Este método solo envía la solicitud de cancelación, pero no garantiza la cancelación automática de la venta.
  • 🔄 Si Success = true, la cancelación debe ser revisada y aprobada manualmente en Experticket.
  • ⚠️ En caso de error, revisar ErrorMessageErrorCodes en la respuesta.

📌 El campo SaleId es obligatorio para identificar la transacción a cancelar.

¿Te ha parecido útil este artículo?