Ir a contenido
Crea una cuenta o inicia sesión
Logotipo de la documentación de Stripe
/
Pregúntale a la IA
Crear cuentaIniciar sesión
Empezar
Pagos
Ingresos
Plataformas y marketplaces
Gestión del dinero
Recursos para desarrolladores
API y SDKAyuda
Resumen
Acerca de Stripe Payments
Actualiza tu integración
Análisis de pagos
Pagos por Internet
ResumenEncuentra tu caso de usoUsa Managed Payments
Utiliza Payment Links
Usa una página de proceso de compra prediseñada
Crea una integración personalizada con Elements
Desarrolla una integración en la aplicación
Pagos en persona
Terminal
    Resumen
    Acepta pagos en persona
    Disponibilidad internacional
    Diseño de la integración
    Selecciona tu lector
      Stripe Reader S700
      BBPOS WisePOS E
      Stripe Reader M2
      BBPOS WisePad 3
      Tap to Pay
      Verifone P400
      BBPOS Chipper 2X BT
    Diseña una integración
    Inicio rápido
    Aplicaciones de ejemplo
    Pruebas
    Configuración de Terminal
    Configura tu integración
    Pagos a múltiples destinatarios con Connect
    Conectarse a un lector
    Aceptar un pago
    Cobrar pagos con tarjeta
    Otros métodos de pago
    Aceptar pagos sin conexión
    Pagos de pedidos telefónicos o pedidos por correo
    Consideraciones regionales
    Durante el proceso de compra
    Cobrar propinas
    Recopilar y guardar datos de pago para su uso en el futuro
    Autorizaciones flexibles
    Después del proceso de compra
    Reembolsar transacciones
    Solicitar recibos
    Personalizar Checkout
    Mostrar carrito
    Recopilar entradas en pantalla
    Recopilar datos deslizados
    Recopilar datos pulsados para los instrumentos de NFC
    Aplicaciones en dispositivos
    Gestionar lectores
    Pedir, devolver o sustituir lectores
    Registrar lectores
    Gestionar ubicaciones y zonas
    Configurar los lectores
    Seguimiento de los lectores
    Referencias
    Referencias de la API
    Lectores móviles
    Lectores inteligentes
    Lectores Tap to Pay
    Guía de migración de SDK
    Lista de verificación de la implementación
    Fichas de producto del lector de Stripe Terminal
Métodos de pago
Añadir métodos de pago
Gestiona los métodos de pago
Proceso de compra más rápido con Link
Escenarios de pago
Administrar múltiples divisas
Flujos de pagos personalizados
Capacidad adquirente flexible
Orquestación
Más allá de los pagos
Constituye tu empresa
Criptomonedas
Comercio agéntico
Financial Connections
Climate
Comprender el fraude
Protección antifraude de Radar
Gestiona disputas
Verificar identidades
Estados Unidos
Español (España)
InicioPagosTerminalSelect your reader

Tap to Pay

Descubre cómo aceptar pagos sin contacto en un dispositivo iPhone o Android compatible.

¿Buscas una solución sin programación? Acepta pagos desde la aplicación móvil del Dashboard de Stripe.

Usa Tap to Pay en Android para aceptar pagos sin contacto en persona con dispositivos Android compatibles equipados con NFC.

Tap to Pay en Android es compatible con tarjetas sin contacto Visa, Mastercard, American Express y Discover, así como con monederos móviles basados en NFC (Apple Pay, Google Pay y Samsung Pay). Es compatible con la introducción de PIN. Además, es compatible con eftpos en Australia e Interac está en versión beta pública en Canadá. Stripe incluye Tap to Pay en Android en el SDK de Terminal para Android y el SDK de Terminal React Native, y permite realizar pagos directamente en tus aplicaciones móviles para Android.

Disponibilidad

Alemania
Australia
Austria
Bélgica
Dinamarca
Estados Unidos
Finlandia
Francia
Irlanda
Italia
Malasia
Nueva Zelanda
Países Bajos
Polonia
Reino Unido
Singapur
Suecia
Suiza

Disponibilidad en Public preview

Canadá
España
Luxemburgo
Noruega
Portugal
República Checa

Empezar

Integra la última versión del SDK de Terminal para Android para incluir las últimas correcciones de errores y funciones. Puedes ver las actualizaciones y correcciones de errores específicas de cada versión en el registro de cambios del SDK.

Los requisitos del dispositivo y de la versión mínima del SDK pueden cambiar debido a requisitos de cumplimiento de la normativa actualizados o a vulnerabilidades de seguridad. Para asegurarte de que tu solución está actualizada con los requisitos de Tap to Pay, suscríbete a terminal-announce@lists.stripe.com.

Para activar Tap to Pay en tu aplicación de Android, haz lo siguiente:

  1. Configura el SDK de Android de Terminal.
  2. Reemplaza tus dependencias existentes de stripeterminal por las siguientes:
    build.gradle.kts
    Kotlin
    Groovy
    No results
    dependencies { implementation("com.stripe:stripeterminal-taptopay:5.0.0") implementation("com.stripe:stripeterminal-core:5.0.0") // ... }
  3. Conéctate al lector de Tap to Pay.
  4. Cobra el pago con el lector Tap to Pay.

Dispositivos aceptados

Tap to Pay en Android funciona con una variedad de dispositivos Android, como teléfonos móviles, quioscos, tabletas, dispositivos portátiles, etc. Solo puedes detectar y conectarte a dispositivos que cumplan todos los siguientes criterios:

  • Tiene un sensor NFC integrado en funcionamiento y un procesador basado en ARM
  • No está rooteado y el cargador de arranque del dispositivo está bloqueado y permanece sin cambios
  • Funciona con Android 13 o posterior
  • Utiliza los servicios móviles de Google y tiene instalada la aplicación Google Play Store
  • Tiene un almacén de claves con soporte de hardware para ECDH (la versión de FEATURE_HARDWARE_KEYSTORE debe ser 100 o posterior).
  • Una conexión estable a Internet
  • Ejecuta el sistema operativo no modificado proporcionado por el fabricante

Nota

Tap to Pay no funciona en las versiones beta de Android.

Los emuladores de dispositivos Android no son compatibles con Tap to Pay. Los mismos requisitos del dispositivo se aplican en el lector simulado y en producción para ofrecer a los desarrolladores la experiencia más realista durante las pruebas.

Tipos de dispositivos

Los tipos de dispositivos admitidos incluyen, entre otros:

Tipo de dispositivoFabricanteModelos
SobremesaSunmiD3 MINI, V3 MIX
PortátilAmobilePD602
HoneywellCT37, CT47
ChainwayC66
CiontekCS50C
iMinSwift 2 Pro
SunmiL3, V3
ZCSZ92
ZebraTC53, TC53E
KioskSunmiFLEX 3, K2
RegístrateiMinFalcon2
SunmiD3 PRO, T3 PRO
TabletaSamsung Galaxy TabActive Pro, Active3, Active4 Pro, Active5
HMD GlobalHMD T21
HosotonH101
OukitelRT3
UlefoneArmor Pad Pro

Algunos fabricantes producen dispositivos certificados GMS y no GMS. Si utilizas un dispositivo no certificado por GMS, recibirás un mensaje de error que indica ATTESTATION_FAILURE: Device is not Google Mobile Services (GMS) certified al intentar conectar el dispositivo. Si esto ocurre, contacta con el fabricante para solucionar el problema.

Teléfonos móviles

Los teléfonos móviles compatibles incluyen, entre otros:

FabricanteModelos
AsusZenphone 9
GooglePixel 6, Pixel 6a, Pixel 7, Pixel 7a, Pixel 8, Pixel 8a, Pixel 9, Pixel 9a, Pixel 10
NokiaG22, G310, G42, G60, X10, X20, X30
Honor70, 70 Lite, 90, 90 Lite, 90 Smart, Magic5, Magic6, Magic7, X6, X7, X8, X9
InfinixHot 40 Pro, HOT 60i
LGV60 ThinQ
MotorolaMoto GX4, Moto GX5, G 2023, Edge 2023, G 2024, Edge 2024, G 2025, Edge 2025
OnePlusNord 4, Nord CE3, Nord CE4, Nord N30, 12, 12R, 13, 13R
OppoA60, A74, A77, A78, A79, A98, A98, FindX2 Pro, Find X2 Lite, Find X3 Pro, Find X5 Pro, Reno8, Reno10, Reno11, Reno12, Reno13, Reno14
Samsung GalaxyA04s, A05s, A13, A14, A15, A16, A17, A22, A23, A24, A25, A26, A32, A33, A34, A35, A36, A42, A42s, A53, A54, A55, A56, A71, A72, A73, Note20, S22, S23, S24, S25, Z Flip3, Z Fold3, Z Flip4, Z Fold4, Z Flip5, Z Fold5, Z Flip6, Z Fold7, Z Fold7
Xiaomi12, 12S, 12T, 13, 13T, 14, 14T, 15, 15T, Redmi 10, Redmi 12, Redmi 12C, Redmi 13, Redmi 13C, Redmi 14C, Redmi 15, Redmi Note 10, Redmi Note 11, Redmi Note 12, Redmi Note 13, Redmi Note 14

Interfaz de usuario

Tap to Pay en Android incluye pantallas de cobro de pagos. Cuando la aplicación está lista para cobrar un pago, el SDK de Stripe Terminal se hace cargo de la pantalla para gestionar el proceso de cobro. Después de llamar al método de pago del proceso, tu aplicación sigue ejecutándose, pero Tap to Pay muestra un mensaje de pantalla completa al titular de la tarjeta, indicándole que toque su tarjeta o monedero móvil basado en NFC. Si hay un error al leer la tarjeta, se muestra un mensaje para volver a intentarlo. Un toque exitoso devuelve una indicación de éxito y, a continuación, el control vuelve a tu aplicación.

Zona de contacto NFC específica del dispositivo

El SDK Tap to Pay en Android mueve automáticamente el indicador de la zona de contacto para ayudar al cliente final a comprender dónde se encuentra dicha zona en el dispositivo. Consulta ejemplos de cómo podría ser la experiencia del usuario en la práctica:

Ejemplo de pantalla táctil genérica

Pantalla táctil genérica

Ejemplo de pantalla táctil específica para el dispositivo

Pantalla táctil específica de cada dispositivo

Configuración de experiencia del usuario

Referencia del SDK

  • TapToPayUxConfiguration (Android)

Puedes anular la pantalla táctil predeterminada utilizando el SDK de Terminal Android, incluyendo los colores de la zona táctil, el mensaje de error, la animación de éxito y la posición del indicador de la zona táctil. Llama a este método durante el proceso de inicialización o conexión del lector. Puedes invocar esta función varias veces si necesitas ajustar la apariencia de la pantalla táctil durante la vida útil de tu aplicación. Este método solo afecta a la apariencia de la pantalla táctil, no afecta a la pantalla de recogida del PIN ni a la solicitud de pago simulada.

SettingsActivity.kt
Kotlin
Java
No results
val config = TapToPayUxConfiguration.Builder() .tapZone( TapToPayUxConfiguration.TapZone.Front(0.5f, 0.3f) ) .colors( TapToPayUxConfiguration.ColorScheme.Builder() .primary(TapToPayUxConfiguration.Color.Value(Color.parseColor("#FF008686"))) .success(TapToPayUxConfiguration.Color.Default) .error(TapToPayUxConfiguration.Color.Resource(android.R.color.holo_red_dark)) .build() ) .darkMode( TapToPayUxConfiguration.DarkMode.DARK ) .build() Terminal.getInstance().setTapToPayUxConfiguration(config)

Límites y alternativa de verificación del titular de la tarjeta

Algunas transacciones con tarjetas sin contacto por encima de ciertos importes pueden requerir métodos de verificación (CVM) del titular de la tarjeta adicionales, como la entrada de un PIN. Tap to Pay en Android admite la introducción de PIN en el SDK de Android de Terminal 4.3.0 o en una versión posterior.

El PIN se recopila en dos casos:

  1. El importe de la transacción supera el límite del método de verificación del titular de la tarjeta (CVM).

En este caso, el PIN se recopila antes de que collectPaymentMethod devuelva el resultado. El foco vuelve a la aplicación después de introducir el PIN o de cancelar la recopilación del PIN.

Flujo de PIN local de Tap to Pay en Android
  1. El emisor realiza una solicitud de autenticación reforzada de clientes (SCA).

En este caso, el PIN se recopila durante confirmPaymentIntent. El foco vuelve a tu aplicación después de confirmPaymentIntent, a menos que el emisor haga una solicitud de PIN. En ese caso, la recopilación del PIN vuelve a ser el foco hasta que se introduce el PIN o se cancela la recopilación del PIN.

Flujo de PIN de SCA de Tap to Pay en Android

Gestión de errores con el PIN

Solo puedes recoger el PIN bajo las siguientes condiciones:

  • Las opciones para desarrolladores están deshabilitadas.
  • Los servicios de accesibilidad no están registrados ni en funcionamiento.
  • La grabación en pantalla no está activa.
  • No hay ventanas de superposición de pantalla
  • Tienes una conexión a Internet activa.

La recopilación del PIN también falla si alguna de las partes intenta tomar una captura de pantalla.

Si la recopilación del PIN falla debido a uno de estos factores, recibirás un error TAP_TO_PAY_INSECURE_ENVIRONMENT con información adicional sobre la causa del error. Recomendamos que se indiquen los siguientes pasos para que el usuario vuelva a intentar el pago y se le pida un PIN.

Consideraciones sobre el PIN regional

Los pagos con monedero NFC (Apple Pay, Google Pay y Samsung Pay) no suelen requerir PIN. Sin embargo, en Reino Unido, Canadá y Finlandia, los requisitos regionales y las políticas de los emisores de tarjetas pueden afectar a los pagos sin contacto.

En el Reino Unido, según el emisor, la autenticación reforzada de clientes puede requerir que se inserten algunas tarjetas en un dispositivo. En estos casos, si la tarjeta no está insertada, el pago se rechaza antes de que aparezca la pantalla del PIN, con el motivo offline_pin_required.

En Canadá y Finlandia, muchas de las tarjetas emitidas solo tienen PIN fuera de línea, lo que significa que para introducir el PIN se requiere contacto físico, como la inserción en un dispositivo, algo que no es compatible con Tap to Pay.

En estas situaciones, recomendamos pedir al cliente que pruebe con otra tarjeta o cobrar el pago de otra forma. Por ejemplo, usando un lector de tarjetas Terminal o enviando un enlace de pago.

Al cobrar con tu dispositivo móvil, mantén la tarjeta junto al lector hasta que lea la información del chip. Es posible que tengas que esperar unos segundos después de la vibración inicial cuando la tarjeta haga contacto. En caso de rechazo, utiliza otro método para cobrar el pago, como un lector de tarjetas de Terminal. Solo puedes tener una conexión activa a un lector a la vez.

PIN UX

Por razones de seguridad, el teclado PIN no siempre aparece en el centro de la pantalla. Aparece en una posición determinada aleatoriamente.

Pantalla de recogida del PIN de Tap to Pay en Android

Es normal que el teclado PIN esté descentrado.

Prácticas recomendadas y directrices de la promoción

Garantiza una experiencia de usuario óptima teniendo en cuenta lo siguiente:

  • Conéctate al lector en segundo plano al iniciar la aplicación para reducir los tiempos de espera al cobrar un pago.
  • Utiliza la reconexión automática para volver a conectarte al lector cuando la aplicación aparezca en primer plano y reducir los tiempos de espera.
  • Proporciona formación a los comerciantes para orientar a tus usuarios sobre cómo aceptar pagos sin contacto en un dispositivo Android compatible, incluyendo la promoción dentro del producto y las alertas por mensaje de texto o correo electrónico.
  • Lanza y promociona tus campañas de marketing de Tap to Pay en Android utilizando nuestras plantillas de mensajes y recursos de diseño. Conviértete en socio de Stripe aquí para acceder a estos activos en el portal de socios.

Próximos pasos

  • Configura tu integración
¿Te ha sido útil la página?
SíNo
  • ¿Necesitas ayuda? Ponte en contacto con el equipo de soporte.
  • Echa un vistazo a nuestro registro de cambios.
  • ¿Tienes alguna pregunta? Ponte en contacto con el equipo de ventas.
  • ¿LLM? Lee llms.txt.
  • Con tecnología de Markdoc