1. Comprobar requisitos previos

Requisitos

Cumple estos requisitos antes de crear y validar el pago sin contacto:

• Dispositivo y sistema operativo: iOS 17.4 o posterior en un dispositivo compatible con NFC.
• Cuenta de Apple: Un Apple ID registrado en el Espacio Económico Europeo (EEE).
• Capacidad: Apple concede la capacidad HCE.

  • Actualiza la configuración de tu proyecto de Xcode.
  • Actualiza las capacidades .plist.
  • Actualizar Info.plist para incluir la capacidad y los metadatos requeridos.
  • Para obtener más detalles, consulta Configurar y habilitar la capacidad en Xcode en entitlement de Apple HCE.
• Ubicación (pruebas):

  • Para iOS 17.4 hasta iOS 18.1, debes encontrarte físicamente en el EEE para validar el pago sin contacto.
  • Para versiones posteriores de iOS, consulta Requisito de prueba en entitlement de Apple HCE.

Cuando envíes a Apple la solicitud de la capacidad HCE, incluye la lista completa de AID compatibles.

Asegúrate de incluir el AID de PPSE:

• 2PAY.SYS.DDF01 ("325041592E5359532E4444463031" en formato hexadecimal)

Antes de iniciar el pago sin contacto

Comprueba la compatibilidad con pagos sin contacto

Antes de solicitar permiso, confirma que el dispositivo admite el pago sin contacto. Sigue Comprueba la compatibilidad con pagos sin contacto.

Solicitar permiso

Tu aplicación de cartera digital debe solicitar el Sin contacto y NFC permiso. La experiencia del usuario final es:

Mensaje de iOS para el permiso de Sin contacto y NFC.

Después del mensaje, el usuario final puede administrar el permiso en Ajustes > tu aplicación emisora > Sin contacto y NFC.

Usa el siguiente código para solicitar permiso:

let contactlessPaymentSession = ContactlessPaymentSession()
do {
  try await contactlessPaymentSession.requestAuthorization()
} catch ContactlessPaymentSession.Error.permissionNotAccepted(let reason) {
  // Permiso no concedido.
} catch {
  // otros errores debidos a la elegibilidad del dispositivo
}

Solicita el Sin contacto y NFC permiso cuando el usuario final aprovisiona su primera tarjeta digital.

Si el usuario final rechaza el permiso, la aplicación emisora no puede realizar pagos sin contacto.