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.Todas las solicitudes las deberás realizar desde tu back end.
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.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.Expiración del token: 6 horas.
{
"token": "48d8fc2257eb61d4814e9cae3fd7385dfedf51133017b35f7a86d113620da413"
}
{
"token": "eyJhbGciOiJIUzI1NiIsInC5cCI6LppXVCJ9.eyJ1c2VyX3Rva2VuIjoiNDhkOGZjMjI1N2VjNjFkNDgzNGU5Y2FlM2ZkNzM4NgRmXWRmNTExOTQ8MTdiMzVmN2E4NmQxMTM2MjBkYTQxMyIsImlhdCI6MTY5NDQ3Mjc2NywiZXhwIjoxNak0NDb2Mzs3fQ.KWgOEItUQhjWQR1gp8-lU1CjugQCVRMd4_lHXGGkDac"
}
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.Solo se regresan transacciones mayores a 60 segundos.
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"
}
]
}
Explora esta sección#
