1. Comprobar requisitos previos

Requisitos

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

• Dispositivo y SO: iOS 17.4 o posterior en un dispositivo con capacidad NFC.

• Cuenta de Apple: Una Apple ID registrada en el Área Económica Europea (AEE).

• Derecho/entitlement: Apple concede el entitlement HCE.

  • Actualice la configuración de su proyecto Xcode.

  • Actualice los entitlements .plist.

  • Actualizar Info.plist para incluir el entitlement y los metadatos requeridos.

  • Para más detalles, consulte Configurar y habilitar el entitlement en Xcode en Entitlement HCE de Apple.

• Ubicación (pruebas):

  • Para iOS 17.4 a iOS 18.1, debe encontrarse físicamente en la AEE para validar el pago sin contacto.

  • Para versiones posteriores de iOS, vea Requisito de pruebas en Entitlement HCE de Apple.

Cuando envíe la solicitud de entitlement HCE a Apple, incluya la lista completa de AIDs compatibles.

Asegúrese de incluir el AID PPSE:

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

Antes de iniciar el pago sin contacto

Comprobar la capacidad sin contacto

Antes de solicitar permiso, confirme que el dispositivo admite el pago sin contacto. Siga Comprobar la capacidad sin contacto.

Solicitar permiso

Su aplicación de billetera digital debe solicitar el permiso Contactless & NFC El flujo de experiencia del usuario final es:

Aviso de iOS para el permiso Contactless & NFC.

Después del aviso, el usuario final puede gestionar el permiso en Ajustes > su aplicación del emisor > permiso Contactless & NFC.

Use el siguiente código para solicitar el 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
}

Solicite el permiso Contactless & NFC permiso cuando el usuario final proporcione su primera tarjeta digital.

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