1. API Raw Card Present
Español
  • English
  • Español
  • Docs de API 🇲🇽
  • Online Payments
    • Errores ISO
    • Errores del API de Kushki
    • Notas de versión
    • Card Payments
      • Solicitar un token de tarjeta
      • Hacer un cargo o cargo diferido
      • Crear pago (sin token)
      • Solicitar opciones de diferido
      • Reembolsar una transacción
      • Autorizar pagos
      • Preautorización (sin token)
      • Anular una transacción
      • Reautorizar pagos
      • Capturar un pago autorizado
      • Información de BIN V2
      • Información de BIN
      • Validar OTP
    • One-Click and Scheduled Payments
      • Solicitar un token de cargo recurrente
      • Crear un cargo recurrente
      • Hacer un pago One-click
      • Actualizar los datos de la tarjeta del cargo recurrente
      • Cancelar un cargo recurrente
      • Actualizar un cargo recurrente
      • Agregar un cargo o descuento temporal
      • Autorizar pagos
      • Capturar un pago autorizado
      • Consultar información del cargo recurrente
    • Transfer in
      • Consultar lista de bancos
      • Solicitar un token de Transfer In
      • Iniciar transacción
      • Consultar estado
    • Transfer Out
      • Consultar lista de bancos
      • Consultar lista de bancos V2
      • Solicitar un token de Transfer Out
      • Iniciar transacción
      • Consultar estado
      • Saldo para payouts
    • Smartlinks
      • Crear un Smartlink
      • Consultar un Smartlink
      • Eliminar un Smartlink
      • Actualizar un Smartlink
    • Payment Button
      • Crear un Payment Button
    • Analytics
      • Consultar listado de transacciones v2
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Commissions
      • Consultar configuración de comisiones
    • Payment Credentials
      • Crear una credencial
      • Activar o desactivar
      • Eliminar credencial
      • Regenerar una credencial
      • Actualizar credencial
      • Búsqueda avanzada
      • Buscar credenciales
    • Platform Status
      • Consultar estado de la plataforma
      • Consultar estado del gateway
    • Settlement
      • Consultar liquidación
    • Subscription Transactions
      • Consultar transacciones de suscripción
    • Fraud Report
      • Consultar alertas de fraude
  • Card Present Billpocket
    • Notas de versión
    • Notas de versión del SDK de Android
    • Notas de versión de la app de Android
    • Notas de versión de la app de iOS
    • Get Started
      • Crear una cuenta
      • User Token
      • API Keys
    • Webhooks
      • Webhooks — Transferencia de fondos a tu cuenta bancaria
      • Errores de transferencia de fondos
    • Terminals
      • App Review
      • Splash Screen
    • Card not Present Billpocket Services
      • 3DS Checkout
        • Crear checkout
        • Consultar detalles del checkout
      • E-commerce Flex
        • Obtener token
        • Validar token
        • Cobrar pagos
        • Reembolso
        • Capturar un pago autorizado
        • Consultar estado
    • Catalogs
      • Estados
      • Municipios
      • Empresas de impuestos
      • Actividades comerciales
    • Accounts
      • Clabe Account Setup
        • Agregar cuenta CLABE
      • Deposit Accounts
        • Agregar o actualizar cuenta CLABE
    • User Settings
      • Crear usuario
    • Card Present Payment Services
      • Cloud Terminal API
        • Cobrar pagos con tarjeta
        • Imprimir ticket
        • Cancelar notificación push
        • Consultar estado de la transacción
        • Cobrar pagos con tarjeta v2
      • App-to-App
        • Android intents
        • App to App — iOS
        • App to App — Mobile Web
      • Terminal SDK
        • Terminal SDK Android
        • Errores del SDK de Android
    • Transactions
      • Transaction List
        • Obtener token
        • Consultar listado de transacciones
        • Consultar listado de transacciones v2
        • Consultar listado de transacciones v3
        • Consultar listado de transacciones v4
      • Cancel Payments
        • Códigos de error de cancelación
        • Cancelar pagos
  • API Raw Card Present
    • El objeto Amount
    • Catálogo de errores
    • Proceso de intercambio de llaves
    • Notas de versión
    • Datos de prueba
    • One-time payments
      • Pago único
    • Two-step-payments
      • Autorización y captura
    • Voids & Refunds
      • Reembolsar una transacción
      • Anular y reversar
    • Card information
      • Consultar información de BIN
      • Información de BIN V2
      • Solicitar opciones de diferido
    • Query Transactions
      • Búsqueda de transacciones
    • Webhooks
      • Webhooks — Pagos con tarjeta
      • Webhooks — Reembolsos
      • Webhooks — Introducción
      • Buenas prácticas
      • Revisa tus webhooks
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Fraud Report
      • Consultar alertas de fraude
  • Kushki One
    • Error Catalog
    • Release notes
    • Transaction Examples
    • Webhooks
    • Cloud Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
        • Search
          • Transaction Search
      • Print
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
          • Abort (Async)
        • Search
          • Transaction Search — Online
          • Transaction Search — Local
      • Print
        • Create Print Job
        • Get Print Job Status
        • Print Job Webhook (inbound — implemented by your POS)
  • Appian - Submerchant Register
    • Release Notes
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Submerchant Document Upload
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • RequestBodies
      • one-and-two-step-payment
    • Card
    • Channel
    • Amount-cash-in
    • ChargebackListResponse
    • TransactionResponse
    • PrintJobRequest
    • one-and-two-step-payment-2
    • Card Present (CP)
    • one-and-two-step-payment-2
    • SubscriptionTransactionsResponse
    • FraudAlertRequest
    • StatusComponent
    • SettlementDateRangeRequest
    • amount
    • ChargebackItem
    • SubscriptionTransaction
    • extra_taxes
    • RawResponse
    • CommandText
    • Card Not Present (CNP)
    • Deferred
    • networkToken
    • FraudAlertResponse
    • ErrorResponse400
    • SettlementRecord
    • card
    • CardData
    • CommandColumns
    • FraudAlertRecord
    • SettlementResponse
    • currency
    • webhooksItem
    • ErrorResponse
    • Country
    • ErrorResponse401
    • LinkFailure
    • ColumnItem
    • ValidationError
    • Amount
    • card_details
    • ErrorResponse403
    • enc_tlv
    • CommandDivider
    • TransactionEvent
    • extraTaxes
    • payment_method
    • ErrorResponse500
    • CommandFeed
    • TransactionStatus
    • deferred
    • CommandSpace
    • ReadingType
    • pos_details
    • ContactDetails
    • sub_merchant
    • CommandCut
    • FailureReason
    • contact_details
    • Subscription
    • metadata
    • CommandImage
    • EventTerminal
    • documentType
    • orderDetails
    • Language
    • TransactionSearchRequest
    • CommandQR
    • EventOperation
    • Shipping Address
    • payment_submethod
    • CommandBarcode
    • EventAmount
    • Billing-Address
    • SubscriptionUpdate
    • EventExtraTaxes
    • PrintJobAccepted
    • PrinterError
    • EventMetadata
    • SubscriptionAdjustmentRequest
    • product
    • AmountWithTaxes
    • PrintJobStatus
    • PrintJobStatusRequest
    • threeDomainSecure
    • AmountCore
    • webhooks
    • headers
    • ExtraTaxes
    • PrintWebhookPayload
    • webhooksChargeback
    • Metadata
    • AmountWithTip
    • citMit
    • TransactionSearchBody
    • TransactionSearchOnlineBody
    • network
    • binInfo
    • AmountWithOptionalTip
    • TransactionSearchLocalBody
    • TransactionEvent_2
    • messageFields
    • UnexpectedErrorResponse
    • FailureReason_2
    • transactionType
    • ExternalReferenceId
    • EventTerminal_2
    • ExternalSubscriptionId
    • EventOperation_2
    • EventAmount_2
    • EventExtraTaxes_2
    • EventMetadata_2
    • SettlementTicketRequest
HomePerú 🇵🇪México 🇲🇽
Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽
Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
  1. API Raw Card Present

Notas de versión


Descubre los últimos lanzamientos de funcionalidades, las mejoras de producto y las correcciones de errores de Kushki Card Present — México 🇲🇽.


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.
Mantente al día de los cambios y actualizaciones de la API Card Present de Kushki para México.
Usamos ISO 8601 (YYYY-MM-DD) para las fechas y versionado semántico (MAJOR.MINOR.PATCH):
1.
MAJOR — cambios incompatibles en la API
2.
MINOR — funcionalidad nueva retrocompatible
3.
PATCH — correcciones de errores retrocompatibles
NEW — funcionalidades nuevas
IMPROVEMENTS — cambios en funcionalidad existente
DEPRECATED — funcionalidades que se eliminarán pronto
REMOVED — funcionalidades eliminadas
FIX — correcciones de errores
SECURITY — vulnerabilidades de seguridad

Ú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.
⛔ Transacciones domésticas: this report is not available for domestic transactions processed through PROSA.
ℹ️ 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.0 — 2026-03-20#

NEW

⚖️ API de Chargebacks#

Llega la Chargebacks API — consulta la información de chargebacks directamente por API y solicita exportaciones asíncronas.
Endpoints nuevos:
POST /data/v1/chargebacks/search — Lista paginada de chargebacks con filtros por fecha, estado y tipo.
POST /data/v1/chargebacks/export — Inicia una exportación asíncrona; cuando esté lista, Kushki envía por POST el enlace de descarga a la URL de tu webhook.

1.2.1 — 2025-04-02#

IMPROVEMENTS

Reversos sin tarjeta 🇲🇽 (Beta)#

Added support for performing same-day reversals without requiring the physical card.
Use client_transaction_id from the original transaction.
Must be requested on the same day, before 22:00 México local time.
Reversal is always for the full transaction amount.

1.2.0 — 2025-02-27#

NEW

🇲🇽 MSI (Meses Sin Intereses) — Card Present#

Beta
MSI for Card Present is currently in Beta phase for Mexico. Contact the Kushki team to enable this feature.
Merchants can now offer Meses Sin Intereses (MSI) installments by sending credit_type: "03" and graceMonths: "00" in the deferred object.
"deferred": {
  "months": "6",
  "credit_type": "03",
  "graceMonths": "00"
}
También en esta versión:
Added GET /deferred/v2/bin/{bin} — returns MSI type "03" in the response for eligible BINs.
Cardless operations in Beta for México: omit_card: true supported for captures, reauthorizations, voids, and refunds.

1.1.1 — 2024-11-14#

IMPROVEMENTS
Updated transaction status for voids and refunds.

1.0.4 — 2024-10-02#

IMPROVEMENTS

ticket_number añadido en las respuestas#

ticket_number is now included in all approved transaction responses:
Single payments — charges and MSI deferred charges
Two-step payments — preauthorizations, captures, reauthorizations
Voids & Refunds — voids, reverses, and refunds
Query Transactions — transaction search results

1.0.1 — 2024-02-15#

NEW

Operaciones sin tarjeta (Beta)#

Added omit_card field for card-free operations across all endpoints.
Added metadata field to attach additional information to any request.
New request examples: GL - Cardless Reauthorization, GL - Cardless Capture, GL - Cardless Void, GL - Cardless Refund.
IMPROVEMENTS
Updated descriptions for reversal, reauthorization, capture, and void sections.

1.0.0 — 2024-01-18#

NEW

🇲🇽 API Card Present para México — Disponibilidad general#

Launching the Card Present raw API for Mexico with the following supported operations:
Single charge (ICC, MCR, NFC)
MSI deferred charge — Meses Sin Intereses
Charge with tip
Pre-authorization and capture
Reauthorization
Voids and refunds
BIN lookup and MSI deferred options
Transaction search

Got a suggestion on this documentation? Contact us.
Modified at 2026-09-11 15:43:26
Previous
Proceso de intercambio de llaves
Next
Datos de prueba
Built with