Requisitos de la API del SDK

Resumen

La mayoría de las API del SDK de NFC Wallet requieren un Android Contexto.

Algunas API también requieren que la inicialización del SDK de NFC Wallet se haya completado.

Utilice esta página para entender qué sucede si llama a una API demasiado pronto.

Definiciones de requisitos previos

• Configuración del SDK: el SDK tiene un Android Contexto.

  • Esto está disponible después de llamar a SDKInitializer.INSTANCE.configure(...).
  • Esto también está disponible después de iniciar SDKInitializer.INSTANCE.initialize(...).
• Inicialización del SDK: SDKInitializer.INSTANCE.initialize(...) se completó correctamente.

Consulte Inicialice el SDK de NFC Wallet.

Algunas API pueden lanzar excepciones en tiempo de ejecución (por ejemplo: NullPointerException) si faltan los requisitos previos.

DigitalizedCardManager

API	Requiere configuración del SDK	Requiere inicialización del SDK	Si faltan los requisitos previos
getAllCards	Requerido	No requerido	Devuelve DigitalizedCardErrorCodes.NULL_CONTEXT con un String[].
getDefault	Requerido	No requerido	Devuelve DigitalizedCardErrorCodes.NULL_CONTEXT con un String.
getDigitalizedCardId	Requerido	No requerido	Devuelve null.
getTokenizedCardId	Requerido	No requerido	Devuelve null.
unsetDefaultCard	Requerido	Requerido	Devuelve DigitalizedCardErrorCodes.SDK_NOT_INITIALIZED y no realiza la operación.
getTokenSyncSchedule	Requerido	Requerido	Lanza NullPointerException.
isTokenSyncAllowed	Requerido	Requerido	Lanza NullPointerException.
invokeTokenSync	Requerido	Requerido (Mobile Gateway inicializado)	Lanza IllegalStateException si CPS no está inicializado. Devuelve TokenSyncErrorCode.TOKEN_SYNC_ERROR_SDK_NOT_INITIALIZED si Mobile Gateway no está inicializado.

DigitalizedCard

API	Requiere configuración del SDK	Requiere inicialización del SDK	Si faltan los requisitos previos
getCardDetails	Requerido	No requerido	Devuelve DigitalizedCardErrorCodes.NULL_CONTEXT con null.
getCardState	Requerido	No requerido	Devuelve DigitalizedCardErrorCodes.NULL_CONTEXT con null.
isDefault	Requerido	No requerido	Devuelve DigitalizedCardErrorCodes.NULL_CONTEXT con falso.
setDefault	Requerido	Requerido	Devuelve DigitalizedCardErrorCodes.SDK_NOT_INITIALIZED y no realiza la operación.
isMultiAids	Requerido	No requerido	Devuelve falso.
hasAuxiliaryScheme	Requerido	No requerido	Devuelve falso.
getAllAids	Requerido	No requerido	Devuelve un ArrayList.
updateAidList	Requerido	No requerido	No realiza la operación.

PaymentBusinessService

API	Requiere configuración del SDK	Requiere inicialización del SDK	Si faltan los requisitos previos
activar	Requerido	Requerido	Devuelve el errorCode: PaymentServiceErrorCode.PAYMENT_NOT_ALLOWED_SDK_NOT_INITIALIZED.
startAuthentication	Requerido	Requerido	Devuelve el errorCode: PaymentServiceErrorCode.PAYMENT_NOT_ALLOWED_SDK_NOT_INITIALIZED.
getAuthenticationFlowPriorToPayment	Requerido	Requerido	Devuelve el errorCode: PaymentServiceErrorCode.PAYMENT_NOT_ALLOWED_SDK_NOT_INITIALIZED.
generateQRCodePaymentData	Requerido	Requerido	Devuelve el errorCode: PaymentServiceErrorCode.PAYMENT_NOT_ALLOWED_SDK_NOT_INITIALIZED.
generateApplicationCryptogram	Requerido	Requerido	Devuelve el errorCode: PaymentServiceErrorCode.PAYMENT_NOT_ALLOWED_SDK_NOT_INITIALIZED.
deactivate	Requerido	Requerido	No realiza la operación.

EnrollingBusinessService

API	Requiere configuración del SDK	Requiere inicialización del SDK	Si faltan los requisitos previos
isEnrolled	Requerido	No requerido	Devuelve EnrollmentStatus.ENROLLMENT_NEEDED.
continueEnrollment	Requerido	Requerido	Devuelve ProvisioningServiceErrorCodes.NULL_CONTEXT si falta la configuración del SDK. Devuelve ProvisioningServiceErrorCodes.SDK_NOT_INITIALIZED si falta la inicialización.
enroll	Requerido	Requerido	Devuelve ProvisioningServiceErrorCodes.NULL_CONTEXT si falta la configuración del SDK. Devuelve ProvisioningServiceErrorCodes.SDK_NOT_INITIALIZED si falta la inicialización.

ProvisioningBusinessService

API	Requiere configuración del SDK	Requiere inicialización del SDK	Si faltan los requisitos previos
processIncomingMessage	Requerido	Requerido	Devuelve el errorCode: ProvisioningServiceErrorCodes.SDK_NOT_INITIALIZED.
sendActivationCode	Requerido	No requerido	Devuelve el errorCode: ProvisioningServiceErrorCodes.NULL_CONTEXT.
sendRequestForReplenishment	Requerido	No requerido	Devuelve el errorCode: ProvisioningServiceErrorCodes.NULL_CONTEXT.
updatePushToken	Requerido	No requerido	Devuelve el errorCode: ProvisioningServiceErrorCodes.NULL_CONTEXT.
getAccessToken	Requerido	No requerido	Devuelve el errorCode: ProvisioningServiceErrorCodes.NULL_CONTEXT.
sendRequestForODACertificateRenewal	Requerido	No requerido	Devuelve el errorCode: ProvisioningServiceErrorCodes.NULL_CONTEXT.

WalletSecureEnrollmentService

API	Requiere configuración del SDK	Requiere inicialización del SDK	Si faltan los requisitos previos
getState	Requerido	No requerido	Devuelve null.
startWalletSecureEnrollment	Requerido	Requerido (Mobile Gateway inicializado)	Devuelve WalletSecureEnrollmentErrorCodes.WSE_CPS_COMPONENT_NOT_INITIALIZED o WalletSecureEnrollmentErrorCodes.WSE_MG_COMPONENT_NOT_INITIALIZED.