Settlement - Kushki Developer Portal

El endpoint de liquidación te da acceso programático a tus registros de liquidación. Úsalo para conciliar transacciones, verificar el cálculo de comisiones y armar reportes de pagos.

Hay dos modos de consulta disponibles en un solo endpoint:

Rango de fechas: obtén una lista paginada de todos los registros de liquidación dentro de una ventana de tiempo.

Número de ticket: obtén el registro de liquidación de una transacción específica.

Consulta por rango de fechas

Incluye startDate y endDate en el cuerpo de la petición. Devuelve una lista paginada.

{
  "startDate": "2026-04-01",
  "endDate": "2026-04-30",
  "page": 1,
  "limit": 100
}

Campo	Obligatorio	Descripción
`startDate`	Sí	Inicio del periodo de liquidación (`YYYY-MM-DD`).
`endDate`	Sí	Fin del periodo de liquidación (`YYYY-MM-DD`).
`page`	No	Número de página. Por defecto: `1`.
`limit`	No	Registros por página. Por defecto: `100`.

Consulta por número de ticket

Incluye un ticketNumber para obtener el registro de liquidación de una transacción específica. Envía también el parámetro de query switch para indicar el canal de pago.

{
  "ticketNumber": "821773035999295672"
}

Campo	Obligatorio	Descripción
`ticketNumber`	Sí	Número de ticket de la transacción que quieres consultar.

Estructura de la respuesta

Ambos modos devuelven un array data con los registros de liquidación y un objeto pagination.

{
  "data": [
    {
      "payment_date": "2026-04-10",
      "country": "Peru",
      "currency_code": "PEN",
      "merchant_name": "Mi Comercio Perú",
      "transaction_status": "APPROVED",
      "transaction_type": "SALE",
      "approved_transaction_amount": "250.00",
      "kushki_commission": "7.13",
      "iva_kushki_commission": "1.14",
      "kushki_amount": "8.27",
      "pay_amount": "241.73"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 435,
    "totalPages": 5
  }
}

Campos del registro de liquidación

Identificación de la transacción

Campo	Descripción
`ticket_number`	Número de ticket único que asigna Kushki.
`sale_ticket_number`	Ticket de la venta original (para anulaciones/reembolsos).
`approval_code`	Código de autorización del emisor.
`buy_order`	Referencia de orden que entrega el comercio.
`recap`	Código de conciliación.

Detalles de la transacción

Campo	Descripción
`payment_date`	Fecha en la que se pagó la liquidación al comercio (`YYYY-MM-DD`).
`created`	Fecha de creación de la transacción (`YYYY-MM-DD`).
`transaction_status`	`APPROVED`, `DECLINED`, `VOIDED` o `REFUNDED`.
`transaction_type`	`SALE`, `VOID`, `REFUND`, `PREAUTHORIZATION` o `CAPTURE`.
`payment_method`	Método de pago usado (por ejemplo, `CARD`, `CASH`, `TRANSFER`).
`currency_code`	Moneda de la transacción (`PEN` o `USD`).
`country`	País en el que se procesó la transacción.

Detalles de la tarjeta

Campo	Descripción
`bin_card`	Primeros 6 dígitos de la tarjeta (BIN).
`card_brand`	Red de la tarjeta (por ejemplo, `VISA`, `MASTERCARD`).
`card_type`	`CREDIT`, `DEBIT` o `PREPAID`.
`foreign_card`	`TRUE` si la tarjeta se emitió fuera de Perú.
`issuing_bank`	Nombre del banco emisor de la tarjeta.
`number_of_months`	Meses de diferido (`"0"` si no hay diferido).

Montos y comisiones

Campo	Descripción
`approved_transaction_amount`	Monto total cobrado al cliente.
`subtotal_iva`	Subtotal afecto a IGV.
`subtotal_iva0`	Subtotal no afecto a IGV.
`iva_value`	Monto de IGV.
`ice_value`	Monto del impuesto ICE.
`variable_fee`	Monto de la comisión variable que cobra Kushki.
`variable_percentage`	Tasa de la comisión variable (%).
`static_amount`	Comisión fija por transacción.
`kushki_commission`	Comisión total de Kushki.
`iva_kushki_commission`	IGV de la comisión de Kushki.
`kushki_amount`	Total retenido por Kushki (comisión + IGV).
`pay_amount`	Monto neto pagado al comercio después de todas las deducciones.
`fraud_retention`	Monto retenido por prevención de fraude.
`adjustment`	Ajuste manual aplicado al registro.
`fund_release`	Monto liberado de un fondo retenido previamente.

Otros

Campo	Descripción
`processor_type`	Modelo de procesamiento (`AGGREGATOR_FORMAL`, etc.).
`credential_alias`	Alias de la credencial usada en la transacción.
`merchant_id`	Identificador del comercio.
`merchant_name`	Nombre visible del comercio.
`document_number`	Número de documento asociado a la transacción.
`cash_pin`	PIN de efectivo, si aplica.
`payment_point`	Identificador del punto de pago para transacciones en efectivo.
`metadata`	Metadatos adicionales adjuntos a la transacción.
`observation`	Notas asociadas al registro de liquidación.

Autenticación

Uso de la API

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Consultar registros de liquidación

Obtén registros de liquidación por rango de fechas o por un número de ticket específico. Devuelve montos de la transacción, comisiones, comisiones de Kushki y el monto neto a pagar.

¿Tienes una sugerencia sobre esta documentación? Escríbenos.

Liquidación

Consulta por rango de fechas#

Consulta por número de ticket#

Estructura de la respuesta#

Campos del registro de liquidación#

Autenticación#

Uso de la API#