Transacciones

18 marzo 2025

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, App-to-app, Terminal SDK 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://valquiria.billpocket.dev	Cloud Terminal API, App to app y Terminal SDK
`dev`	https://api-uat.kushkipagos.com	Raw Card-Present API
`live`	https://valquiria.billpocket.com	Cloud Terminal API, App to app y Terminal SDK
`live`	https://api.kushkipagos.com	Raw Card-Present API

Cloud terminal API, App to app y Terminal SDK

Token

Es necesario generar un token de aplicación a través del endpoint Get token enviando tu token de usuario en el payload. Si la solicitud es correcta, obtendrás el token de aplicación el cuál deberás utilizar al momento de obtener el listado de transacciones.

Ejemplo de solicitud de token:

{
  "token": "48d8fc2257eb61d4814e9cae3fd7385dfedf51133017b35f7a86d113620da413"
}

Ejemplo de respuesta:

{
  "token": "eyJhbGciOiJIUzI1NiIsInC5cCI6LppXVCJ9.eyJ1c2VyX3Rva2VuIjoiNDhkOGZjMjI1N2VjNjFkNDgzNGU5Y2FlM2ZkNzM4NgRmXWRmNTExOTQ8MTdiMzVmN2E4NmQxMTM2MjBkYTQxMyIsImlhdCI6MTY5NDQ3Mjc2NywiZXhwIjoxNak0NDb2Mzs3fQ.KWgOEItUQhjWQR1gp8-lU1CjugQCVRMd4_lHXGGkDac"
}

Revisa la referencia api para más información.

Lista de transacciones

Obtén la lista de transacciones en un rango de fechas específicas. Por defecto, se regresan 100 elementos por solicitud pero puedes configurar hasta un máximo de 600 elementos por solicitud. Las transacciones están ordenadas por la más reciente primero.

Hay cuatro versiones diferentes del endpoint Get transaction list. Cada una, con más filtros o parámetros de respuesta en comparación con su versión anterior.

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

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.