Consultar liquidación
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/merchant-settlement/v1/settlement
Disponibilidad
startDate y endDate en el cuerpo de la petición para obtener una lista paginada de registros de liquidación del periodo indicado.ticketNumber en el cuerpo de la petición 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 indicar el canal de pago. Devuelve un solo registro en el arreglo 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
startDate de más de 6 meses no devuelven resultados — no se lanza ningún error.startDate esté dentro de la ventana permitida antes de enviar la petición.Request
Query Params
Header Params
Body Params application/jsonRequired
Responses
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-03-10",
"day": "8",
"month": "3",
"country": "Ecuador",
"currency_code": "USD",
"merchant_id": "20000000106913436000",
"merchant_name": "MI COMERCIO ECUADOR",
"processor_type": "AGGREGATOR_FORMAL",
"credential_alias": "Produccion Ecuador",
"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": "Banco Pichincha C.A.",
"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
}
}Modified at 2026-09-11 15:03:54