Release notes

Discover the latest feature releases, product improvements and bug fixes for Kushki Card Present Payment Services.

Stay up to date with changes and updates to the Kushki API.

We used the ISO 8601 standard (YYYY-MM-DD) for dates, the Semantic Versioning (MAJOR.MINOR.PATCH) for version numbers, increasing the:

MAJOR version when we make incompatible API changes,

MINOR version when we add functionality in a backward-compatible manner, and

PATCH version when we make backward-compatible bug fixes.

NEW for new features.

IMPROVEMENTS for changes in existing functionality.

DEPRECATED for soon-to-be removed features.

REMOVED for now removed features.

FIX for any bug fixes.

SECURITY in case of vulnerabilities.

Latest

1.4.0 - 2026-09-02

NEW

🔖 Fraud Alerts Endpoint

A new endpoint is now available to query the fraud alert records that VISA and Mastercard make available to Kushki, without waiting for a file to be delivered manually over SFTP.

The Query fraud alerts endpoint returns the records of both card network fraud reporting programs — TC40 (VISA) and SAFE (Mastercard). It covers card-present transactions processed through API Raw as well as card-not-present transactions, and it is the same endpoint documented under Online Payments.

It supports two query modes: by date range, using from and to with optional brand, country, fraud_type and merchant_id filters, or by transaction identifier, using transaction_arn or transaction_reference. Results are paginated with page and limit.

Authentication is at customer level: send your customer private credential in the Private-merchant-id header, and use the merchant_id field to scope the query to specific branches.

⚠️ Availability: this report is only available for transactions made with VISA and MASTERCARD cards, and only for Kushki's acquiring.

ℹ️ Date range limit: queries are limited to a maximum of 12 months from the current date, and from and to must use the exact format YYYY-MM-DDThh:mm:ss.

Previous release notes

1.3.1 - 2026-04-07

IMPROVEMENTS

🔖 New Optional Fields in `pos_details`

The pos_details object now accepts five new optional fields across all card present operations: charge, preAuth, capture, reverse, void, and refund.

New fields:

user: Operator user of the device.

friendly_name: Display name assigned to the terminal (e.g., Caja principal).

serial: Serial number of the device.

type: Physical type of the POS device. Allowed values: COUNTERTOP, MPOS, SMARTPOS, SELF_SERVICE, OTHER.

connectivity: Network connectivity type of the device. Allowed values: GPRS, WIFI, ETHERNET, DIAL_UP, OTHER.

These fields are optional. If included in the request, they are persisted and returned in the Get transaction list v2 response and webhook notifications.

New Chargebacks API

PRODUCT IN BETA VERSION

1.3.0 - 2026-03-20NEW

Introducing the Chargebacks API — a new set of endpoints that allows merchants to query their chargeback information directly via API and request asynchronous exports, replacing manual processes and providing real-time visibility into chargeback status, deadlines, and risk levels.

What's new

🔄 Query Chargebacks

POST /data/v1/chargebacks/search — Returns a paginated list of chargebacks associated with the authenticated merchant.

Key capabilities:

Filter by transaction_date or request_date (up to a 3-month window; only one date filter can be sent at a time).

Apply additional filters by chargeback_status, country_name, chargeback_type, and chargeback_ticket_code.

Request additional fields beyond the default response set using the fields parameter.

Paginate results with a maximum of 100 records per page.

📤 Request Chargeback Export

POST /data/v1/chargebacks/export — Initiates the asynchronous generation of a chargeback export file.

Key capabilities:

Same filters and fields as the search endpoint.

Configure up to 5 webhook URLs to receive the download notification.

Once the file is ready, Kushki sends a POST notification to each configured URL with the S3 download link.

The download URL is a pre-signed S3 URL valid for 4 hours from generation.

NEW

1.2.1 - 2025-04-02

IMPROVEMENTS

Cardless reversals 🇵🇪

We have added support for performing same-day reversals without requiring the physical card for Raw Card Present transactions.

Key details:

Reversals can be requested using the client_transaction_id.

Requests must be made the same day, before the country-specific cutoff time.

The reversal will always be for the full amount, even if a smaller amount is sent in the request.

See here an example.

1.2.0 - 2025-02-27

NEW

Presenting the raw API card present for Perú 🇵🇪

Our raw card present API is now also available for Perú.
These are some of the supported operations:

Single charge

Deferred charge

Charge with tip

Sale with cashback

Preauthorization and capture

Reauthorization

Voids and refunds

Transaction Search

Consult here all available operations.

1.1.1 - 2024-11-14

IMPROVEMENTS

Updated transaction status for voids and refunds.

1.0.4 - 2024-10-02

IMPROVEMENTS

Ticket number added in responses

ONE-TIME PAYMENTS - Single payments

Added ticket_number as part of the response for approved transactions (single and deferred charges).

TWO-STEP PAYMENTS - Authorization and capture

Added ticket_number as part of the response for approved transactions (preauthorizations, captures, reauthorizations).

VOIDS & REFUNDS - Voids, reverses and refunds

Added ticket_number as part of the response for approved voids, reverses, and refunds

QUERY TRANSACTIONS - Transaction Search

Added ticket_number as part of the response for the transaction search service.

1.0.3 - 2024-06-17

NEW

Presenting the new structure of documentation separated by operations

Now, navigate through the different operations of our API.

Each section has the details necessary to perform the operation.

1.0.2 - 2024-04-18

NEW

Presenting the new format for changes in documentation

The format has been updated for changes made to the documentation. Find the changes much easier with the types of changes separated by categories and with a different color for each one.

Now, all changes are concentrated in the release-notes file instead of having a separate file per version. You will be able to access all the changes from a single place.

The following types of changes were modified:

Added -> NEW

Changed -> IMPROVEMENTS

Fixed -> FIX

IMPROVEMENTS

Updated transaction search service

The following properties were removed in the request:

pos_details

filters.card_four_digits

filters.time_zone

from

Also removed the size property in the response.

The following properties were added in the request:

page

client_transaction_id

last_four_digits

More information in the transaction search service.

1.0.1 - 2024-02-15

NEW

CARD PRESENT PAYMENTS - Transactions:

Added omit_card field for cardless operations in the request.

The metadata field was added to send additional information by the client in the request.

Cardless operations section added.

Added GL - Cardless Reauthorization, GL - Cardless Capture and GL - Cardless Void request examples.

CARD PRESENT PAYMENTS - Refund a transaction:

Added omit_card field for cardless operations in the request.

The metadata field was added to send additional information by the client in the request.

Cardless operations section added.

Added GL - Cardless Refund request example.

IMPROVEMENTS

CARD PRESENT PAYMENTS - Transactions:

Updated description for reverses

Update the description of the reauthorization, capture and void sections.

1.0.0 - 2024-01-18

NEW

Accept payment wherever you wants

Release notes

Release notes#

Latest#

1.4.0 - 2026-09-02#

🔖 Fraud Alerts Endpoint#

Previous release notes#

1.3.1 - 2026-04-07#

🔖 New Optional Fields in pos_details#

New Chargebacks API#

What's new#

🔄 Query Chargebacks#

📤 Request Chargeback Export#

1.2.1 - 2025-04-02#

Cardless reversals 🇵🇪#

1.2.0 - 2025-02-27#

Presenting the raw API card present for Perú 🇵🇪#

1.1.1 - 2024-11-14#

1.0.4 - 2024-10-02#

Ticket number added in responses#

1.0.3 - 2024-06-17#

Presenting the new structure of documentation separated by operations#

1.0.2 - 2024-04-18#

Presenting the new format for changes in documentation#

Updated transaction search service#

1.0.1 - 2024-02-15#

1.0.0 - 2024-01-18#

Release notes

Latest

1.4.0 - 2026-09-02

🔖 Fraud Alerts Endpoint

Previous release notes

1.3.1 - 2026-04-07

🔖 New Optional Fields in `pos_details`

New Chargebacks API

What's new

🔄 Query Chargebacks

📤 Request Chargeback Export

1.2.1 - 2025-04-02

Cardless reversals 🇵🇪

1.2.0 - 2025-02-27

Presenting the raw API card present for Perú 🇵🇪

1.1.1 - 2024-11-14

1.0.4 - 2024-10-02

Ticket number added in responses

1.0.3 - 2024-06-17

Presenting the new structure of documentation separated by operations

1.0.2 - 2024-04-18

Presenting the new format for changes in documentation

Updated transaction search service

1.0.1 - 2024-02-15

1.0.0 - 2024-01-18