Tap to Pay en el iPhone en tu app
El SDK de Tap to Pay de MONEI para iOS (MoneiTapToPay) permite que tu propia app iOS acepte pagos con tarjeta sin contacto con . El pago se ejecuta dentro de tu app, con tu propio permiso de Apple. MONEI procesa el pago y envía el resultado a tu app y a tu servidor.
Elige tu integración
MONEI Pay tiene dos formas de aceptar pagos con tarjeta desde tu propia app. Usa esta tabla para elegir.
| Tap to Pay en tu app (este SDK) | Integración app a app | |
|---|---|---|
| Dónde se ejecuta el pago | Dentro de tu app iOS | En la app MONEI Pay, que tu app abre |
| Plataformas | iPhone | iOS, Android, React Native y web |
| Permiso de Apple | Tu propio permiso de Tap to Pay en el iPhone | No es necesario |
| App MONEI Pay en el dispositivo | No es necesaria | Es necesaria |
| Servidor | Crea un token de autenticación POS con tu clave API | Crea un token de autenticación POS con tu clave API |
| Resultado fiable | Webhook firmado a tu callbackUrl | Webhook firmado a tu callbackUrl |
Elige Tap to Pay en tu app cuando el cliente debe quedarse en tu app y tu equipo puede obtener de Apple el permiso de Tap to Pay en el iPhone. Elige la integración app a app cuando también necesitas Android o web, o cuando no quieres solicitar el permiso de Apple.
Cómo funciona
- Tu servidor obtiene un de la API de MONEI con tu clave API. La clave API se queda en tu servidor.
- Tu servidor envía el token a tu app.
- Al iniciarse, tu app llama a
TapToPay.prepare(token:). El SDK prepara el lector en segundo plano. - Cuando el cliente paga, tu app llama a
TapToPay.acceptPayment(amount:orderId:callbackUrl:). - Apple muestra la pantalla de pago. El cliente acerca la tarjeta al iPhone.
- El SDK envía el pago a MONEI.
- MONEI procesa el pago.
acceptPaymentdevuelve unPaymentResultcon el estadoapprovedodeclined. - MONEI envía un webhook firmado con el resultado del pago a tu
callbackUrl. Este webhook es el único resultado fiable. Usa el resultado de la app solo para la interfaz.
Requisitos
- Un iPhone XS o posterior con iOS 18.5 o posterior. En otros dispositivos,
TapToPay.isSupportedesfalse. - Xcode 26.6 o posterior. Consulta versiones y compatibilidad.
- El permiso de Tap to Pay en el iPhone de Apple para tu equipo de desarrollo. Consulta Solicita el permiso de Apple.
- Tu Team ID de Apple y el bundle ID de cada app que acepta pagos, enviados a MONEI. Consulta Envía los datos de tu app a MONEI.
- Una cuenta de MONEI y su clave API. Una clave API del modo de prueba da tokens de prueba.
- Un servidor que crea los tokens y recibe el webhook firmado. Consulta Crea tokens en tu servidor.
Pasos de la integración
- Configura tu proyecto: el permiso de Apple, los datos de tu app, el paquete,
Info.plisty la integración continua. - Crea tokens en tu servidor: el endpoint del token, las tiendas y la renovación del token.
- Acepta pagos: prepara el lector, cobra un pago, lee el resultado y el webhook.
- Gestiona errores y resultados desconocidos: cada error y qué hacer cuando el resultado es desconocido.
- Prueba y pasa a producción: el modo de prueba, la app de ejemplo, las versiones y la lista de comprobación.
Preguntas frecuentes
¿Necesito la app MONEI Pay en el iPhone?
No. El SDK ejecuta Tap to Pay en el iPhone dentro de tu app. La app MONEI Pay solo es necesaria para la integración app a app.
¿Hay una versión para Android?
No. El SDK es solo para iPhone. En Android, usa la integración app a app.
¿Qué moneda puedo aceptar?
Euros. Indicas el importe en céntimos de euro, por ejemplo 1050 para 10,50 EUR.
¿Cómo obtengo acceso al SDK?
El paquete es público. Añádelo a tu proyecto sin una cuenta de GitHub. Consulta Añade el paquete. Para aceptar pagos, también necesitas:
- El permiso de Tap to Pay en el iPhone de Apple. Consulta Solicita el permiso de Apple.
- MONEI debe habilitar tu app. Envía a MONEI tu Team ID de Apple y el bundle ID de cada app que acepta pagos. Consulta Envía los datos de tu app a MONEI.
- Una cuenta de MONEI y su clave API.