Ver: obtener lista de tokens

Con el SDK de Push Provisioning, la aplicación del emisor puede recuperar la lista de tokens para una tarjeta específica y las ubicaciones donde se solicitaron esos tokens. El usuario final puede entonces navegar por la lista de tokens y ver:

• El estado del token (habilitado o deshabilitado).
• Identificador del solicitante de tokens.
• Información del dispositivo, como ID del dispositivo, nombre y tipo (cuando lo proporciona el TSP).
• Fecha de caducidad del token.
• Los últimos cuatro dígitos del token.
• Si el token está en el dispositivo actual (isOnCurrentDevice) cuando la aplicación del emisor está configurada para Google Pay, Samsung Pay o Apple Pay.

La figura siguiente muestra un ejemplo de la experiencia de usuario que la aplicación del emisor puede implementar:

Ejemplo de experiencia de usuario de la lista de tokens.

El SDK de Push Provisioning requiere la información de la tarjeta (PAN y fecha de caducidad) para recuperar la lista de tokens. La figura siguiente muestra una descripción general del flujo que la aplicación del emisor debe implementar:

Flujo para obtener la lista de tokens.

Nota

• Debido a limitaciones de la red de pagos, no puedes recuperar en tiempo real el nombre y el logotipo del solicitante de tokens.
• Recomendamos que la aplicación del emisor identifique los 5–10 principales identificadores de solicitantes de tokens y codifique de forma fija un nombre y logotipo orientados al comerciante o la cartera.

Integración del SDK

Paso 1: Obtención de los datos cifrados de la tarjeta

Para recuperar la lista de tokens, la aplicación del emisor debe proporcionar los datos cifrados de la tarjeta al SDK de Push Provisioning.

El backend del emisor proporciona los datos cifrados de la tarjeta a la aplicación del emisor. Los datos de la tarjeta usan el formato PKCS#7.

Paso 2: Obtención de la lista de tokens

Después de que la aplicación del emisor recupere los datos cifrados de la tarjeta desde el backend del emisor, puede solicitar la lista de tokens.

El siguiente fragmento de código muestra un ejemplo de cómo recuperar la lista de tokens mediante el SDK de Push Provisioning:

Swift

func getTokens() {
    let scheme = CardScheme.Mastercard
    let payload = "PKCS7 encrypted PAN"
    
    let card = FundingCard(scheme: scheme,
                           encryptedPayload: payload)
    
    TPCSDK.getTokens(card: card) {
      (tokenList, error) in
      if let tokenList = tokenList {
          for token in tokenList {
              if(token.isOnCurrentDevice){
                  // Este token está en el dispositivo actual.
              }
          }
      }
    }
  }

Objective-C

- (void) getTokens {
  CardScheme scheme = CardSchemeMastercard;
  NSString * payload = @"PKCS7 encrypted PAN";
  
  FundingCard * card = [[FundingCard alloc] initWithScheme:scheme
                                          encryptedPayload:payload];
  
  [TPCSDK getTokensWithCard:card
                 completion:^(NSArray<Token *> * _Nullable tokenList, NSError * _Nullable error) {
  }];
}

Android

CardInfo cardInfo = new CardInfo();
cardInfo.setScheme("VISA");
cardInfo.setEncryptedPayload("PAYLOAD")
cardInfo.setAuthorizationCode("AUTHORIZATION_CODE");
cardInfo.setLast4PanDigits("1234");
cardInfo.setIssuerAppId("ISSUERID");

final TPCSDKListener<Token[]> tokenListener = new TPCSDKListener<Token[]>() {
    @Override
    public void onStart() {
        // al iniciar
    }

    @Override
    public void onSuccess(TPCResult<Token[]> result) {
	      Log.i("TAG", "get tokenLsit request success");
        Token[] tokens = result.getResult();
        if (tokens != null) {
          for (int i = 0; i < tokens.length; i++) {
            if (tokens[i].isOnCurrentDevice()) {
              // Este token está en el dispositivo actual.
            }
          }
        }
    }

    @Override
    public void onError(TPCSDKException exception) {
        // Error al obtener la lista de tokens
        Log.i("TAG", "get tokenList request failed");
    }
};

TPCManager.getInstance().getTSHProxy().getTokenList(cardInfo, tpcsdkListener);