1. API Raw Card Present
  • API Docs Mexico 🇲🇽
  • Online Payments
    • Release Notes
    • Card Payments
      • Request a card token
      • Make a charge or deferred charge
      • Create payment (tokenless)
      • Request deferred options
      • Refund a transaction
      • Authorize payments
      • Preauthorization (tokenless)
      • Void a transaction
      • Reauthorize payments
      • Capture an authorized payment
      • Bin Info V2
      • Bin Info
      • Validate OTP
      • Verify Account
    • One-Click and Scheduled Payments
      • Request a recurring charge token
      • Create a recurring charge
      • Make an One-click payment
      • Update recurring charge card data
      • Cancel a recurring charge
      • Update a recurring charge
      • Add a temporary charge or discount
      • Authorize payments
      • Capture an authorized payment
      • Get recurring charge Info
    • 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
    • Smartlinks
      • Create a Smartlink
      • Get a Smartlink
      • Delete a smartlink
      • Update a Smartlink
    • Payment Button
      • Create a payment button
    • Analytics
      • Get transactions list v1
      • Get transactions list v2
    • Chargebacks
      • Query chargebacks
      • Request chargeback export
    • Commissions
      • Get Commission Configuration
    • Payment Credentials
      • Create a credential
      • Activate or deactivate
      • Delete credential
      • Regenerate a credential
      • Update credential
      • Advanced search
      • Search credentials
    • Platform Status
      • Get platform status
      • Get gateway status
    • Settlement
      • Query settlement
    • Subscription Transactions
      • Get subscription transactions
  • Card Present Billpocket
    • Get Started
      • Create Account
      • User Token
      • API Keys
    • Webhooks
      • Webhooks — Transfer Funds (v1)
      • Webhooks — Transfer Funds to Your Bank Account
      • Transfer Funds Errors
    • Terminals
      • App Review
      • Splash Screen
    • Card Present Payment Services
      • Cloud Terminal API
        • Collect card payments
        • Print Ticket
        • Cancel Push Notification
        • Get transaction status
        • Collect card payments v2
      • App-to-App
        • Android intents
        • App to App — iOS
        • App to App — Mobile Web
      • Terminal SDK
        • Terminal SDK
        • Android SDK errors
    • Card not Present Billpocket Services
      • 3DS Checkout
        • Create checkout
        • Get checkout details
      • E-commerce Flex
        • Get token
        • Validate token
        • Collect payments
        • Refund
        • Capture an authorized payment
        • Get status
    • Catalogs
      • States
      • Municipalities
      • Tax companies
      • Commercial activities
    • User Settings
      • Create user
    • Accounts
      • Clabe Account Setup
        • Add CLABE account
      • Deposit Accounts
        • Add or update CLABE account
    • Transactions
      • Transaction List
        • Get token
        • Get transaction list
        • Get transaction list v2
        • Get transaction list v3
        • Get transaction list v4
      • Cancel Payments
        • Cancel payments Error Codes
        • Cancel payments
  • API Raw Card Present
    • The Amount Object
    • Error Catalog
    • Key Exchange Process
    • Release Notes
    • Test Data
    • One-time payments
      • Single payment
    • Two-step-payments
      • Authorization and capture
    • Voids & Refunds
      • Refund a transaction
    • Card information
      • Get BIN Info
      • Balance inquiries
      • Bin Info V2
      • Request deferred options
    • Query Transactions
      • Transaction Search
    • Webhooks
      • Webhooks — Introduction
      • Good Practices
      • Webhooks — Card Payments
      • Webhooks — Refunds
      • Check Your Webhooks
  • Kushki One
    • Cloud Services
      • Payment
        • Charge
        • Authorization (Pre-auth)
        • Capture
        • Re-authorization
        • Post-tip
        • Void
        • Refund
        • Abort
      • Search
        • Transaction Search
      • Print
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Print
        • Create Print Job
        • Get Print Job Status
        • Print Job Webhook (inbound — implemented by your POS)
      • Payment
        • Charge
        • Authorization (Pre-auth)
        • Capture
        • Re-authorization
        • Post-tip
        • Void
        • Refund
        • Abort
      • Search
        • Transaction Search — Online
        • Transaction Search — Local
  • Appian - Submerchant Register
    • Submerchant Validation in Batch
    • Query submerchant status by requestId/submerchantId
    • Submerchant Document Upload
    • Get submerchantIds
    • Get credentials for submerchants
  • Schemas
    • RequestBodies
      • one-and-two-step-payment
    • Card
    • Channel
    • Amount-cash-in
    • ChargebackListResponse
    • StatusComponent
    • SettlementDateRangeRequest
    • SubscriptionTransactionsResponse
    • amount
    • AmountWithTaxes
    • PrintJobRequest
    • networkToken
    • ChargebackItem
    • SettlementTicketRequest
    • SubscriptionTransaction
    • extra_taxes
    • AmountCore
    • CommandText
    • currency
    • ErrorResponse400
    • ErrorResponse
    • SettlementResponse
    • webhooksItem
    • card
    • ExtraTaxes
    • CommandColumns
    • Amount
    • Country
    • ErrorResponse401
    • SettlementRecord
    • card_details
    • ColumnItem
    • extraTaxes
    • ErrorResponse403
    • enc_tlv
    • TransactionResponse
    • CommandDivider
    • Deferred
    • payment_method
    • ErrorResponse500
    • deferred
    • RawResponse
    • CommandFeed
    • Metadata
    • pos_details
    • CardData
    • CommandSpace
    • ContactDetails
    • contact_details
    • sub_merchant
    • AmountWithTip
    • CommandCut
    • documentType
    • Subscription
    • metadata
    • LinkFailure
    • CommandImage
    • orderDetails
    • Language
    • TransactionSearchRequest
    • CommandQR
    • Shipping Address
    • payment_submethod
    • CommandBarcode
    • Billing-Address
    • SubscriptionUpdate
    • PrinterError
    • product
    • SubscriptionAdjustmentRequest
    • PrintJobStatus
    • threeDomainSecure
    • PrintWebhookPayload
    • webhooks
    • headers
    • webhooksChargeback
    • citMit
    • network
    • binInfo
    • messageFields
    • UnexpectedErrorResponse
    • transactionType
    • ExternalReferenceId
    • ExternalSubscriptionId
BienvenidaPerú 🇵🇪México 🇲🇽
Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
BienvenidaPerú 🇵🇪México 🇲🇽
Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
  1. API Raw Card Present

Release Notes


Release Notes#

Discover the latest feature releases, product improvements, and bug fixes for Kushki Card Present — Mexico 🇲🇽.


Stay up to date with changes and updates to the Kushki Card Present API for Mexico.
We use ISO 8601 (YYYY-MM-DD) for dates and Semantic Versioning (MAJOR.MINOR.PATCH):
1.
MAJOR — incompatible API changes
2.
MINOR — new backward-compatible functionality
3.
PATCH — backward-compatible bug fixes
NEW — new features
IMPROVEMENTS — changes to existing functionality
DEPRECATED — features soon to be removed
REMOVED — removed features
FIX — bug fixes
SECURITY — security 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:
FieldDescription
userOperator user of the device.
friendly_nameDisplay name assigned to the terminal (e.g., "Caja principal").
serialSerial number of the device.
typePhysical type of the POS device. Allowed values: COUNTERTOP, MPOS, SMARTPOS, SELF_SERVICE, OTHER.
connectivityNetwork connectivity type. Allowed values: GPRS, WIFI, ETHERNET, DIAL_UP, OTHER.
These fields are optional. When included, they are persisted and returned in transaction list responses and webhook notifications.

Previous release notes#

1.3.0 — 2026-03-20#

NEW

⚖️ Chargebacks API#

Introducing the Chargebacks API — query chargeback information directly via API and request asynchronous exports.
New endpoints:
POST /data/v1/chargebacks/search — Paginated list of chargebacks with filters by date, status, and type.
POST /data/v1/chargebacks/export — Initiates asynchronous export; Kushki POSTs the download link to your webhook URL when ready.

1.2.1 — 2025-04-02#

IMPROVEMENTS

Cardless reversals 🇲🇽 (Beta)#

Added support for performing same-day reversals without requiring the physical card.
Use client_transaction_id from the original transaction.
Must be requested on the same day, before 22:00 México local time.
Reversal is always for the full transaction amount.

1.2.0 — 2025-02-27#

NEW

🇲🇽 MSI (Meses Sin Intereses) — Card Present#

Beta
MSI for Card Present is currently in Beta phase for Mexico. Contact the Kushki team to enable this feature.
Merchants can now offer Meses Sin Intereses (MSI) installments by sending credit_type: "03" and graceMonths: "00" in the deferred object.
"deferred": {
  "months": "6",
  "credit_type": "03",
  "graceMonths": "00"
}
Also in this release:
Added GET /deferred/v2/bin/{bin} — returns MSI type "03" in the response for eligible BINs.
Cardless operations in Beta for México: omit_card: true supported for captures, reauthorizations, voids, and refunds.

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#

ticket_number is now included in all approved transaction responses:
Single payments — charges and MSI deferred charges
Two-step payments — preauthorizations, captures, reauthorizations
Voids & Refunds — voids, reverses, and refunds
Query Transactions — transaction search results

1.0.1 — 2024-02-15#

NEW

Cardless operations (Beta)#

Added omit_card field for card-free operations across all endpoints.
Added metadata field to attach additional information to any request.
New request examples: GL - Cardless Reauthorization, GL - Cardless Capture, GL - Cardless Void, GL - Cardless Refund.
IMPROVEMENTS
Updated descriptions for reversal, reauthorization, capture, and void sections.

1.0.0 — 2024-01-18#

NEW

🇲🇽 Card Present API for Mexico — General Availability#

Launching the Card Present raw API for Mexico with the following supported operations:
Single charge (ICC, MCR, NFC)
MSI deferred charge — Meses Sin Intereses
Charge with tip
Pre-authorization and capture
Reauthorization
Voids and refunds
BIN lookup and MSI deferred options
Transaction search
Got a suggestion on this documentation? Contact us.
Modified at 2026-06-03 14:41:53
Previous
Key Exchange Process
Next
Test Data
Built with