The Settlement API lets you query merchant settlement records for Mexico 🇲🇽 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
}
{
"data": [
{
"payment_date": "2026-05-15",
"country": "Mexico",
"currency_code": "MXN",
"merchant_id": "20000000103802320000",
"merchant_name": "MI COMERCIO MÉXICO",
"transaction_status": "APPROVED",
"ticket_number": "319228478889680318",
"transaction_type": "SALE",
"payment_method": "CARD",
"card_brand": "MASTERCARD",
"card_type": "CREDIT",
"issuing_bank": "BANORTE",
"approval_code": "676300",
"approved_transaction_amount": "500",
"kushki_commission": "14",
"pay_amount": "486"
}
],
"total": 2,
"page": 1,
"limit": 50
}
Query by ticket number#
POST /merchant-settlement/v1/settlement?switch=ecommerce
{
"ticketNumber": "319228478889680318"
}
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 — Mexico |
currency_code | MXN |
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, etc. |
ticket_number | Kushki ticket number |
transaction_type | SALE, REFUND, VOID, etc. |
payment_method | CARD, TRANSFER, CASH |
bin_card | Card BIN (first 6 digits) |
card_brand | Card network — VISA, MASTERCARD, etc. |
card_type | CREDIT or DEBIT |
issuing_bank | Name of the card-issuing bank |
approval_code | Bank authorization code |
approved_transaction_amount | Approved amount in MXN |
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 |
total | Total matching records (pagination) |
page | Current page |
limit | Records per page |
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-11 00:04:53
