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 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.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 | 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#
