Mostrar metadatos de la tarjeta

Resumen

Esta sección describe cómo mostrar los datos de la tarjeta no sensibles en la aplicación del emisor.

Experiencia del usuario

Diagrama de secuencia

Requisitos previos:

El usuario final y las tarjetas están registrados en el backend de D1.
El SDK de D1 está correctamente inicializado.
La aplicación del emisor llamó a la API de inicio de sesión (login) del SDK de D1.

Basado en el cardID valor, la aplicación del emisor puede mostrar la información básica de la tarjeta al usuario final, como los últimos cuatro dígitos del PAN, la fecha de caducidad, el fondo de la imagen de la tarjeta, y así sucesivamente.

El SDK de D1 expone la pública getCardMetaData() API para obtener la información de la tarjeta. La CardMetadata.cardAssetArray() API para iOS y la CardMetadata.getAssetList() API para Android se proporcionan para recuperar el recurso (asset) de la tarjeta.

Para una tarjeta emitida por D1, información adicional de la tarjeta como “State Reason” y “Ongoing Operation” puede obtenerse usando las APIs CardMetadata.getStateReason() y CardMetadata.getOngoingOperation().

La lista de tarjetas puede obtenerse con la getCardList() operación.

String cardID = ""; // id de la tarjeta recibido desde el backend
D1Task.Callback<CardMetadata> callback = new D1Task.Callback<CardMetadata>() {
    @Override
    public void onSuccess(CardMetadata cardMetadata) {
        // Últimos 4 dígitos del PAN
        String last4Pan = cardMetadata.getLast4Pan();

        StateReason reason = cardMetadata.getStateReason();
        OngoingOperation ongoingOperation = cardMetadata.getOngoingOperation();

        // CardAsset se usa para mostrar el arte (Artwork) de la tarjeta
        cardMetadata.getAssetList(new D1Task.Callback<List<CardAsset>>() {
            @Override
            public void onSuccess(List<CardAsset> cardAssets) {
                // Continúa con la lógica de la aplicación                                    
            }
            @Override
            public void onError(@NonNull D1Exception e) {
                // Maneja el error. Por ejemplo, regístralo, muéstralo, etc. 
            }
        });
    }

    @Override
    public void onError(D1Exception exception) {
        // Consulta la sección Integración del SDK D1 – Gestión de errores.
    }
};

d1Task.getCardMetadata(cardID, callback);

let cardID = "" // Obtenido, por ejemplo, desde el servidor.
d1Task.cardMetadata(cardID) { cardMetadata, error in
    if let error = error {
        // Consulta la sección Integración del SDK D1 – Gestión de errores.
    } else if let cardMetadata = cardMetadata {
        // Continúa con los flujos posteriores. Por ejemplo, actualiza la interfaz de usuario.
        print("Scheme: \(cardMetadata.cardScheme.rawValue)")
        print("State: \(cardMetadata.cardState.rawValue)")
        print("Exp: \(cardMetadata.cardExpiry)")
        print("Last4: **** **** **** \(cardMetadata.cardLast4)")

        print("reason: \(cardMetadata.reason.rawValue)")
        print("Ongoing operation: \(cardMetadata.ongoingOperation.rawValue)")

        // Por ejemplo, muestra el primer recurso (artwork) de la tarjeta.
        cardMetadata.cardAssetArray { assets, error in
            if let cardAssetContent = assets?.first?.contentArray.first,
               let cardImageData = Data(base64Encoded: cardAssetContent.encodedData, options: .ignoreUnknownCharacters) {
                let image = UIImage.init(data: cardImageData)
            }
        }
    }
}

AnteriorImplementar la visualización segura de tarjetas SiguienteMostrar detalles de la tarjeta

Última actualización hace 3 meses

¿Te fue útil?

String cardID = ""; // id de la tarjeta recibido desde el backend
D1Task.Callback<CardMetadata> callback = new D1Task.Callback<CardMetadata>() {
    @Override
    public void onSuccess(CardMetadata cardMetadata) {
        // Últimos 4 dígitos del PAN
        String last4Pan = cardMetadata.getLast4Pan();

        StateReason reason = cardMetadata.getStateReason();
        OngoingOperation ongoingOperation = cardMetadata.getOngoingOperation();

        // CardAsset se usa para mostrar el arte (Artwork) de la tarjeta
        cardMetadata.getAssetList(new D1Task.Callback<List<CardAsset>>() {
            @Override
            public void onSuccess(List<CardAsset> cardAssets) {
                // Continúa con la lógica de la aplicación                                    
            }
            @Override
            public void onError(@NonNull D1Exception e) {
                // Maneja el error. Por ejemplo, regístralo, muéstralo, etc. 
            }
        });
    }

    @Override
    public void onError(D1Exception exception) {
        // Consulta la sección Integración del SDK D1 – Gestión de errores.
    }
};

d1Task.getCardMetadata(cardID, callback);

let cardID = "" // Obtenido, por ejemplo, desde el servidor.
d1Task.cardMetadata(cardID) { cardMetadata, error in
    if let error = error {
        // Consulta la sección Integración del SDK D1 – Gestión de errores.
    } else if let cardMetadata = cardMetadata {
        // Continúa con los flujos posteriores. Por ejemplo, actualiza la interfaz de usuario.
        print("Scheme: \(cardMetadata.cardScheme.rawValue)")
        print("State: \(cardMetadata.cardState.rawValue)")
        print("Exp: \(cardMetadata.cardExpiry)")
        print("Last4: **** **** **** \(cardMetadata.cardLast4)")

        print("reason: \(cardMetadata.reason.rawValue)")
        print("Ongoing operation: \(cardMetadata.ongoingOperation.rawValue)")

        // Por ejemplo, muestra el primer recurso (artwork) de la tarjeta.
        cardMetadata.cardAssetArray { assets, error in
            if let cardAssetContent = assets?.first?.contentArray.first,
               let cardImageData = Data(base64Encoded: cardAssetContent.encodedData, options: .ignoreUnknownCharacters) {
                let image = UIImage.init(data: cardImageData)
            }
        }
    }
}