1. Card Present Payments (API Raw)
  • API Docs Peru 🇵🇪
  • Online Payments
    • Release Notes
    • Card Payments
      • Request a card token
      • Make a charge or deferred charge
      • Preauthorization (tokenless)
      • Create payment (tokenless)
      • Void a transaction
      • Refund a transaction
      • Verify Account
      • Request deferred options
      • Authorize payments
      • Reauthorize payments
      • Capture an authorized payment
      • Validate OTP
      • Bin Info V2
      • Bin Info
    • One-Click & Scheduled Payments
      • Request a recurring charge token
      • Create a recurring charge
      • Update recurring charge card data
      • Make an One-click payment
      • Cancel a recurring charge
      • Update a recurring charge
      • Add a temporary charge or discount
      • Authorize payments
      • Capture an authorized payment
      • Get recurring charge Info
    • Card Out
      • Get Card Payout Token
      • Get Subscription Token
      • Push funds
      • Push Funds in subscriptions
      • Get transaction status
      • Delete Subscription
    • Transfer In
      • Get Bank List
      • Request a Transfer In token
      • Init Transaction
      • Get Status
    • Transfer Out
      • Get Bank List
      • Get Bank List V2
      • Request a Transfer Out token
      • Init Transaction
      • Get Status
      • Balance for Payouts
    • Cash In
      • Request a cash in token
      • Init Transaction
      • Transaction Status
    • Smartlinks V2
      • Create a Smartlink
      • Update a Smartlink
      • Get a Smartlink
      • Delete a smartlink
    • Analytics
      • Get transactions list v1
      • Get transactions list v2
    • Chargebacks
      • Query chargebacks
      • Request chargeback export
    • Gateway Status
      • Get gateway status
    • Payment Credentials
      • Create a credential
      • Search credentials
      • Advanced search
      • Activate or deactivate
      • Delete credential
      • Update credential
      • Regenerate a credential
    • Payment Button
      • Create a payment button
    • Platform Status
      • Get platform status
    • Subscription Transactions
      • Get subscription transactions
    • Settlement
      • Query settlement
  • Card Present Payments (API Raw)
    • Release notes
    • Key Exchange Process
    • Test data
    • Kushki Error Catalog for POS transactions
    • The Amount Object
    • One-time Payments
      • Single payment
    • Two-step Payments
      • Authorization and capture
    • Voids & Refunds
      • Refund a transaction
      • Void & Reverse
    • Card information
      • Get BIN Info
      • Bin Info V2
      • Request deferred options
      • Balance inquiries
    • Query Transactions
      • Transaction Search
    • Webhooks
      • Introduction
      • Good practices
      • Refunds
      • Card Payments
      • Check your webhooks
  • Kushki One
    • Cloud Services
      • Payment Cloud
        • Charge
        • Authorization (Pre-auth)
        • Capture
        • Re-authorization
        • Post-tip
        • Void
        • Refund
        • Abort
        • Transaction Search
      • Print Cloud
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Payment Local
        • Charge
        • Authorization (Pre-auth)
        • Capture
        • Re-authorization
        • Post-tip
        • Void
        • Refund
        • Transaction Search — Local
        • Transaction Search — Online
        • Abort
      • Print Local
        • Create Print Job
        • Get Print Job Status
        • Print Job Webhook (inbound — implemented by your POS)
  • Appian - Submerchant Register
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Get submerchantIds
    • Get credentials for submerchants
  • Raíz
  • Schemas
    • Shared
      • ErrorResponse
      • BadRequestResponse
      • InvalidBinResponse
      • payment_method
      • payment_submethod
      • messageFields
      • Channel
    • Amount & Taxes
      • Amount-cash-in
      • GetConfigurationRequest
    • Identity & Contact
      • Shipping Address
    • Card & Payments
      • ChargesVoidCardResponse
      • Promotions
      • Submerchant
    • Subscriptions
      • SubscriptionUpdate
      • SubscriptionAdjustmentRequest
      • SubscriptionTransactionsResponse
    • Webhooks
    • Analytics
      • AnalyticsTransactionItem
      • AnalyticsListResponse
    • Settlement
      • SettlementDateRangeRequest
      • SettlementTicketRequest
      • SettlementResponse
    • Chargebacks
      • ChargebackListResponse
      • ChargebackSearchRequest
    • Cash
      • CashChargeInitRequest
      • CashStatusResponse
    • Transfer
      • TransferTokenRequest
      • TransferInitRequest
      • TransferStatusResponse
    • Payouts
      • PayoutsWebhooksItem
    • Smart Link
      • SmartLinkAmount
    • Terminal
      • AmountWithTaxes
      • AmountCore
      • AmountWithTip
      • TerminalCardDetails
      • TerminalPosDetails
      • TerminalContactDetails
      • TerminalCardData
      • TransactionResponse
      • LinkFailure
      • TransactionSearchRequest
      • PrintJobRequest
      • PrinterError
      • PrintJobStatus
      • PrintWebhookPayload
    • RequestBodies
      • one-and-two-step-payment
    • currency
    • SettlementDateRangeRequest
    • SubscriptionTransactionsResponse
    • card-old
    • AmountWithTaxes-old
    • Card
    • Shipping Address
    • transactionType
    • ChargebackItem-old
    • SettlementTicketRequest
    • SubscriptionTransaction
    • amount
    • AmountCore-old
    • CommandText-old
    • networkToken
    • Language
    • extra_taxes
    • card_details
    • currency
    • ErrorResponse400-old
    • webhooksItem
    • ErrorResponse
    • SettlementResponse
    • extra_taxes-old
    • ExtraTaxes-old
    • CommandColumns-old
    • currency
    • card
    • orderDetails-old
    • Country
    • ContactDetails-old
    • ErrorResponse401-old
    • SettlementRecord
    • pos_details-old
    • ColumnItem-old
    • Amount
    • amount
    • documentType
    • extraTaxes-old
    • ErrorResponse403-old
    • card_details-old
    • TransactionResponse-old
    • CommandDivider-old
    • extraTaxes
    • enc_tlv
    • payment_method
    • ErrorResponse500-old
    • threeDomainSecure
    • enc_tlv
    • RawResponse-old
    • CommandFeed-old
    • Deferred
    • pos_details
    • deferred
    • binInfo
    • contact_details-old
    • CardData-old
    • CommandSpace-old
    • paymentMethod-old
    • Metadata
    • contact_details
    • Billing-Address-old
    • Deferred-old
    • deferred-old
    • sub_merchant
    • AmountWithTip-old
    • CommandCut-old
    • ContactDetails
    • sub_merchant
    • headers
    • Amount-old
    • metadata
    • LinkFailure-old
    • CommandImage-old
    • metadata
    • SubscriptionUpdate
    • TransactionSearchRequest-old
    • CommandQR-old
    • orderDetails
    • Subscription
    • payment_submethod
    • citMit
    • SubscriptionAdjustmentRequest
    • CommandBarcode-old
    • Shipping Address
    • messageFields
    • PrinterError-old
    • Billing Address
    • webhooksChargeback
    • Language
    • PrintJobStatus-old
    • currency-cash-in-old
    • product
    • webhooks
    • networkToken-old
    • PrintWebhookPayload-old
    • currency-CL-old
    • threeDomainSecure
    • webhooks
    • product-old
    • headers
    • webhooksChargeback
    • UnexpectedErrorResponse-old
    • citMit
    • network
    • Card-old-old
    • Submerchant-old
    • binInfo
    • Shipping-Address-old
    • messageFields
    • Promotions-old
    • UnexpectedErrorResponse
    • transactionType
    • InvalidBinResponse-old
    • GetConfigurationRequest-old
    • BadRequestResponse-old
    • Amount-CL-old
BienvenidaPerú 🇵🇪
México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
BienvenidaPerú 🇵🇪
México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
  1. Card Present Payments (API Raw)

Release notes


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:
1.
MAJOR version when we make incompatible API changes,
2.
MINOR version when we add functionality in a backward-compatible manner, and
3.
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.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.

Previous release notes#

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

powered-by-Kushki
Modified at 2026-05-28 16:06:18
Previous
Card Present Payments (API Raw)
Next
Key Exchange Process
Built with