Query settlement

Availability

This functionality is available for the following models: ☑ Acquirer ☑ Aggregator

Retrieves merchant settlement records on demand. Supports two query modes:

By date range — include startDate and endDate in the request body to retrieve a paginated list of settlement records for the specified period.

By ticket number — include a ticketNumber in the request body to retrieve the settlement record associated with a specific transaction. When using this mode, include the switch query parameter to specify the payment channel. Returns a single record in the data array.

Default Behavior (Date Range Mode)

page defaults to 1.

limit defaults to 100 records per page.

Date Range Limit

6-Month Lookback Limit

Queries are limited to a maximum lookback of 6 months from the current date.

Requests with a startDate older than 6 months will not return results — no error is thrown.

Make sure your startDate falls within the allowed window before sending the request.

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-05-15", "day": "13", "month": "5", "country": "Chile", "currency_code": "CLP", "merchant_id": "20000000109815430000", "merchant_name": "MI COMERCIO CHILE", "processor_type": "AGGREGATOR_FORMAL", "credential_alias": "Produccion Chile", "created": "2026-05-13", "transaction_status": "APPROVED", "ticket_number": "821773035999295672", "sale_ticket_number": "", "payment_method": "CARD", "buy_order": "", "recap": "319228478889680318", "document_number": "12345678-9", "transaction_type": "SALE", "bin_card": "521892", "card_brand": "MASTERCARD", "card_type": "CREDIT", "foreign_card": "FALSE", "number_of_months": "0", "issuing_bank": "BANCO SANTANDER CHILE", "approval_code": "676300", "cash_pin": "", "payment_point": "", "min_fee_amount": "0.00000", "approved_transaction_amount": "10000", "subtotal_iva": "0", "subtotal_iva0": "10000", "iva_value": "0", "ice_value": "0", "variable_fee": "285", "variable_percentage": "2.85000", "static_amount": "0", "kushki_commission": "285", "iva_kushki_commission": "0", "kushki_amount": "285", "metadata": "", "fraud_retention": "0", "adjustment": "0", "wallet": "0", "fund_release": "0", "commission_msi": "0", "iva_msi": "0", "pay_amount": "9715" }, { "payment_date": "2026-05-15", "day": "13", "month": "5", "country": "Chile", "currency_code": "CLP", "merchant_id": "20000000109815430000", "merchant_name": "MI COMERCIO CHILE", "processor_type": "AGGREGATOR_FORMAL", "credential_alias": "Produccion Chile", "created": "2026-05-13", "transaction_status": "APPROVED", "ticket_number": "821775714399469940", "sale_ticket_number": "", "payment_method": "CARD", "buy_order": "", "recap": "319228478889680318", "document_number": "12345678-9", "transaction_type": "SALE", "bin_card": "521892", "card_brand": "MASTERCARD", "card_type": "CREDIT", "foreign_card": "FALSE", "number_of_months": "0", "issuing_bank": "BANCO SANTANDER CHILE", "approval_code": "676300", "cash_pin": "", "payment_point": "", "min_fee_amount": "0.00000", "approved_transaction_amount": "10000", "subtotal_iva": "0", "subtotal_iva0": "10000", "iva_value": "0", "ice_value": "0", "variable_fee": "285", "variable_percentage": "2.85000", "static_amount": "0", "kushki_commission": "285", "iva_kushki_commission": "0", "kushki_amount": "285", "metadata": "", "fraud_retention": "0", "adjustment": "0", "wallet": "0", "fund_release": "0", "commission_msi": "0", "iva_msi": "0", "pay_amount": "9715" } ], "total": 2, "page": 1, "limit": 50 }

Default Behavior (Date Range Mode)#

Date Range Limit#

Request

Responses

Default Behavior (Date Range Mode)

Date Range Limit