Transacciones

30 octubre 2024

Obtén la lista de todas las transacciones realizadas con tu comercio a través de este servicio. Aplica filtros para obtener mejores resultados.

Este servicio está disponible para integraciones a través de Cloud terminal API y Raw card-present API.

Ambientes

Realiza todas las adecuaciones a tu sistema mediante pruebas en el ambiente de desarrollo dev. Recuerda que en este ambiente no se procesarán transacciones reales.

Cuando estés listo, podrás cambiar al ambiente de producción live para procesar transacciones reales.

Ambiente	Url base	Disponibilidad
`dev`	https://api-uat.kushkipagos.com	Cloud Terminal API y Raw Card-Present API
`live`	https://api.kushkipagos.com	Cloud Terminal API y Raw Card-Present API

Cloud terminal API y Raw card-present API

Lista de transacciones

Obtén la lista de transacciones estableciendo el número de elementos a devolver así como la página de los resultados (en caso de que existan varias). Máximo 10,000 resultados devueltos por solicitud.

Consume el endpoint Transaction Search enviando tu clave privada en el encabezado Private-Credential-Id y estableciendo los filtros necesarios en el cuerpo de la petición.

Descubre todos los filtros que puedes configurar al momento de enviar una solicitud para obtener la lista de transacciones.

Propiedad	Requerido	Valores permitidos	Descripción
page	Sí		Establece el número de página de los resultados.
size	Sí		Establece el número de elementos devueltos por solicitud. Máximo 500 elementos por página.
filters.bin	No		Filtra por número de BIN.
filters.client_transaction_id	No		Filtra por id de transacción generado de tu lado.
filters.end_date	No		Establece una rango de fecha para consulta de transacciones.
filters.start_date	No		Establece una rango de fecha para consulta de transacciones.
filters.last_four_digits	No		Filtra por los últimos 4 dígitos de la tarjeta.
filters.transaction_reference	No		Filtra por id de la transacción (generado por Kushki).
filters.transaction_type	No	`balanceInquiry`, `capture`, `charge`, `checkIn`, `checkout`, `preAuth`, `reAuthorization`, `tip`, `posTip`	Filtra por tipo de operación.

Ejemplo de solicitud con filtros:

{
  "page": 1,
  "size": 10,
  "filters": {
    "bin": "541333",
    "end_date": 1712322035152,
    "start_date": 1712286000000,
    "last_four_digits": "0653",
    "transaction_type": "preAuth",
    "client_transaction_id": "5bba557f-3df8-4f07-be20-ed1ad6b28c1d",
    "transaction_reference": "62c64ab2-1b09-48bd-ab98-4fa9b1893250"
  }
}

Respuesta

Si la información enviada es correcta y existen transacciones en el rango especificado, recibirás un objeto con la lista de transacciones disponibles:

{
  "items": [
    {
      "amount": {
        "extra_taxes": {}
      },
      "deferred": {},
      "merchant_id": "20000000106781760000",
      "pos_details": {},
      "reading_type": "ICC",
      "payment_brand": "VISA",
      "transaction_type": "PREAUTH",
      "transaction_status": "DECLINED",
      "transaction_reference": "Test_Webhook_PREAUTH_D"
    }
  ]
}

Revisa la referencia de Transacciones para más información.

Anula un pago

Anula un pago previamente autorizado.