The Settlement API lets you query merchant settlement records for Chile 🇨🇱 programmatically — without logging into the Kushki Console. Use it for automated reconciliation, finance reporting, and transaction-level audits.Two query modes are supported in a single endpoint:| Mode | When to use |
|---|
| By date range | Retrieve all settlement records for a billing period (startDate / endDate) |
| By ticket number | Retrieve the settlement record for a specific transaction (ticketNumber) |
ℹ️ Available for both Acquirer and Aggregator integration models.
Query by date range#
POST /merchant-settlement/v1/settlement
{
"startDate": "2026-05-01",
"endDate": "2026-05-31",
"page": 1,
"limit": 50
}
⚠️ Lookback limit: Queries are limited to a maximum lookback of 6 months from the current date. A startDate older than 6 months returns no results.
{
"data": [
{
"payment_date": "2026-05-15",
"country": "Chile",
"currency_code": "CLP",
"merchant_id": "20000000109815430000",
"merchant_name": "MI COMERCIO CHILE",
"transaction_status": "APPROVED",
"ticket_number": "821773035999295672",
"transaction_type": "SALE",
"payment_method": "CARD",
"card_brand": "MASTERCARD",
"card_type": "CREDIT",
"issuing_bank": "BANCO SANTANDER CHILE",
"approval_code": "676300",
"approved_transaction_amount": "10000",
"kushki_commission": "285",
"pay_amount": "9715"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 2,
"totalPages": 1
}
}
Query by ticket number#
POST /merchant-settlement/v1/settlement?switch=ecommerce
{
"ticketNumber": "821775714399469939"
}
data array matching the transaction.ℹ️ Include the switch=ecommerce query parameter when querying by ticket number to scope the search to online transactions.
Request fields#
| Field | Required | Description |
|---|
startDate | Date range mode | Start of the period — YYYY-MM-DD |
endDate | Date range mode | End of the period — YYYY-MM-DD |
page | Optional | Page number. Default: 1 |
limit | Optional | Records per page. Default: 100 |
ticketNumber | Ticket mode | Kushki ticket number of the transaction |
Query parameters#
| Parameter | Description |
|---|
switch | Payment channel. Use ecommerce for online transactions |
Response fields#
| Field | Description |
|---|
payment_date | Date the settlement payment was processed |
country | Country of the transaction — Chile |
currency_code | CLP |
merchant_id | Merchant identifier |
merchant_name | Merchant display name |
processor_type | Processing model — AGGREGATOR_FORMAL or ACQUIRER |
credential_alias | Alias of the credential used |
created | Date the transaction was created |
transaction_status | APPROVED, DECLINED, VOIDED, or REFUNDED |
ticket_number | Kushki ticket number |
transaction_type | SALE, VOID, REFUND, PREAUTHORIZATION, or CAPTURE |
payment_method | CARD, TRANSFER, CASH |
bin_card | Card BIN (first 6 digits) |
card_brand | Card network — VISA, MASTERCARD, etc. |
card_type | CREDIT, DEBIT, or PREPAID |
foreign_card | "TRUE" if the card was issued outside Chile, otherwise "FALSE" |
issuing_bank | Name of the card-issuing bank |
approval_code | Bank authorization code |
approved_transaction_amount | Approved amount in CLP |
subtotal_iva0 | Non-taxed subtotal |
subtotal_iva | Taxed subtotal |
iva_value | IVA amount |
kushki_commission | Kushki processing fee |
kushki_amount | Total Kushki fee including IVA |
pay_amount | Net amount disbursed to the merchant |
variable_fee | Variable fee charged |
variable_percentage | Variable fee rate applied |
adjustment | Manual adjustment amount |
fraud_retention | Amount retained for fraud risk |
| Field | Description |
|---|
page | Current page |
limit | Records per page |
total | Total matching records for the queried period |
totalPages | Total number of pages available at the current limit |
Authentication#
Using the API#
https://api.kushkipagos.com/
Available Endpoints#
Query Settlement
Retrieve settlement records by date range or by ticket number. Supports pagination.
Got a suggestion on this documentation? Contact us.
Modified at 2026-07-31 20:24:42
