Consultar liquidación

Disponibilidad

Esta funcionalidad está disponible para los siguientes modelos: ☑ Acquirer ☑ Aggregator

Obtiene los registros de liquidación de tu comercio bajo demanda. 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. En este modo, incluye el parámetro de consulta switch para especificar el canal de pago. Devuelve un único registro en el array data.

Comportamiento por defecto (modo rango de fechas)

page por defecto es 1.

limit por defecto es 100 registros por página.

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 anterior a 6 meses no devuelven resultados y no se lanza ningún error.

Asegúrate de que tu startDate esté dentro de la ventana permitida antes de enviar la solicitud.

curl --location 'https://api-uat.kushkipagos.com/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 }'

{ "data": [ { "payment_date": "2026-03-10", "day": "8", "month": "3", "country": "Colombia", "currency_code": "COP", "merchant_id": "20000000106913436000", "merchant_name": "MI COMERCIO COLOMBIA", "processor_type": "AGGREGATOR_FORMAL", "credential_alias": "Produccion Colombia", "created": "2026-03-08", "transaction_status": "APPROVED", "ticket_number": "821773035999295672", "sale_ticket_number": "", "payment_method": "CARD", "buy_order": "", "recap": "606723104367", "document_number": "", "transaction_type": "SALE", "bin_card": "418914", "card_brand": "VISA", "card_type": "DEBIT", "foreign_card": "FALSE", "number_of_months": "0", "issuing_bank": "BANORTE", "approval_code": "000314", "cash_pin": "", "payment_point": "", "min_fee_amount": "0.00000", "approved_transaction_amount": "105.67", "subtotal_iva": "0.0", "subtotal_iva0": "105.67", "iva_value": "0.0", "ice_value": "0.0", "variable_fee": "2.700", "variable_percentage": "2.85309", "static_amount": "0.00", "kushki_commission": "2.85", "iva_kushki_commission": "0.46", "kushki_amount": "3.31", "metadata": "", "fraud_retention": "0.00", "adjustment": "0.00", "wallet": "0.00", "fund_release": "0.00", "commission_msi": "0.00", "iva_msi": "0.00", "pay_amount": "102.36", "observation": "" } ], "pagination": { "page": 1, "limit": 10, "total": 101335, "totalPages": 10134 } }

Comportamiento por defecto (modo rango de fechas)

Límite del rango de fechas

Request

Responses

Consultar liquidación

Comportamiento por defecto (modo rango de fechas)#

Límite del rango de fechas#

Request

Responses

Comportamiento por defecto (modo rango de fechas)

Límite del rango de fechas