Control: operación del ciclo de vida

Después de que la aplicación del emisor realiza la verificación del consumidor, puede actualizar el estado de un token (suspender, reanudar, eliminar o activar). El SDK de Provisionamiento Push permite a la aplicación del emisor gestionar esta solicitud. El SDK envía la solicitud al TSH y luego directamente al TSP.

Ver Código de autorización (formato JWT) para el Código de autorización requerido para este proceso. El sub claim debe ser la referencia del token.

Nota

• El SDK de Provisionamiento Push no verifica si una operación de ciclo de vida determinada está permitida para un token.

• La aplicación del emisor podría necesitar validar el estado del token antes de invocar una operación. Por ejemplo, la acción Activar requiere un token en el PENDING_IDV estado.

  • Apple Pay: requiresActivation estado.

  • Google Pay: GOOGLE_PAY_TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION

  • Samsung Pay: SAMSUNG_PAY_PENDING_PROVISION

iOS

// relevante solo en caso de que SCHEME sea VISA, para MASTERCARD deje la cadena vacía
let tokenRequestorId = "40010030273" // Apple Pay para Visa

let scheme = "SCHEME" // VISA, MASTERCARD, AMEX
let authorizationCode = "<JWT>" // proporcione el valor JWT relacionado con la tarjeta concreta, obtenido del backend del emisor
let tokenId = pass.secureElementPass?.deviceAccountIdentifier // también puede obtenerse de: `Token.id`

TPCSDK.updateTokenState(tokenId: tokenId,
                        tokenRequestorId: tokenRequestorId,
                        schemeString: scheme,
                        authorizationCode: authorizationCode,
                        action: .Activate) { success, error in
    if let error = error {
      // manejar Error TPC
    } else if success {
      // por hacer: actualizar la IU para indicar el estado de la digitalización de la tarjeta
    }
}

Android

// relevante solo en caso de que SCHEME sea VISA, para MASTERCARD deje la cadena vacía
String tokenRequestorId = "40010075001"; // para Google Pay o "40010043095" para Samsung Pay

String tokenId = "tokenId";
String scheme = "SCHEME"; // VISA, MASTERCARD
String authorizationCode = "<JWT>"; // proporcione el valor JWT relacionado con la tarjeta concreta, obtenido del backend del emisor

TPCManager.getInstance().getTSHProxy().updateTokenState(tokenId,
        tokenRequestorId,
        scheme,
        authorizationCode,
        TokenAction.ACTIVATE,
        new TPCSDKListener<Boolean>() {
            @Override
            public void onStart() {
                // al iniciar
            }

            @Override
            public void onSuccess(TPCResult<Boolean> result) {
                Log.i(TAG, "Estado del token actualizado");
                Boolean status = result.getResult();

                // TODO: actualizar la IU para el nuevo estado
            }

            @Override
            public void onError(TPCSDKException exception) {
                Log.e("TAG", "Error en la solicitud updateTokenState = " + exception.getMessage());
            }
        });