1. Card Present Billpocket
  • API Docs Mexico 🇲🇽
  • Online Payments
    • Release Notes
    • Kushki API errors
    • ISO errors
    • 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
    • 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 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
    • Fraud Report
      • Query fraud alerts
  • Card Present Billpocket
    • Release Notes
    • Android SDK Release Notes
    • Android App Release Notes
    • iOS App Release Notes
    • Get Started
      • Create Account
      • User Token
      • API Keys
    • Webhooks
      • 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
        • 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
      • Void & Reverse
    • Card information
      • Get BIN Info
      • Bin Info V2
      • Request deferred options
    • Query Transactions
      • Transaction Search
    • Webhooks
      • Webhooks — Introduction
      • Good Practices
      • Webhooks — Card Payments
      • Webhooks — Refunds
      • Check Your Webhooks
    • Chargebacks
      • Query Chargebacks
      • Request Chargeback Export
    • Fraud Report
      • Query fraud alerts
  • Kushki One
    • Error Catalog
    • Release notes
    • Transaction Examples
    • Webhooks
    • Cloud Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
        • Search
          • Transaction Search
      • Print
        • Create Print Job
        • Get Print Job Status
    • Local Services
      • Payment
        • Sync
          • Charge
          • Authorization (Pre-auth)
          • Capture
          • Re-authorization
          • Post-tip
          • Void
          • Refund
          • Abort
        • Async
          • Charge (Async)
          • Authorization — Pre-auth (Async)
          • Capture (Async)
          • Re-authorization (Async)
          • Post-tip (Async)
          • Void (Async)
          • Abort (Async)
        • Search
          • Transaction Search — Online
          • Transaction Search — Local
      • Print
        • Create Print Job
        • Get Print Job Status
        • Print Job Webhook (inbound — implemented by your POS)
  • Appian - Submerchant Register
    • Release Notes
    • 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
    • TransactionResponse
    • PrintJobRequest
    • one-and-two-step-payment-2
    • Card Present (CP)
    • one-and-two-step-payment-2
    • FraudAlertRequest
    • networkToken
    • Deferred
    • ChargebackItem
    • SubscriptionTransaction
    • extra_taxes
    • RawResponse
    • CommandText
    • Card Not Present (CNP)
    • FraudAlertResponse
    • currency
    • ErrorResponse400
    • ErrorResponse
    • SettlementResponse
    • SettlementRecord
    • webhooksItem
    • card
    • CardData
    • CommandColumns
    • FraudAlertRecord
    • Amount
    • Country
    • ErrorResponse401
    • card_details
    • LinkFailure
    • ColumnItem
    • ValidationError
    • extraTaxes
    • ErrorResponse403
    • enc_tlv
    • CommandDivider
    • TransactionEvent
    • payment_method
    • ErrorResponse500
    • deferred
    • CommandFeed
    • TransactionStatus
    • pos_details
    • CommandSpace
    • ReadingType
    • ContactDetails
    • contact_details
    • sub_merchant
    • CommandCut
    • FailureReason
    • documentType
    • Subscription
    • metadata
    • CommandImage
    • EventTerminal
    • orderDetails
    • Language
    • TransactionSearchRequest
    • CommandQR
    • EventOperation
    • Shipping Address
    • payment_submethod
    • CommandBarcode
    • EventAmount
    • Billing-Address
    • EventExtraTaxes
    • PrintJobAccepted
    • SubscriptionUpdate
    • product
    • SubscriptionAdjustmentRequest
    • PrinterError
    • EventMetadata
    • threeDomainSecure
    • AmountWithTaxes
    • PrintJobStatus
    • PrintJobStatusRequest
    • webhooks
    • AmountCore
    • headers
    • ExtraTaxes
    • PrintWebhookPayload
    • Metadata
    • webhooksChargeback
    • citMit
    • AmountWithTip
    • network
    • TransactionSearchBody
    • TransactionSearchOnlineBody
    • binInfo
    • AmountWithOptionalTip
    • TransactionSearchLocalBody
    • messageFields
    • TransactionEvent_2
    • UnexpectedErrorResponse
    • FailureReason_2
    • transactionType
    • ExternalReferenceId
    • EventTerminal_2
    • ExternalSubscriptionId
    • EventOperation_2
    • EventAmount_2
    • EventExtraTaxes_2
    • EventMetadata_2
    • SettlementTicketRequest
HomePerú 🇵🇪México 🇲🇽
Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
HomePerú 🇵🇪México 🇲🇽
Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
  1. Card Present Billpocket

Release Notes


Release notes#

Discover the latest feature releases, product improvements and bug fixes for the documentation.


We used the ISO 8601 standard (YYYY-MM-DD) for dates.

Types of changes#

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.5 - 2025-08-05#

Print ticket on terminal#

You can now send custom tickets to print directly on a Summit terminal using Cloud Terminal Services.
To use this feature, submit a JSON request including:
The terminal's serial number (serialNumber)
The ticket structure (ticketData)
Optionally, a pre-print notification (showNotification)
→ This allows you to send tailored messages and layout designs to display or print on the device.

Previous release notes#

1.4.4 - 2025-04-24#

New webhook for SPEI Transfers#

A new version of the fund transfer webhook has been released. This webhook provides detailed SPEI deposit information.

1.4.3 - 2025-03-18#

New version of transaction list endpoint#

We added a fourth version of the transaction list service where we added the timezone filter.
timezone parameter has been added to filter transaction results within a specify timezone.
dateresponse parameterhas been standardized to RCF 9557 format.

1.4.1 - 2025-26-02#

IMPROVEMENTS for changes in existing functionality.
Added the msi parameter to process deferred transactions in the Collect card payments v2 service in Cloud Terminal.

1.4.0 - 2025-28-01#

NEW

Cancel push notifications and get status in Cloud Terminal#

We have added the parameters ttl, deviceToken in the Collect card payments v2 service and also the response code 010.
Now you can cancel pending push notifications with the new Cancel Push Notification service.
Now you can ebtain the status of a payment request by sending the uniqueReference number in the Get transaction status service.
NEW

New Autopayment field in Cloud Terminal#

We've added the object extras Collect card payments v2 service which allows to trigger the payment automatically without waiting for confirmation via the Pay button. Also, the timerFinishTRX allows to specify the number of seconds before the checkout summary screen closes after the purchase is completed and finally, the enableDialogTip parameter allows to decide whether a dialog should appear to the enter the tip amount during the payment process.

1.3.0 - 2024-11-28#

NEW
New custom checkout integration type added.

1.2.0 - 2024-11-08#

NEW

New version of transaction list endpoint#

We added a third version of the transaction list service where some response fields have been renamed.
rejectionCode has been renamed to rejectionCode.
subtotal has been renamed to finalAmount.
surcharge has been renamed to msiFee.
transactionRefundedId has been renamed to refundedTransactionId.

1.1.0 - 2024-08-22#

NEW

New version of collect card payments endpoint#

We added a new version of the Collect card payments endpoint of the Cloud Terminal API with new properties in the request and response.
Send an alphanumeric unique reference of up to 64 characters in the uniqueReference property when making a request through the Cloud terminal API for traceability in your requests.

{
  "amount": 37,
  "identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
  "serialNumber": "TERM123",
  "uniqueReference": "d6732f94-6cf2-4dfb-aed7-11b64b739407"
}

Set whether the POS application will open automatically or whether requests will be queued via notifications with the showNotification property on a request.

{
  "amount": 37,
  "identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
  "serialNumber": "TERM123",
  "uniqueReference": "d6732f94-6cf2-4dfb-aed7-11b64b739407",
  "showNotification": true
}

Updated the error response structure.
V1:

{
  "error": "Bad Request",
  "message": [
    "serial_number must not contain special characters"
  ],
  "statusCode": 400
}

V2:

{
  "message": [
    "serialNumber must not contain special characters"
  ],
  "responseCode": "002"
}

Property names in request and response have been updated to camel case instead of snake case in version 2.
V1:

{
  "amount": 37,
  "identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
  "serial_number": "TERM123"
}

V2:

{
  "amount": 37,
  "identifier": "c68522bd-bfc1-4b08-bf99-30300806c25a",
  "serialNumber": "TERM123"
}

Now you will be able to know the status of the notifications sent to the terminal. In case there is an error and you cannot identify whether the operation was carried out successfully or not, you can obtain the status of the operation by sending the same reference as above. If the operation exists, you will get one of the following responses, according to the status of the operation.
Created#
Get a responseCode 004 if the operation has already been created.

{
  "status": "CREATED",
  "message": "Petición de cobro duplicada uniqueReference:  9b6c37db-231e-464c-a2c1-466e2de9fec1",
  "responseCode": "004"
}
Cancelled#
Get a responseCode 005 if the operation has been cancelled.

{
  "status": "CANCELLED",
  "message": "Petición de cobro duplicada uniqueReference:  9b6c37db-231e-464c-a2c1-466e2de9fec1",
  "responseCode": "005"
}
Approved#
Get a responseCode 006 if the operation has been approved.

{
  "status": "APPROVED",
  "message": "Petición de cobro duplicada uniqueReference:  9b6c37db-231e-464c-a2c1-466e2de9fec1",
  "responseCode": "006"
}
Refunded#
Get a responseCode 007 if the operation has been refunded.

{
  "status": "REFUNDED",
  "message": "Petición de cobro duplicada uniqueReference:  9b6c37db-231e-464c-a2c1-466e2de9fec1",
  "responseCode": "007"
}

New version of transaction list endpoint#

We added a second version of the transaction list endpoint with new filters and returned information.
You can now filter by uniqueReference sent at the time of a request via the Cloud Terminal API.
Property names in the response have been renamed with camel case instead of snake case in v2.
V1:

{
    "data": [
        {
            "transaction_id": 130008,
            "authorization_number": "",
            "bank": null,
            "card_brand": "Visa",
            "card_type": null,
            "capture_method": "msc",
            "commission": 0.49,
            "countercharged": false,
            "date": "2024-07-12T10:09:26.000Z",
            "details": null,
            "device": "Device 1",
            "error_detail": "Rechazo por reglas internas",
            "masked_card": "400000******0002",
            "msi": null,
            "retention": 0,
            "rejection_code": null,
            "subtotal": 13.48,
            "surcharge": 0,
            "tip": 0,
            "total_amount": 14.05,
            "transaction_type": "venta",
            "transaction_status": "rechazadaRiesgo",
            "vat": 0.08
        }
    ],
    "currentPage": 1,
    "perPage": 100,
    "total": 1
}

V2:

{
    "data": [
        {
            "transactionId": 130009,
            "authorizationNumber": "",
            "bank": null,
            "cardBrand": "Visa",
            "cardType": null,
            "captureMethod": "msc",
            "commission": 0.49,
            "chargeback": false,
            "date": "2024-07-12T10:09:26.000Z",
            "details": null,
            "device": "Device 1",
            "errorDetail": "Rechazo por reglas internas",
            "masked_card": "400000******0002",
            "msi": null,
            "retention": 0,
            "rejectionCode": null,
            "subtotal": 13.48,
            "surcharge": 0,
            "tip": 0,
            "totalAmount": 14.05,
            "transactionType": "venta",
            "transactionStatus": "rechazadaRiesgo",
            "vat": 0.08,
            "uniqueReference": ""
        }
    ],
    "currentPage": 1,
    "perPage": 100,
    "total": 1
}

Other changes
Added uniqueReference property in notifications via webhooks.
Added uniqueReference property in Cancel payments request.
New refund events in webhooks. Find out more in the Webhooks documentation.
IMPROVEMENTS
The structure of the error response in the Cancel payments endpoint has been updated.
1.0.0 - 2024-07-01
NEW
Discover different ways to receive payments and grow your business.

powered-by-Kushki.svg
Modified at 2026-09-08 00:26:50
Previous
Card Present Billpocket
Next
Android SDK Release Notes
Built with