Android

Paso 1: Mostrando el botón Agregar a Wallet

Su aplicación emisora utiliza el SDK de Push Provisioning para comprobar si la xPay Wallet de destino es compatible con el dispositivo y si ya existe un token para la tarjeta. Según el resultado, muestra u oculta el Agregar a Wallet botón.

Siga estas directrices de marca de billetera para usar Agregar a Wallet en su aplicación emisora:

• Google Pay https://developers.google.com/pay/api/android/guides/brand-guidelines
• Samsung Pay https://pay.samsung.com/developers/resource/brand
• Huawei Pay El soporte está disponible sólo para esquemas nacionales.

  Advertencia

  • Huawei Pay no es compatible con redes de pago internacionales (por ejemplo, Mastercard y Visa). Sólo nacionales los esquemas pueden ser compatibles en casos específicos. Consulte con Thales las condiciones de uso.
  • A partir del 10 de junio de 2024, Google Wallet requiere Android 9 o superior.

Usando los últimos cuatro dígitos del PAN, la aplicación emisora puede recuperar el token de una tarjeta que ya está provisionada en una wallet del dispositivo (Samsung Pay y Google Pay para Android).

Cada token incluye:

• El ID del token.
• Los últimos cuatro dígitos de la tarjeta digital (DPAN).
• El estado del token (estado de digitalización).

Android 1.7.0+

OEMPayType type = OEMPayType.GOOGLE_PAY; // o OEMPayType.SAMSUNG_PAY
GetTokenInput input = new GetTokenInput("1234"); // últimos cuatro dígitos de la tarjeta física (FPAN)
PushProvisioning pushProvisioning = TPCManager.getInstance().getPushProvisioning(type);
pushProvisioning.getToken(input, new TPCSDKListener<Token>() {
    @Override
    public void onStart() {
    }
    @Override
    public void onSuccess(TPCResult<Token> result) {
        //El token puede recuperarse usando result.getResult().
        //result.getResult() devolverá null si la wallet OEM no tiene un token correspondiente.
        //El estado del token se usa como sigue:
        if(result.getResult()==null || TextUtils.isEmpty(result.getResult().getState())){
            //La API no devolvió un token.
            //Muestra el botón "Agregar a GPay/SPay".
        }else{
            Token token = result.getResult();
            if(type==OEMPayType.GOOGLE_PAY){
                //Para Google Pay.
                try {
                    int tokenState = Integer.parseInt(token.getState());
                    switch (tokenState){
                        case CardDigitizationStatus.GOOGLE_PAY_TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION:
                            // Consulte la gestión del ciclo de vida del token para la acción Activar.
                            // la tarjeta está pendiente de ID&V. 
                            break;
                        case CardDigitizationStatus.GOOGLE_PAY_TOKEN_STATE_PENDING:
                        case CardDigitizationStatus.GOOGLE_PAY_TOKEN_STATE_SUSPENDED:
                        case CardDigitizationStatus.GOOGLE_PAY_TOKEN_STATE_ACTIVE:
                            //La tarjeta ya está añadida.
                            break;
                        case CardDigitizationStatus.GOOGLE_PAY_TOKEN_STATE_UNTOKENIZED:
                            //Mostrar el botón "Agregar a GPay".
                            break;
                    }
                } catch (NumberFormatException e) {
                    //Gestiona la excepción.
                }
            }else if(type==OEMPayType.SAMSUNG_PAY){
                //Para Samsung Pay.
                String tokenState = token.getState();
                switch (tokenState){
                    case CardDigitizationStatus.SAMSUNG_PAY_PENDING_PROVISION:
                        // Consulte la gestión del ciclo de vida del token para la acción Activar.
                        // la tarjeta está pendiente de ID&V
                        break;
                    case CardDigitizationStatus.SAMSUNG_PAY_ACTIVE:
                    case CardDigitizationStatus.SAMSUNG_PAY_EXPIRED:
                    case CardDigitizationStatus.SAMSUNG_PAY_PENDING_ENROLLED:
                    case CardDigitizationStatus.SAMSUNG_PAY_SUSPENDED:
                    case CardDigitizationStatus.SAMSUNG_PAY_PENDING_ACTIVATION:
                        //La tarjeta ya está añadida.
                        break;
                    case CardDigitizationStatus.SAMSUNG_PAY_DISPOSED:
                        //Muestra el botón "Agregar a SPay".
                        break;
                }
            }
        }
    }
    @Override
    public void onError(TPCSDKException exception) {
        // específico para Samsung Pay
        Throwable exceptionCause = exception.getCause();
        if (exceptionCause != null && exceptionCause instanceof TPCSpayException) {
            // obtener más detalles del error para Samsung Pay
            TPCSpayException spayException = (TPCSpayException) exceptionCause;
        }
    }
});

Android 1.6.0-

CardInfo cardInfo = new CardInfo();
cardInfo.setScheme(scheme);
cardInfo.setEncryptedPayload(encryptedPayload);
cardInfo.setLast4PanDigits(last4DigitsOfPAN); // Sólo para Samsung Pay

TPCManager.getInstance().getPushProvisioning()
	.isCardDigitized(cardInfo, new TPCSDKListener<CardDigitizationStatus>() {
    @Override
    public void onStart() {
        //Al inicio 
    }

    @Override
    public void onSuccess(TPCResult<CardDigitizationStatus> result) {
        if (result != null) {
          	CardDigitizationStatus digitizedStatus = result.getResult();

            if (digitizedStatus.getOemPayType() == OEMPayType.GOOGLE_PAY) {
                int cardState = digitizedStatus.getGpayDigitizationStatus();
                String tokenReferenceId = digitizedStatus.getTokenReferenceId();

                if (cardState == CardDigitizationStatus.GOOGLE_PAY_TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION)
                    // la tarjeta está pendiente de ID&V
                } else if (cardState == CardDigitizationStatus.CARD_IS_NOT_DIGITIZED) {
                    // tarjeta no añadida
                } else {
                    // tarjeta añadida
                }
            }
          
            if (digitizedStatus.getOemPayType() == OEMPayType.HUAWEI_PAY) {
                Boolean isCardDigitized = cardDigitizationStatus.getHpayDigitizationStatus();
                String hPayDeviceId = cardDigitizationStatus.getHPayDeviceId();
            }
            
          	if (digitizedStatus.getOemPayType() == OEMPayType.SAMSUNG_PAY) {
                String cardState = digitizedStatus.getSpayDigitizationStatus(); 
            }
        }
    }

    @Override
    public void onError(TPCSDKException exception) {
        Log.e("TAG", "Error en el estado de digitalización de la tarjeta");
    }
});

Para Google Pay, el estado del token es el siguiente:

Estado de Google Pay	Descripción
GOOGLE_PAY_TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION	La tarjeta está digitalizada, pendiente de ID&V.
GOOGLE_PAY_TOKEN_STATE_PENDING	La tarjeta está digitalizada.
GOOGLE_PAY_TOKEN_STATE_SUSPENDED	La tarjeta está digitalizada.
GOOGLE_PAY_TOKEN_STATE_ACTIVE	La tarjeta está digitalizada.
GOOGLE_PAY_TOKEN_STATE_UNTOKENIZED	La tarjeta no está digitalizada.
CARD_IS_NOT_DIGITIZED	La tarjeta no está digitalizada.

Para Samsung Pay, el estado del token es el siguiente:

Estado de Samsung Pay	Descripción
SAMSUNG_PAY_PENDING_PROVISION	La tarjeta está digitalizada, pendiente de ID&V.
SAMSUNG_PAY_ACTIVE	La tarjeta está digitalizada.
SAMSUNG_PAY_EXPIRED	La tarjeta está digitalizada.
SAMSUNG_PAY_PENDING_ENROLLED	La tarjeta está digitalizada.
SAMSUNG_PAY_PENDING_ACTIVATION	La tarjeta está digitalizada.
SAMSUNG_PAY_SUSPENDED	La tarjeta está digitalizada.
SAMSUNG_PAY_DISPOSED	La tarjeta no está digitalizada.

Precaución

• Para Google Pay, si la tarjeta aún aparece como NO_DIGITIZADA después de la digitalización, compruebe que la aplicación emisora está configurada correctamente en el portal TSP.
• Para Samsung Pay, algunos emisores deben registrar múltiples NOMBRE DEL EMISOR valores en el portal. Esto depende de la aplicación emisora y/o de los requisitos del TSP. Asegúrese de que el NOMBRE DEL EMISOR valor en la API coincide con el valor registrado en el portal. La API devuelve sólo coincidencias exactas.
• El getToken La API no es compatible con Huawei Pay. Use isCardDigitized para comprobar el estado de digitalización.

Paso 2: Provisionar una solicitud

En Android, el resultado de éxito varía según OEMPayType. Para Google Pay, el SDK devuelve un ID de token. Para Samsung Pay, devuelve un Card objeto. Para Huawei Pay, devuelve un booleano.

Nota

Desde TPC SDK v1.9.0, el push provisioning de Google Pay puede usar la nueva API: addCard(Activity activity, CardInfo cardInfo, TPCSDKListener<T> listener).

CardInfo cardInfo = new CardInfo();
cardInfo.setScheme(scheme);
cardInfo.setEncryptedPayload(encryptedPayload);
cardInfo.setAuthorizationCode(authorizationCode);
cardInfo.setLast4PanDigits("1234"); // Establece los últimos cuatro dígitos del PAN.
cardInfo.setIssuerAppId("TPC_ISSUER"); // ID de emisor de prueba.
cardInfo.setCardType("DEBIT"); // Sólo para Samsung Pay
cardInfo.setProductId("PRODUCTID"); // Sólo para esquemas nacionales. Recupérelo del CMS del emisor.

UserDetails userDetails = new UserDetails();
userDetails.setAddress1("Línea de dirección 1");
userDetails.setAddress2("Línea de dirección 2");
userDetails.setAdministrativeArea("estado");
userDetails.setLocality("nombre de la ciudad");			// nombre de la ciudad o pueblo
userDetails.setCountryCode("SG");					// Establecer el código de país.
userDetails.setPostalCode("828126"); 			// Establecer el código postal.
userDetails.setPhoneNumber("123456789"); 	// Establecer el número de teléfono.
userDetails.setName("nombre");							// Establecer el nombre de la persona en la dirección.
cardInfo.setUserDetails(userDetails);

//Desde TPC SDK V1.9.0
Activity activity;

PushProvisioning pushProvisioning = TPCManager.getInstance().getPushProvisioning();

TPCSDKListener<String> addCardListenerGPay = new TPCSDKListener<String>() {
        @Override
        public void onStart() {
            // hacer algo
        }

        @Override
        public void onSuccess(TPCResult<String> result) {
            Log.i("TAG", "Push Provision exitoso con resultado : " + result.getResult());
        }

        @Override
        public void onError(TPCSDKException exception) {
            Log.e("TAG", "Push Provision falló. Error : " + exception.getMessage());
        }
}

TPCSDKListener<Card> addCardListenerSPay = new TPCSDKListener<Card>() {
        @Override
        public void onStart() {
            // hacer algo
        }

        @Override
        public void onSuccess(TPCResult<Card> result) {
            Card card = (Card)result.getResult();
            Log.d(TAG, "last4FPan: " + card.getLast4FPAN() +
                             "\nlast4DPan:" + card.getLast4DPAN() +
                             "\nApp2AppPayLoad: " + card.getApp2AppPayLoad() +
                             "\ntype: " + card.getType() +
                             "\nissuerName: " + card.getIssuerName() +
                             "\nid: " + card.getId() +
                             "\nstate: " + card.getState() +
                             "\nscheme: " + card.getCardScheme());
        }

        @Override
        public void onError(TPCSDKException exception) {
            Log.e("TAG", "Push Provision falló. Error : " + exception.getMessage());
            if (exception.getExceptionType() == TPCSDKExceptionType.TPC_SPAY_APP_NEED_TO_UPDATE) {
                // Mostrar una interfaz de actualización de Samsung Pay
                pushProvisioning.updateSamsungPay();
            } else if (exception.getExceptionType() == TPCSDKExceptionType.TPC_SPAY_APP_SETUP_NOT_COMPLETED) {
                // Mostrar una interfaz de activación de Samsung Pay
                pushProvisioning.activateSamsungPay();
            } 
            Throwable exceptionCause = exception.getCause();
            if (exceptionCause != null && exceptionCause instanceof TPCSpayException) {
                // obtener más detalles del error para Samsung Pay
                TPCSpayException spayException = (TPCSpayException) exceptionCause;
            }
        }
};

TPCSDKListener<Boolean> addCardListenerHPay = new TPCSDKListener<Boolean>() {
        @Override
        public void onStart() {
            // hacer algo
        }

        @Override
        public void onSuccess(TPCResult<Boolean> result) {
            Log.i("TAG", "Push Provision exitoso");
        }

        @Override
        public void onError(TPCSDKException exception) {
            Log.e("TAG", "Push Provision falló. Error : " + exception.getMessage());
        }
};

TPCSDKListener addCardListener = null;
switch (oemPayType) {
    case OEMPayType.GOOGLE_PAY:
        addCardListener = addCardListenerGPay;
        break;
    case OEMPayType.SAMSUNG_PAY:
        addCardListener = addCardListenerSPay;
        break;
    case OEMPayType.HUAWEI_PAY:
        addCardListener = addCardListenerHPay;
        break;
}

try {
  if (oemPayType == OEMPayType.GOOGLE_PAY) {
    // Desde TPC SDK V1.9.0
    pushProvisioning.addCard(activity, cardInfo, addCardListener);
  } else {
    pushProvisioning.addCard(cardInfo, addCardListener);
  }
} catch (TPCSDKException e) {
    e.printStackTrace();
}

// Cuando la aplicación emisora recibe onActivityResult del SDK de Google Pay, páselo al SDK para manejar el resultado.
@Override
public void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    pushProvisioning.handleWalletResult(requestCode, resultCode, data);
}

// Cuando la aplicación emisora recibe onNewIntent de Huawei Pay, pase el intent al SDK para manejar el resultado.
@Override
protected void onNewIntent(Intent intent) {
    pushProvisioning.handleWalletResult(intent);
}