1. API Raw Card Present Payments 🇨🇱
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)
      • Anular una transacción
      • Reembolsar una transacción
      • Solicitar opciones de diferido
      • Autorizar pagos
      • Preautorización (sin token)
      • Reautorizar pagos
      • Capturar un pago autorizado
      • Verificar cuenta
      • Validar OTP
      • Información de BIN V2
      • Información de BIN
      • Voucher
    • One-Click & Scheduled Payments
      • Solicitar un token de cargo recurrente
      • Crear un cargo recurrente
      • Actualizar los datos de la tarjeta del cargo recurrente
      • Hacer un pago One-click
      • 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
    • Card Async
      • Solicitar un token de Card Async
      • Iniciar transacción
      • Autorizar pagos
      • Capturar un pago autorizado
      • Consultar estado
    • Async Card Recurring Charges
      • Solicitar un token de cargo recurrente con tarjeta asíncrono
      • Iniciar un cargo recurrente con tarjeta asíncrono
      • Autorizar pagos
      • Capturar un pago autorizado
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • 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
    • Cash In
      • Solicitar un token de Cash In
      • Iniciar transacción
      • Estado de la transacción
    • Smartlinks V2
      • Crear un Smartlink
      • Consultar un Smartlink
      • Eliminar un Smartlink
      • Actualizar un Smartlink
    • Payment Button
      • Crear un Payment Button
    • Analytics
      • Consultar listado de transacciones v2
    • Status
      • Consultar estado de la plataforma
      • Consultar estado del gateway
    • Subscription Transactions
      • Consultar transacciones de suscripción
    • Payment Credentials
      • Crear una credencial
      • Buscar credenciales
      • Actualizar credencial
      • Regenerar una credencial
      • Eliminar credencial
      • Activar o desactivar
      • Búsqueda avanzada
    • Settlement
      • Consultar liquidación
    • Fraud Report
      • Consultar alertas de fraude
  • API Raw Card Present Payments 🇨🇱
    • Notas de versión
    • Catálogo de errores
    • Datos de prueba
    • Proceso de intercambio de llaves
    • El objeto Amount
    • 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
    • Chargebacks
      • Consultar chargebacks
      • Solicitar exportación de chargebacks
    • Webhooks
      • Introducción
      • Buenas prácticas
      • Reembolsos
      • Pagos con tarjeta
      • Revisa tus webhooks
    • 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
        • Search
          • Transaction Search
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
      • Print
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Search
          • Transaction Search — Online
          • Transaction Search — Local
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
          • Abort (Async)
      • 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
    • documentType
    • ChargebackListResponse
    • Channel
    • TransactionResponse
    • PrintJobRequest
    • one-and-two-step-payment-1
    • one-and-two-step-payment-1
    • Card Present (CP)
    • Card
    • Amount-cash-in
    • SubscriptionTransactionsResponse
    • SettlementDateRangeRequest
    • StatusComponent
    • FraudAlertRequest
    • amount
    • extra_taxes
    • ChargebackItem
    • SubscriptionTransaction
    • RawResponse
    • CommandText
    • Card Not Present (CNP)
    • one-and-two-step-payment-11
    • networkToken
    • FraudAlertResponse
    • card
    • ErrorResponse400
    • CardData
    • CommandColumns
    • FraudAlertRecord
    • Amount-CL
    • webhooks
    • SettlementResponse
    • webhooksItem
    • headers
    • ErrorResponse401
    • SettlementRecord
    • LinkFailure
    • ColumnItem
    • Amount
    • currency
    • ValidationError
    • card_details
    • transactionType
    • enc_tlv
    • ErrorResponse403
    • CommandDivider
    • TransactionEvent
    • ErrorResponse
    • Country
    • binInfo
    • ErrorResponse500
    • payment_method
    • CommandFeed
    • TransactionStatus
    • extraTaxes
    • Deferred
    • deferred
    • CommandSpace
    • ReadingType
    • SubscriptionUpdate
    • pos_details
    • ContactDetails
    • Language
    • sub_merchant
    • CommandCut
    • FailureReason
    • contact_details
    • metadata
    • CommandImage
    • EventTerminal
    • Subscription
    • orderDetails
    • TransactionSearchRequest
    • CommandQR
    • EventOperation
    • Shipping Address
    • payment_submethod
    • CommandBarcode
    • EventAmount
    • Billing-Address
    • EventExtraTaxes
    • PrintJobAccepted
    • PrinterError
    • EventMetadata
    • AmountWithTaxes
    • PrintJobStatus
    • PrintJobStatusRequest
    • threeDomainSecure
    • SubscriptionAdjustmentRequest
    • AmountCore
    • webhooksChargeback
    • ExtraTaxes
    • PrintWebhookPayload
    • Metadata
    • AmountWithTip
    • citMit
    • TransactionSearchBody
    • TransactionSearchOnlineBody
    • network
    • AmountWithOptionalTip
    • TransactionSearchLocalBody
    • TransactionEvent_2
    • messageFields
    • UnexpectedErrorResponse
    • FailureReason_2
    • EventTerminal_2
    • ExternalReferenceId
    • EventOperation_2
    • ExternalSubscriptionId
    • EventAmount_2
    • EventExtraTaxes_2
    • EventMetadata_2
    • product
    • SettlementTicketRequest
    • TransactionEvent_21
    • TransactionStatus2
    • ReadingType3
    • FailureReason_24
    • EventTerminal_25
    • EventOperation_26
    • EventAmount_27
    • EventMetadata_28
    • EventExtraTaxes_29
    • PrintWebhookPayload10
    • TransactionEvent11
    • FailureReason12
    • EventTerminal13
    • EventOperation14
    • EventAmount15
    • EventMetadata16
    • EventExtraTaxes17
    • TransactionEvent_22
    • TransactionStatus3
    • ReadingType4
    • FailureReason_25
    • EventTerminal_26
    • EventOperation_27
    • EventAmount_28
    • EventMetadata_29
    • EventExtraTaxes_210
    • PrintWebhookPayload11
    • TransactionEvent12
    • FailureReason13
    • EventTerminal14
    • EventOperation15
    • EventAmount16
    • EventMetadata17
    • EventExtraTaxes18
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
  1. API Raw Card Present Payments 🇨🇱

Notas de versión


Descubre los últimos lanzamientos de funcionalidades, las mejoras de producto y las correcciones de errores de Kushki Card Present — Chile 🇨🇱.


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 Chile.
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.
ℹ️ 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

🔖 Nuevos campos opcionales en 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:
CampoDescripción
userOperator user of the device.
friendly_nameDisplay name assigned to the terminal (e.g., "Caja principal").
serialSerial number of the device.
typePhysical type of the POS device. Allowed values: COUNTERTOP, MPOS, SMARTPOS, SELF_SERVICE, OTHER.
connectivityNetwork connectivity type. Allowed values: GPRS, WIFI, ETHERNET, DIAL_UP, OTHER.
Estos campos son opcionales. Si los incluyes, se almacenan y se devuelven en las respuestas de listado de transacciones y en las notificaciones de webhook.

1.2.1 — 2025-04-02#

IMPROVEMENTS

Reversos sin tarjeta 🇨🇱#

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 23:59 Chile local time.
Reversal is always for the full transaction amount.

1.2.0 — 2025-02-27#

NEW

🇨🇱 Cuotas Comercio (Merchant Installments) — Beta#

Beta
Cuotas Comercio is currently in Beta phase for Chile. Contact the Kushki team to enable this feature.
Merchants can now offer Cuotas Comercio (Merchant Installments) — 2 to 12 months — by sending credit_type: "03" in the deferred object. The merchant absorbs the installment cost.
"deferred": {
  "months": "6",
  "credit_type": "03"
}
También en esta versión:
Added GET /deferred/v2/bin/{bin} — returns installment type "03" (Cuotas Comercio) in the response for eligible BINs.
Cardless operations fully available for Chile: 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 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#

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 Chile — Disponibilidad general#

Launching the Card Present raw API for Chile with the following supported operations:
Single charge (ICC, MCR, NFC)
Deferred charge — Cuotas Emisor (Issuer Installments)
Charge with tip
Charge with cashback
Pre-authorization and capture
Reauthorization
Voids and refunds
BIN lookup and deferred options
Transaction search

Got a suggestion on this documentation? Contact us.
Modified at 2026-09-11 15:44:11
Previous
API Raw Card Present Payments 🇨🇱
Next
Catálogo de errores
Built with