iOS

Recuperando registros del SDK de Push Provisioning

Puede recuperar registros usando la biblioteca de depuración del SDK de Push Provisioning. Haga esto en Console.app:

• Filtrar por TPCSDK en Console.app.
• En la Console.app ventana, asegúrese de que tanto Incluir mensajes de información y Incluir mensajes de depuración estén seleccionados, como se muestra a continuación.

Ejemplo de filtro y configuración de nivel de registro en `Console.app`.

Puede recuperar registros en el Entorno de Producción. Debe usar la biblioteca de depuración del SDK de Push Provisioning.

Recuperando registros de Apple Pay

1. Use el perfil de aprovisionamiento específico de Apple para los siguientes dispositivos:

   • iPhone: Perfil de aprovisionamiento iOS.
   • iWatch: Perfil de aprovisionamiento iWatch.
2. Una vez que la aplicación esté en ejecución, los registros pueden filtrarse usando el PassbookUIService proceso en Console.app.

Para más detalles, consulte Perfiles y registros de Apple Pay.

Errores del servidor

Si recibe un error relacionado con el servidor, puede ser posible obtener el ID de la solicitud API desde el TPCError requestId parámetro. Use este ID de solicitud cuando informe el problema al equipo de soporte.

Errores comunes

No se puede agregar la tarjeta usando el entorno sandbox

Causas posibles:

• El dispositivo no ha iniciado sesión con una cuenta iCloud de Sandbox.
• El PAN en uso no es un PAN de Sandbox. Para más detalles, consulte Pruebas de Apple Sandbox.

SDK de Push Provisioning getToken/getCardDigitizationResult La API aún devuelve nil/CardNotDigitized después del proceso de aprovisionamiento de la tarjeta.

Causas posibles:

• Para pruebas en el Entorno de Producción, pruebe en dispositivos de producción usando perfiles de aprovisionamiento Ad Hoc, TestFlight o la App Store (por ejemplo, mediante códigos promocionales), después de las aprobaciones requeridas.
• El perfil de aprovisionamiento no incluye los permisos correctos. Consulte esta guía para configurar los permisos.
• Los detalles de la aplicación del emisor pueden estar mal configurados en el sistema del operador de la red de pagos (PNO) (Visa y Mastercard). Según las especificaciones de Apple, configure los detalles de la aplicación del emisor en el sistema PNO usando el siguiente formato:

  • associatedApplicationIdentifiers: TeamId.BundleId
  • associatedStoreIdentifier: AdamId
  • appLaunchUrl: La URL de su aplicación.

La figura siguiente muestra dónde configurar Identificadores de aplicación/ADAM ID y URL de la aplicación en Mastercard.

Ejemplo de configuración de Mastercard para identificadores de aplicación y URL de la aplicación.

Tarjeta no agregada antes de los Términos y Condiciones

Ejemplo de error “tarjeta no agregada antes de los T&C”.

Vista de registros de ejemplo usada para solucionar fallos de aprovisionamiento.

Ingrese el SEID del dispositivo en la barra de búsqueda en la esquina superior derecha. Esto devuelve registros con solicitudes y respuestas. Revise la salida del registro y seleccione el request mensaje (como se muestra a continuación). El campo resaltado muestra datos para el mensaje seleccionado.

Para este caso de uso, valide encryptedPassData y ephemeralPublicKey. Estos son los datos enviados desde el dispositivo al servidor.

En la figura a continuación, también puede ver la solicitud/respuesta del archivo de registro. La respuesta del servidor se muestra en un formato más legible, con el código de error resaltado. La respuesta devuelve error 500, que es un error genérico. Las opciones de resolución se enumeran en la siguiente sección.

Respuesta: ...[Otros datos no registrados aquí]
{
   ...[Otros datos no registrados aquí]
}
{
   statusCode = 500;
   statusMessage = "Broker Service Response exception";
}

Ejemplo de respuesta de archivo de registro con el error del servidor resaltado.

Causas posibles:

• Error de criptografía, codificación de datos incorrecta o diccionario JSON inválido.

  Resuelva esto validando su implementación de criptografía y el formato de los datos.
• Lista blanca (Adam ID incorrecto está en la lista blanca)

  Esto se aplica solo a pruebas en el Entorno de Producción.

  • ¿El emisor ha solicitado la inclusión en la lista blanca del Adam ID de su aplicación?
  • Si es así, ¿el emisor está distribuyendo la aplicación del emisor a través de TestFlight? Para TestFlight, la compilación mínima compatible debe configurarse en iOS 10.3. Cuando la aplicación del emisor se compile para la App Store, puede volver a establecer la versión mínima de iOS compatible en iOS 9.0 o posterior.
• Problema con los recursos como los T&C y el arte de la tarjeta que se están cargando.

  Esto es poco probable. Normalmente ocurre en el Entorno de Preproducción, donde la configuración del portal de la red de pagos puede cambiar con frecuencia.

  Para descartar esto, intente agregar la tarjeta manualmente en Apple Wallet. Si ve los T&C, puede descartar este problema. Si el aprovisionamiento manual falla, contacte a su PNO y vuelva a subir sus T&C.

Tarjeta inelegible

Ejemplo de respuesta de tarjeta inelegible.

A diferencia del escenario “Tarjeta no agregada antes de los T&C”, el servidor responde con el código de estado 200, lo que significa que la solicitud se completó correctamente. Sin embargo, la respuesta indica que la tarjeta es inelegible (por ejemplo, eligibilityStatus=0).

{
   "Content-Length" = 57;
   "Content-Type" = "application/json";
   Date = "Tue, 21 May 2019 04:40:57 GMT";
   "x-conversation-id" = 086063f209b34b84bee028a75c6af0f2;
   ...[Otros datos no registrados aquí]
} 
{
   errorCode = 40403;
   ...[Otros datos no registrados aquí]
}

Este problema es causado por detalles de la tarjeta que no son elegibles para Apple Pay (por ejemplo, la tarjeta no está en la lista permitida por el PNO/emisor).

Verifique con su PNO que la tarjeta esté configurada correctamente.

El emisor rechaza el aprovisionamiento: respuesta de “flujo rojo”

Ejemplo de respuesta de “flujo rojo” mostrada al usuario final.

Un fallo después de que el usuario final acepta los T&C a menudo es causado por un rechazo por parte del emisor. Este rechazo está representado por una Respuesta roja.

Esto puede suceder si el emisor rechaza el intento, o si el PNO responde en nombre del emisor porque la respuesta tarda demasiado en procesarse. Los registros para este error típicamente muestran el código de error 40403. El dispositivo puede mostrar: “No se pudo agregar la tarjeta, inténtelo de nuevo más tarde o contacte a su emisor para más información”.

{
   "Content-Length" = 57;
   "Content-Type" = "application/json";
   Date = "Tue, 21 May 2019 04:40:57 GMT";
   "x-conversation-id" = 086063f209b34b84bee028a75c6af0f2;
   ...[Otros datos no registrados aquí]
} 
{
   errorCode = 40403;
   ...[Otros datos no registrados aquí]
}

El flujo rojo es devuelto por el PNO del emisor. Contacte a su PNO y proporcione el conversationID. El PNO puede usarlo para identificar la razón subyacente.

Tipo de tarjeta desconocido

Este error ocurre cuando el identificador de paquete es incorrecto. Apple recomienda cambiar el identificador de paquete. A continuación se muestra un ejemplo de error:

PassbookUIService         AMSCardEnrollmentEligibilityTask: [D72FE7E2] Intentando determinar el tipo de tarjeta para passTypeIdentifier: paymentpass.com.apple, serialNumber: nc.prod.cert_5395c9ae24b346e7ad08fcca25a46912

PassbookUIService         tcp_input [C127.1:3] flags=[F.] seq=1370165038, ack=1840204742, win=502 state=CLOSED rcv_nxt=1370165014, snd_una=1840204718

PassbookUIService         AMSCardEnrollmentEligibilityTask: [D72FE7E2] La tarjeta es un tipo desconocido de PKPaymentPass

PassbookUIService         PKNotifyCoalescer: no registrado para la notificación com.apple.NPKCompanionAgent.listener.resumed.

PassbookUIService         {public}<private>:0x282608f30 (0x282530a00): Cerrando la conexión existente

PassbookUIService         AMSCardEnrollmentEligibilityTask: [D72FE7E2] Tipo de tarjeta encontrado: 0

PassbookUIService         AMSURLRequestEncoder: [D72FE7E2] Codificando solicitud para URL: https://p19-buy.itunes.apple.com/account/stackable/applePay/silentEnroll/eligible {

                account = <ACAccount: 0x282d2e5a0 type = iTunesStore | backingID = BE105BB6-8208-4E56-AEA9-8615DE4C093F | username = [e-mail] | altDSID = 000014-10-8f1f9b5d-1c5e-4f41-b9e4-85ee3dc81e11 | DSID = 20100559835 | active = true | storefront = 143441-1,29>

                mediaType = com.apple.AppleMediaServices.accountmediatype.production

El aprovisionamiento push devuelve el código de estado 1

• PPROD: Las pruebas no se activan usando una cuenta de prueba Apple Sandbox. Consulte la Pruebas de Apple Sandbox página para los pasos de prueba en sandbox.
• PROD: La aplicación del emisor no está publicada en la App Store, lo que hace que Apple la restrinja.

A continuación se muestra un ejemplo del error:

//L_Stage[866:312743] [TPCSDK] ProvisionViewController addPaymentPassViewController: ephemeralPublicKey: BNEz67GTNp2YEtS/hkUDaMJh/zGjBVFbMMIYu5E4xsMoCgeCsR8Qy8A/YGnmXDCZVBpAzmhdrD+e3WpFswdU7e8=

2021-03-26 18:49:21.422819+0300 UCFS_TAS_HEEL_Stage[866:312743] [TPCSDK] ProvisionViewController addPaymentPassViewController: Crear solicitud

2021-03-26 18:49:32.050545+0300 UCFS_TAS_HEEL_Stage[866:311885] [TPCSDK] ProvisionViewController addPaymentPassViewController:didFinishAdding BEGIN

2021-03-26 18:49:32.056856+0300 UCFS_TAS_HEEL_Stage[866:311885] [TPCSDK] ProvisionViewController addPaymentPassViewController:didFinishAdding error: La operación no pudo completarse. (PKPassKitErrorDomain error 1.)

El flujo se inicia correctamente para TSH pero MasterCard no recibe el push. En los registros del dispositivo el error

El aprovisionamiento push devuelve el código de estado 403

Este error ocurre cuando el flujo de aprovisionamiento push es rechazado por el backend del emisor, pero el flujo por lo demás tiene éxito (flujo rojo). Los detalles del error se muestran a continuación:

[PassbookUIService error] Código de estado recibido 403.

El aprovisionamiento push devuelve 500

Este error ocurre cuando la cuenta de prueba Apple Sandbox no está configurada en el dispositivo de prueba.

A continuación se muestra un ejemplo del error:

{ 
  "Content-Length" = 49; 
  "Content-Type" = "application/json"; 
  Date = "Fri, 21 May 2021 14:06:16 GMT"; 
  Vary = "accept-language"; 
  "x-conversation-id" = 8a7e25b542b34cc9a4077fb411c1b2eb;
  "x-envoy-upstream-service-time" = 625; 
  "x-pod" = "crt-pod1"; 
  "x-pod-region" = "paymentpass.com.apple"; 
} 
{ 
  errorCode = 40456; 
  statusCode = 500; 
}