Notas de versión

Descubre los últimos lanzamientos de funcionalidades, las mejoras de producto y las correcciones de errores de Kushki Card Present Payment Services.

Mantente al día de los cambios y actualizaciones de la API de Kushki.

Historial completo

Las entradas anteriores a septiembre de 2025 se mantienen en inglés. Puedes consultar el historial completo en la versión en inglés de esta página.

Usamos el estándar ISO 8601 (YYYY-MM-DD) para las fechas y el versionado semántico (MAJOR.MINOR.PATCH) para los números de versión, incrementando:

la versión MAJOR cuando hacemos cambios incompatibles en la API,

la versión MINOR cuando agregamos funcionalidad de forma retrocompatible, y

la versión PATCH cuando corregimos errores de forma retrocompatible.

NEW para funcionalidades nuevas.

IMPROVEMENTS para cambios en funcionalidad existente.

DEPRECATED para funcionalidades que se eliminarán pronto.

REMOVED para funcionalidades ya eliminadas.

FIX para correcciones de errores.

SECURITY en caso de vulnerabilidades.

Última versión

1.4.0 - 2026-09-02

NEW

🔖 Endpoint de alertas de fraude

Ya está disponible un nuevo endpoint para consultar los registros de alertas de fraude que VISA y Mastercard ponen a disposición de Kushki, sin esperar a que un archivo se entregue manualmente por SFTP.

El endpoint Query fraud alerts devuelve los registros de los dos programas de reporte de fraude de las marcas de tarjeta — TC40 (VISA) y SAFE (Mastercard). Cubre tanto las transacciones presenciales procesadas con API Raw como las no presenciales, y es el mismo endpoint documentado en Online Payments.

Admite dos modos de consulta: por rango de fechas, con from y to y los filtros opcionales brand, country, fraud_type y merchant_id, o por identificador de transacción, con transaction_arn o transaction_reference. Los resultados se paginan con page y limit.

La autenticación es a nivel de customer: envía tu credencial privada de customer en la cabecera Private-merchant-id y usa el campo merchant_id para limitar la consulta a sucursales concretas.

⚠️ Disponibilidad: this report is only available for transactions made with VISA and MASTERCARD cards, and only for Kushki's acquiring.

ℹ️ Límite de rango de fechas: queries are limited to a maximum of 12 months from the current date, and from and to must use the exact format YYYY-MM-DDThh:mm:ss.

Notas de versión anteriores

1.3.1 - 2026-04-07

IMPROVEMENTS

🔖 New Optional Fields in `pos_details`

El objeto pos_details ahora acepta cinco campos opcionales nuevos en todas las operaciones presenciales: charge, preAuth, capture, reverse, void y refund.

Campos nuevos:

user: Operator user of the device.

friendly_name: Display name assigned to the terminal (e.g., Caja principal).

serial: Serial number of the device.

type: Physical type of the POS device. Allowed values: COUNTERTOP, MPOS, SMARTPOS, SELF_SERVICE, OTHER.

connectivity: Network connectivity type of the device. Allowed values: GPRS, WIFI, ETHERNET, DIAL_UP, OTHER.

Estos campos son opcionales. Si los incluyes en la solicitud, se almacenan y se devuelven en la respuesta de Get transaction list v2 y en las notificaciones de webhook.

Nueva API de Chargebacks

PRODUCT IN BETA VERSION

1.3.0 - 2026-03-20NEW

Llega la Chargebacks API — un nuevo conjunto de endpoints con el que puedes consultar tu información de chargebacks directamente por API y solicitar exportaciones asíncronas. Reemplaza los procesos manuales y te da visibilidad en tiempo real del estado, los plazos y el nivel de riesgo de cada chargeback.

Novedades

🔄 Query Chargebacks

POST /data/v1/chargebacks/search — Devuelve una lista paginada de los chargebacks asociados al comercio autenticado.

Capacidades principales:

Filter by transaction_date or request_date (up to a 3-month window; only one date filter can be sent at a time).

Apply additional filters by chargeback_status, country_name, chargeback_type, and chargeback_ticket_code.

Request additional fields beyond the default response set using the fields parameter.

Paginate results with a maximum of 100 records per page.

📤 Request Chargeback Export

POST /data/v1/chargebacks/export — Inicia la generación asíncrona de un archivo de exportación de chargebacks.

Capacidades principales:

Same filters and fields as the search endpoint.

Configure up to 5 webhook URLs to receive the download notification.

Once the file is ready, Kushki sends a POST notification to each configured URL with the S3 download link.

The download URL is a pre-signed S3 URL valid for 4 hours from generation.

NEW

1.2.1 - 2025-04-02

IMPROVEMENTS

Reversos sin tarjeta 🇵🇪

We have added support for performing same-day reversals without requiring the physical card for Raw Card Present transactions.

Key details:

Reversals can be requested using the client_transaction_id.

Requests must be made the same day, before the country-specific cutoff time.

The reversal will always be for the full amount, even if a smaller amount is sent in the request.

See here an example.

1.2.0 - 2025-02-27

NEW

Presentamos la API Raw Card Present para Perú 🇵🇪

Our raw card present API is now also available for Perú.
These are some of the supported operations:

Single charge

Deferred charge

Charge with tip

Sale with cashback

Preauthorization and capture

Reauthorization

Voids and refunds

Transaction Search

Consult here all available operations.

1.1.1 - 2024-11-14

IMPROVEMENTS

Updated transaction status for voids and refunds.

1.0.4 - 2024-10-02

IMPROVEMENTS

Número de ticket añadido en las respuestas

ONE-TIME PAYMENTS - Single payments

Added ticket_number as part of the response for approved transactions (single and deferred charges).

TWO-STEP PAYMENTS - Authorization and capture

Added ticket_number as part of the response for approved transactions (preauthorizations, captures, reauthorizations).

VOIDS & REFUNDS - Voids, reverses and refunds

Added ticket_number as part of the response for approved voids, reverses, and refunds

QUERY TRANSACTIONS - Transaction Search

Added ticket_number as part of the response for the transaction search service.

1.0.3 - 2024-06-17

NEW

Presentamos la nueva estructura de documentación separada por operaciones

Now, navigate through the different operations of our API.

Each section has the details necessary to perform the operation.

1.0.2 - 2024-04-18

NEW

Presentamos el nuevo formato para los cambios en la documentación

The format has been updated for changes made to the documentation. Find the changes much easier with the types of changes separated by categories and with a different color for each one.

Now, all changes are concentrated in the release-notes file instead of having a separate file per version. You will be able to access all the changes from a single place.

The following types of changes were modified:

Added -> NEW

Changed -> IMPROVEMENTS

Fixed -> FIX

IMPROVEMENTS

Servicio de búsqueda de transacciones actualizado

The following properties were removed in the request:

pos_details

filters.card_four_digits

filters.time_zone

from

Also removed the size property in the response.

The following properties were added in the request:

page

client_transaction_id

last_four_digits

More information in the transaction search service.

1.0.1 - 2024-02-15

NEW

CARD PRESENT PAYMENTS - Transactions:

Added omit_card field for cardless operations in the request.

The metadata field was added to send additional information by the client in the request.

Cardless operations section added.

Added GL - Cardless Reauthorization, GL - Cardless Capture and GL - Cardless Void request examples.

CARD PRESENT PAYMENTS - Refund a transaction:

Added omit_card field for cardless operations in the request.

The metadata field was added to send additional information by the client in the request.

Cardless operations section added.

Added GL - Cardless Refund request example.

IMPROVEMENTS

CARD PRESENT PAYMENTS - Transactions:

Updated description for reverses

Update the description of the reauthorization, capture and void sections.

1.0.0 - 2024-01-18

NEW

Accept payment wherever you wants

Última versión#

1.4.0 - 2026-09-02#

🔖 Endpoint de alertas de fraude#

Notas de versión anteriores#

1.3.1 - 2026-04-07#

🔖 New Optional Fields in pos_details#

Nueva API de Chargebacks#

Novedades#

🔄 Query Chargebacks#

📤 Request Chargeback Export#

1.2.1 - 2025-04-02#

Reversos sin tarjeta 🇵🇪#

1.2.0 - 2025-02-27#

Presentamos la API Raw Card Present para Perú 🇵🇪#

1.1.1 - 2024-11-14#

1.0.4 - 2024-10-02#

Número de ticket añadido en las respuestas#

1.0.3 - 2024-06-17#

Presentamos la nueva estructura de documentación separada por operaciones#

1.0.2 - 2024-04-18#

Presentamos el nuevo formato para los cambios en la documentación#

Servicio de búsqueda de transacciones actualizado#

1.0.1 - 2024-02-15#

1.0.0 - 2024-01-18#

Última versión

1.4.0 - 2026-09-02

🔖 Endpoint de alertas de fraude

Notas de versión anteriores

1.3.1 - 2026-04-07

🔖 New Optional Fields in `pos_details`

Nueva API de Chargebacks

Novedades

🔄 Query Chargebacks

📤 Request Chargeback Export

1.2.1 - 2025-04-02

Reversos sin tarjeta 🇵🇪

1.2.0 - 2025-02-27

Presentamos la API Raw Card Present para Perú 🇵🇪

1.1.1 - 2024-11-14

1.0.4 - 2024-10-02

Número de ticket añadido en las respuestas

1.0.3 - 2024-06-17

Presentamos la nueva estructura de documentación separada por operaciones

1.0.2 - 2024-04-18

Presentamos el nuevo formato para los cambios en la documentación

Servicio de búsqueda de transacciones actualizado

1.0.1 - 2024-02-15

1.0.0 - 2024-01-18