Notas de versión

Tipos de cambios#

Última versión#

1.19.0 - 2026-09-02#

🔖 Endpoint de alertas de fraude#

⚠️ 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.18.3 - 2026-06-04#

fullResponse v3 — Crear un cargo recurrente#

⚠️ Estabilidad de la respuesta V3: la respuesta v3 puede incluir campos nuevos o deprecados sin aviso previo. Maneja siempre con tolerancia los campos inesperados o ausentes.

1.18.2 - 2026-05-12#

🇨🇴 Dispersiones por transferencia con Bre-B — Colombia (Beta)#

⚠️ Acceso Beta: Available only for Colombia merchants with the Bre-B processor configured on their MID. To request access, contact your account executive. Sending Bre-B key types without the processor configured returns HTTP 400.

1.18.0 - 2026-04-17#

🔖 Endpoint de estado de la plataforma#

🔖 Endpoint de transacciones de suscripción#

🔖 Endpoint de consulta de liquidación#

1.17.2 - 2026-04-07#

🔖 Nuevos campos del dispositivo POS en Get Transaction List V2#

Estos campos solo se devuelven en transacciones presenciales si se enviaron en la petición original.

1.17.1 - 2026-03-31#

🔖 Identificador de transacción (TID) en la API de pagos#

network.transactionIdentifier solo está presente en la respuesta cuando franchiseTransactionCode se incluyó en el array capabilities de la petición.

1.17.0 - 2026-03-20#

Novedades#

🔄 Query Chargebacks#

📤 Request Chargeback Export#

1.16.8 - 2026-01-21#

Actualizaciones#

💳 Card Charge V2 / Tokenless Charge / Pre-authorization V2 / Tokenless Pre-authorization#

💳 Preautorización para COF#

1.16.7 - 2025-12-12#

Actualizaciones#

🧾 💳 Card token requests / Tokenless charge / Pre-authorization without token / Token for subscriptions endpoints#

1.16.5 - 2025-10-27#

1.16.1 - 2025-09-01#

Idempotencia ya disponible en Online Payments#

Dónde funciona#

1.15.8 - 2025-06-18#

Cambios en el endpoint get transaction list V2#

1.15.6 - 2025-04-16#

Nueva opción de autenticación 3DS 100 % API#

1.15.4 - 2025-02-05#

Nueva versión: Get Transactions List v2 🚀#

Novedades#

1.15.3 - 2025-02-07#

El external reference ID ya se admite en pagos con tarjeta y anulaciones#

El objeto metadata ya se admite en anulaciones y reembolsos.#

1.15.2 - 2024-11-14#

1.15.1 - 2024-08-28#

Transfiya ya está disponible en Colombia para Transfer Out (fase Beta)#

1.15.0 - 2024-05-02#

Operaciones sin token#

Códigos CIT, MIT y MAC para Kushki Acquirer#

Nuevo parámetro añadido: Transaction ARN#

1.14.1 - 2024-02-29#

Nueva categoría ERRORS#

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

specificationVersion actualizado para los motores de autenticación 3D Secure externos#

Important notice about support for version 1 of 3D Secure!#

NOTE: 3DS version 1 will no longer be supported after October 2022. Merchants will need to migrate to version 2 of the protocol to avoid any impact on their transactions.

Important notice about support for version 1 of 3D Secure!#

NOTE: Support for 3D Secure 1.0.2 and related technology ended in October 2022. Merchants will need to migrate to version 2 of the protocol to avoid any impact on their transactions.

{
  "title": "threeDomainSecure",
  "type": "object",
  "properties": {
    "specificationVersion": {
      "description": "3DS protocol version to implement\n\n**NOTE: 3DS version 1 will no longer be supported after October 2022. Merchants will need to migrate to version 2 of the protocol to avoid any impact on their transactions.**",
      "type": "string",
      "enum": [
                "1.0.2",
                "2.0.0"
            ],
            "minLength": 5,
            "maxLength": 5,
            "pattern": "[1-2].[0-9].[0-9]"
    }
  },
  "required": [ "specificationVersion"]
}

{
  "title": "threeDomainSecure",
  "type": "object",
  "properties": {
    "specificationVersion": {
      "description": "3DS protocol version to implement\n\n**NOTE: Support for 3D Secure 1.0.2 and related technology ended in October 2022. Merchants will need to migrate to version 2 of the protocol to avoid any impact on their transactions.**",
      "type": "string",
      "enum": [
                "2.0.0",
                "2.2.0"
            ],
            "minLength": 5,
            "maxLength": 5,
            "pattern": "[1-2].[0-9].[0-9]"
    }
  },
  "required": [ "specificationVersion"]
}

El menú lateral se reorganizó por categorías para navegar mejor#

🖼️ Migración de recursos pendiente: this section originally embedded 3 screenshots (Kushki-api-reference-category.png, schemas-category.png, errors-category.png) via relative Stoplight paths (../../assets/images/...), which don't resolve in Apidog. Re-upload these images to Apidog's asset library and re-embed them with the resulting URLs.

1.14.0 - 2024-01-29#