Consultar liquidación

Disponibilidad

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

Obtiene los registros de liquidación del comercio a demanda. Admite dos modos de consulta:

Por rango de fechas — incluye startDate y endDate en el cuerpo de la petición para obtener una lista paginada de registros de liquidación del periodo indicado.

Por número de ticket — incluye un ticketNumber en el cuerpo de la petición 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 indicar el canal de pago. Devuelve un solo registro en el array data.

Comportamiento por defecto (modo rango de fechas)

page toma por defecto 1.

limit toma por defecto 100 registros por página.

Límite del rango de fechas

Límite de consulta de 6 meses

Las consultas están limitadas a un máximo de 6 meses hacia atrás desde la fecha actual.

Las peticiones con un startDate de más de 6 meses de antigüedad no devuelven resultados y no se lanza ningún error.

Revisa que tu startDate caiga dentro de la ventana permitida antes de enviar la petición.

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 }'

{ "data": [ { "payment_date": "2026-03-10", "day": "8", "month": "3", "country": "Peru", "currency_code": "PEN", "merchant_id": "20000000106913436000", "merchant_name": "MI COMERCIO PERÚ", "processor_type": "AGGREGATOR_FORMAL", "credential_alias": "Produccion Peru", "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