Consultar liquidación

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.

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": "Mexico", "currency_code": "MXN", "merchant_id": "20000000106913436000", "merchant_name": "MI COMERCIO MÉXICO", "processor_type": "AGGREGATOR_FORMAL", "credential_alias": "Produccion Mexico", "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