1. Settlement
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
        POST
    • 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. Settlement

Consultar liquidación

https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/merchant-settlement/v1/settlement
Disponibilidad
Esta funcionalidad está disponible para los siguientes modelos: ☑ Adquirencia ☑ Agregador
Obtén los registros de liquidación del comercio on demand. Admite dos modos de consulta:
Por rango de fechas — incluye startDate y endDate en el cuerpo de la solicitud para obtener una lista paginada de los registros de liquidación del periodo indicado.
Por número de ticket — incluye un ticketNumber en el cuerpo de la solicitud para obtener el registro de liquidación asociado a una transacción específica. Con este modo, incluye el parámetro de query switch para especificar el canal de pago. Devuelve un único registro en el array data.

Comportamiento por defecto (modo rango de fechas)#

page es 1 por defecto.
limit es 100 registros por página por defecto.

Límite del rango de fechas#

Límite de 6 meses hacia atrás
Las consultas están limitadas a un máximo de 6 meses hacia atrás desde la fecha actual.
Las solicitudes con un startDate de más de 6 meses de antigüedad no devuelven resultados — no se lanza ningún error.
Verifica que tu startDate esté dentro de la ventana permitida antes de enviar la solicitud.

Request

Query Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
OK
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/merchant-settlement/v1/settlement?switch=ecommerce' \
--header 'private-merchant-id;' \
--header 'Content-Type: application/json' \
--data '{
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "page": 1,
    "limit": 50
}'
Response Response Example
200 - GL - Response (date range)
{
    "data": [
        {
            "payment_date": "2026-05-15",
            "day": "13",
            "month": "5",
            "country": "Chile",
            "currency_code": "CLP",
            "merchant_id": "20000000109815430000",
            "merchant_name": "MI COMERCIO CHILE",
            "processor_type": "AGGREGATOR_FORMAL",
            "credential_alias": "Produccion Chile",
            "created": "2026-05-13",
            "transaction_status": "APPROVED",
            "ticket_number": "821773035999295672",
            "sale_ticket_number": "",
            "payment_method": "CARD",
            "buy_order": "",
            "recap": "319228478889680318",
            "document_number": "12345678-9",
            "transaction_type": "SALE",
            "bin_card": "521892",
            "card_brand": "MASTERCARD",
            "card_type": "CREDIT",
            "foreign_card": "FALSE",
            "number_of_months": "0",
            "issuing_bank": "BANCO SANTANDER CHILE",
            "approval_code": "676300",
            "cash_pin": "",
            "payment_point": "",
            "min_fee_amount": "0.00000",
            "approved_transaction_amount": "10000",
            "subtotal_iva": "0",
            "subtotal_iva0": "10000",
            "iva_value": "0",
            "ice_value": "0",
            "variable_fee": "285",
            "variable_percentage": "2.85000",
            "static_amount": "0",
            "kushki_commission": "285",
            "iva_kushki_commission": "0",
            "kushki_amount": "285",
            "metadata": "",
            "fraud_retention": "0",
            "adjustment": "0",
            "wallet": "0",
            "fund_release": "0",
            "commission_msi": "0",
            "iva_msi": "0",
            "pay_amount": "9715"
        },
        {
            "payment_date": "2026-05-15",
            "day": "13",
            "month": "5",
            "country": "Chile",
            "currency_code": "CLP",
            "merchant_id": "20000000109815430000",
            "merchant_name": "MI COMERCIO CHILE",
            "processor_type": "AGGREGATOR_FORMAL",
            "credential_alias": "Produccion Chile",
            "created": "2026-05-13",
            "transaction_status": "APPROVED",
            "ticket_number": "821775714399469940",
            "sale_ticket_number": "",
            "payment_method": "CARD",
            "buy_order": "",
            "recap": "319228478889680318",
            "document_number": "12345678-9",
            "transaction_type": "SALE",
            "bin_card": "521892",
            "card_brand": "MASTERCARD",
            "card_type": "CREDIT",
            "foreign_card": "FALSE",
            "number_of_months": "0",
            "issuing_bank": "BANCO SANTANDER CHILE",
            "approval_code": "676300",
            "cash_pin": "",
            "payment_point": "",
            "min_fee_amount": "0.00000",
            "approved_transaction_amount": "10000",
            "subtotal_iva": "0",
            "subtotal_iva0": "10000",
            "iva_value": "0",
            "ice_value": "0",
            "variable_fee": "285",
            "variable_percentage": "2.85000",
            "static_amount": "0",
            "kushki_commission": "285",
            "iva_kushki_commission": "0",
            "kushki_amount": "285",
            "metadata": "",
            "fraud_retention": "0",
            "adjustment": "0",
            "wallet": "0",
            "fund_release": "0",
            "commission_msi": "0",
            "iva_msi": "0",
            "pay_amount": "9715"
        }
    ],
    "total": 2,
    "page": 1,
    "limit": 50
}
Modified at 2026-09-11 15:11:25
Previous
Settlement
Next
Fraud Report
Built with