Objeto

El objeto evento es la representación de una acción que ha ocurrido en la plataforma de Kausanna. Cada vez que ocurre una acción, se genera un evento que contiene información sobre lo que ha ocurrido y se te envía a tu servidor a través de una conexión segura. Tiene la siguiente estructura:

{
  "id": "evt_2o3k4j5l6m",
  "type": "chargeback.created",
  "timestamp": "2020-01-01T00:00:00Z",
  "test": true,
  "data": {
    "param": "value"
  }
}

string

El identificador único del evento.

string

El tipo de evento. Indica la acción que ha ocurrido. Su formato es recurso.accion.

string

La fecha y hora en la que ocurrió el evento.

boolean

Indica si el evento fue generado en un ambiente de pruebas.

object

Un objeto con la información específica del evento. Consulta la documentación de cada evento para conocer los campos que contiene.

Ejemplo de request HTTP

POST /webhooks HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 123
x-hmac-hash: abcakdaodsdslajsdi12381293ijndaksdjnqd

{
  "id": "evt_2o3k4j5l6m",
  "type": "chargeback.created",
  "timestamp": "2020-01-01T00:00:00Z",
  "test": true,
  "data": {
    "param": "value"
  }
}

Webhooks

Evento de pruebas

Cuando ejecutas la acción de probar los webhooks de tu cuenta en Kausanna, te llegará un evento como el siguiente:

{
  "test": true,
  "event": "chargeback.created",
  "data": {
    "message": "Test webhook"
  }
}

Contracargos

Evento de nuevo contracargo

El evento de tipo chargeback.created contiene la siguiente información:

{
  "id": "200002043925",
  "data": {
    "acquirerId": "002222",
    "merchantId": "002403845259",
    "chargebackIds": ["300003030396", "300003030396"],
    "amount": "938.61 MXN",
    "primaryAccountNum": "5123********6694",
    "transactionId": "120602363",
    "isFraud": false
  },
  "type": "chargeback.created",
  "origin": "mastercard"
}

string

El identificador único del evento.

string

El tipo de evento. Indica la acción que ha ocurrido. Su formato es recurso.accion.

string

La fecha y hora en la que ocurrió el evento.

boolean

Indica si el evento fue generado en un ambiente de pruebas.

object

Un objeto con la información específica del evento. Consulta la documentación de cada evento para conocer los campos que contiene.

string

El identificador del adquirente.

string

El identificador del comercio.

array

Un arreglo con los identificadores de los contracargos.

string

El monto del contracargo.

string

El número de tarjeta enmascarado.

string

El identificador de la transacción.

boolean

Indica si el contracargo es por fraude.

Por seguridad, el campo primaryAccountNum es enmascarado.

Evento de contracargo actualizado

El evento de tipo chargeback.updated contiene la siguiente información:

{
  "id": "200002043925",
  "data": {
    "acquirerId": "002222",
    "merchantId": "002403845259",
    "chargebackIds": ["300003030396", "300003030396"],
    "amount": "938.61 MXN",
    "primaryAccountNum": "5123********6694",
    "transactionId": "120602363",
    "isFraud": false
  },
  "type": "chargeback.updated",
  "origin": "mastercard"
}

string

El identificador único del evento.

string

El tipo de evento. Indica la acción que ha ocurrido. Su formato es recurso.accion.

string

La fecha y hora en la que ocurrió el evento.

boolean

Indica si el evento fue generado en un ambiente de pruebas.

object

Un objeto con la información específica del evento. Consulta la documentación de cada evento para conocer los campos que contiene.

string

El identificador del adquirente.

string

El identificador del comercio.

array

Un arreglo con los identificadores de los contracargos.

string

El monto del contracargo.

string

El número de tarjeta enmascarado.

string

El identificador de la transacción.

boolean

Indica si el contracargo es por fraude.

Evento de contracargo resuelto

El evento de tipo chargeback.resolved contiene la siguiente información:

{
  "id": "200002043925",
  "data": {
    "acquirerId": "002222",
    "merchantId": "002403845259",
    "chargebackIds": ["300003030396", "300003030396"],
    "amount": "938.61 MXN",
    "primaryAccountNum": "5123********6694",
    "transactionId": "120602363",
    "isFraud": false
  },
  "type": "chargeback.resolved",
  "origin": "mastercard"
}

string

El identificador único del evento.

string

El tipo de evento. Indica la acción que ha ocurrido. Su formato es recurso.accion.

string

La fecha y hora en la que ocurrió el evento.

boolean

Indica si el evento fue generado en un ambiente de pruebas.

object

Un objeto con la información específica del evento. Consulta la documentación de cada evento para conocer los campos que contiene.

string

El identificador del adquirente.

string

El identificador del comercio.

array

Un arreglo con los identificadores de los contracargos.

string

El monto del contracargo.

string

El número de tarjeta enmascarado.

string

El identificador de la transacción.

boolean

Indica si el contracargo es por fraude.

Documentación

Documento rechazado

El evento de tipo document.rejected contiene la siguiente información:

{
  "event": "documentation.rejected",
  "message": "The document uploaded didn't pass documentation checks",
  "disputeId": "1706558731586",
  "object": ["1706558731586", "01HQ0V0P7A122CR72T3M71H828.png"]
}

Cuando nuestra plataforma rechaza un documento, te enviamos un evento con la información necesaria para que puedas tomar las acciones necesarias.

string

El tipo de evento. Indica la acción que ha ocurrido.

string

El mensaje que describe el motivo del rechazo.

string

El identificador único del contracargo.

array

Un arreglo con los identificadores del contracargo y el documento rechazado.

Origenes disponibles

Origen	Descripción
mastercard	Eventos relacionados con tarjetas Mastercard.
visa	Eventos relacionados con tarjetas Visa.
amex	Eventos relacionados con tarjetas American Express.
discover	Eventos relacionados con tarjetas Discover.
diners	Eventos relacionados con tarjetas Diners Club.
nx	Eventos relacionados con tarjetas NaranjaX.

Empezando

Disputas

Webhooks

Changelog

El objeto evento

Objeto

Ejemplo de request HTTP

Webhooks

Evento de pruebas

Contracargos

Evento de nuevo contracargo

Evento de contracargo actualizado

Evento de contracargo resuelto

Documentación

Documento rechazado

Origenes disponibles

​Objeto

​Ejemplo de request HTTP

​Webhooks

​Evento de pruebas

​Contracargos

​Evento de nuevo contracargo

​Evento de contracargo actualizado

​Evento de contracargo resuelto

​Documentación

​Documento rechazado

​Origenes disponibles

Objeto

Ejemplo de request HTTP

Webhooks

Evento de pruebas

Contracargos

Evento de nuevo contracargo

Evento de contracargo actualizado

Evento de contracargo resuelto

Documentación

Documento rechazado

Origenes disponibles