1. Terminal SDK
  • 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. Terminal SDK

Android SDK errors

Android SDK Errors#

Unexpected errors can occur at different stages of the payment flow. Use this reference to identify errors and implement correct handling in your app.

SDK errors#

MessageCallback
Estableciendo conexiónonBeforeTransaction
Autorizando venta, no retire la tarjetaonCardRead
Autorizando venta contactlessonCardRead
Autorizando venta banda magneticaonCardRead
Inserta tu tarjeta, por favor.onReaderWaitingForCard
Lector inválido, contacta a soporteonTransactionAborted
Transacciones SiVale no permitidas. Contáctanos en soporte@billpocket.comonTransactionAborted
time outonTransactionAborted
Se ha producido un error en la lectura. Por favor, inténtelo de nuevo.onTransactionAborted
Unable to communicate with the reader, please restart the sdkonTransactionAborted
Hubo un problema con tu transacción (idDevice)onTransactionAborted
Ocurrió un error al leer el NFC de la tarjeta. Por favor, inténtalo nuevamente.onTransactionAborted
NFC declinado. Inténtalo nuevamente.onTransactionAborted
No es posible leer la tarjeta en la ranura. Por favor, inténtelo nuevamenteonTransactionAborted
Ocurrió un error al leer la tarjeta. Por favor, inténtelo nuevamenteonTransactionAborted
Hubo un problema de comunicación con el lector. Por favor, inténtelo nuevamenteonTransactionAborted
No se ha detectado ninguna tarjetaonTransactionAborted
Sucedió un error. Inténtalo nuevamenteonTransactionAborted
Lo sentimos, actualmente no aceptamos transacciones con tarjetas múltiplesonTransactionAborted
No se puede comunicar con el lector. Por favor, reinicie el sdk.onTransactionAborted
No se puede establecer comunicación con la terminalonTransactionAborted
Ocurrió un problema de comunicación con el lectoronTransactionAborted
Tiempo de espera agotadoonTransactionAborted
La transacción no se ejecutó. Inténtalo de nuevo, por favor ( %1$d )onTransactionAborted
Este método de pago aún no está disponibleonTransactionAborted, onTransactionFinished
Ha ocurrido un error durante la lectura. Inténtalo nuevamenteonTransactionAborted, onTransactionFinished
Sucedió un problema de conectividad mientras se procesaba tu transacción. Revisa tu historial.onTransactionAborted, onTransactionFinished
La transacción no se pudo procesar en este momento. Inténtalo de nuevo, por favoronTransactionAborted, onTransactionFinished
El importe mínimo es de 10 pesosonTransactionFinished
Ha ocurrido un error. Inténtelo nuevamenteonTransactionFinished
Tu usuario esta bloqueado. Ponte en contacto con nuestro equipo para reactivar tu cuenta.onTransactionFinished
La transacción no puede ser procesada con esta tarjeta. Intenta con otra tarjeta, por favor.onTransactionFinished
Promoción de meses sin intereses inválidaonTransactionFinished
Has alcanzado el límite de operaciones permitido. Podrás continuar cuando recibas tu lector Billpocket.onTransactionFinished
El track recibido no es válidoonTransactionFinished
Fondos insuficientesonTransactionFinished
RECHAZADA (DUPLICIDAD)onTransactionFinished
Rechazada American ExpressonTransactionFinished
Transacción no procesada. Fondos insuficientes. Contactar al emisor (51)onTransactionFinished
Transacción no procesada. Rechazo del banco, contactar al emisor (05)onTransactionFinished
Transacción no procesada. Tarjeta vencida. Contactar al emisor (54)onTransactionFinished
Transacción no procesada. NIP incorrecto. Contactar al emisor (55)onTransactionFinished
Transacción no procesada. Excedió el tiempo para ingresar el NIP (75)onTransactionFinished
APROBADAonTransactionSuccessful
Aprobada sin firma (2)onTransactionSuccessful
No hemos podido identificar su lectorReaderConnectionResult
El sdk se inicializo correctamenteresultInitSdk
El sdk no se inicializó correctamente. Por favor, compruebe sus credenciales.resultInitSdk
Ocurrió un problema para obtener la lista de lectores bluetoothresultListReaders
Tu dispositivo no tiene bluetoothresultListReaders
No has inicializado el sdkresultListReaders
Necesita permiso de conexión bluetoothresultListReaders, resultReaderConnect
Un lector ya está conectadoresultReaderConnect
Bluetooth está apagadoresultReaderConnect
No hay un lector conectadoresultReaderDisconnection
El lector se desconectó.resultReaderDisconnection
Esta venta ya fue devueltaresultRefundPayment
La devolución es inválida. Conoce las condiciones en http://ayuda.billpocket.comresultRefundPayment
La transacción no existe o ya ha sido devueltaresultRefundPayment
La transacción no pertenece al usuario enviadoresultRefundPayment
No hay conexión a InternetresultStartTransaction
El nivel de batería es demasiado bajo, carga el lector para continuar, por favor.startTransaction
Tipo de lector no válidostartTransaction
Iniciando la transacciónstartTransaction

Terminal errors#

MessageTerminal model
Transacción aprobadaNano
La transacción se terminóNano
DeclinadaNano
Transacción canceladaNano
Tarjeta no soportadaNano
FallbackNano
Tarjetas múltiplesNano
Parámetros incorrectos. Inténtalo de nuevo (-100)Ultra / Ultra printer
Instrucción Ilegal. Inténtalo de nuevo. (-101)Ultra / Ultra printer
Configuración incorrecta. Contacta a Soporte (-1000)Ultra / Ultra printer
Error de Inicialización. Reinicia tu app e inténtalo nuevamente (-1002)Ultra / Ultra printer
Sucedió un error leyendo la tarjeta. Inténtalo nuevamente (-2000)Ultra / Ultra printer
No se detectó ninguna tarjeta (-2001)Ultra / Ultra printer
Utiliza una sola tarjeta e inténtalo nuevamente (-2002)Ultra / Ultra printer
No se capturó PIN (-3006)Ultra / Ultra printer
Captura de PIN cancelada (-3007)Ultra / Ultra printer
Se agotó el tiempo de espera para la captura de PIN (-3008)Ultra / Ultra printer
Transacción cancelada. Verifica tu historial e inténtalo nuevamente (-4000)Ultra / Ultra printer
Transacción cancelada. Verifica tu historial e inténtalo nuevamente (Tarjeta Bloqueada) (-4104)Ultra / Ultra printer
Transacción cancelada. Verifica tu historial e inténtalo nuevamente (Tarjeta expirada) (-4111)Ultra / Ultra printer
Configuración incorrecta. Reinicia tu aplicación e inténtalo nuevamente (-4500)Ultra / Ultra printer
Falla de Integridad. Reinicia tu aplicación e inténtalo nuevamente (-3000)Ultra / Ultra printer
Error en la captura del PIN (-50020)Ultra / Ultra printer
Error de selección de aplicación (-50022)Ultra / Ultra printer
Sucedió un error durante la autorización. Verifica tu historial e inténtalo nuevamente (-50023)Ultra / Ultra printer
Error en la captura del PIN. Inténtalo nuevamente (-60001)Ultra / Ultra printer
Faltan permisos (-70001)Ultra / Ultra printer
INFO
For the complete list of all terminal error codes, refer to the full error table in the original SDK documentation.

Got a suggestion on this documentation? Contact us.
Modified at 2026-06-04 19:41:35
Previous
Terminal SDK
Next
Card not Present Billpocket Services
Built with