Actualizar perfiles mediante el SDK de D1

Resumen

Esta página explica cómo la aplicación del emisor puede actualizar los datos del perfil de Click to Pay mediante el SDK D1.

La aplicación del emisor puede llamar a updateConsumer para actualizar los datos del perfil del usuario final, o updateCard para actualizar los datos a nivel de tarjeta de una tarjeta.

Use este flujo del SDK cuando desee que el usuario final revise y actualice los datos de Click to Pay directamente en la aplicación del emisor, mientras D1 orquesta la actualización de backend con los directorios de Click to Pay.

Enlaces rápidos

Elija la API de SDK adecuada

`updateConsumer`

Usa updateConsumer cuando los datos del consumidor almacenados en Click to Pay deban cambiar.

Proporcione todos los campos del consumidor, incluso si solo cambió un valor.

Si también proporciona una dirección de facturación, D1 actualiza la dirección de facturación de todas las tarjetas vinculadas al perfil del consumidor.

`updateCard`

Usa updateCard cuando solo una tarjeta inscrita deba cambiar.

Esta API actualiza la dirección de facturación de la tarjeta seleccionada y, solo para Visa, el nombre del titular de la tarjeta.

No use estas API del SDK para la renovación o sustitución de una tarjeta.

Use en su lugar el flujo de renovación o sustitución de D1.

Flujo

El flujo de actualización del SDK sigue estos pasos:

La aplicación del emisor inicializa el SDK D1 e inicia sesión en el usuario final.
La aplicación del emisor recupera los perfiles actuales de Click to Pay.
El usuario final actualiza los datos requeridos en la aplicación del emisor.
La aplicación del emisor llama a updateConsumer o updateCard.
D1 envía la solicitud al backend de D1 utilizando el contexto autenticado del usuario final.
El backend de D1 actualiza los directorios de Click to Pay pertinentes.
D1 devuelve el estado de la operación a la aplicación del emisor.

Diagrama de secuencia

El flujo del SDK tiene el mismo comportamiento funcional que el flujo de actualización de backend, pero se inicia directamente desde la aplicación del emisor.

Para los diagramas de secuencia detallados, consulte Actualizar perfiles de Click to Pay.

Puntos clave

Ambas operaciones son asíncronas.
El resultado inmediato contiene un estado de EXITOSA o PENDIENTE, además de un operationID.
Usa Recuperar perfiles mediante el SDK D1 para rellenar previamente la interfaz de usuario de la aplicación del emisor con los datos actuales de Click to Pay.
Usa updateConsumer solo cuando desee actualizar específicamente los datos de Click to Pay.
Si el backend del emisor almacena el perfil del usuario final en D1, prefiera Actualizar la información del consumidor cuando quiera que todos los canales, incluido Click to Pay, permanezcan sincronizados.
Para Mastercard, cuando proporcione una dirección de facturación, proporcione el objeto de dirección completo.

Gestionar notificaciones push de Click to Pay

Consulte Gestionar notificaciones push de Click to Pay en la documentación de inscripción mediante el SDK D1 para conocer los detalles de implementación.

API del SDK para `updateConsumer`

Usa updateConsumer cuando la aplicación del emisor actualiza los datos del perfil del usuario final en Click to Pay.

Esta API actualiza el perfil del usuario final en todos los directorios de Click to Pay pertinentes. Si proporciona una dirección de facturación, D1 también actualiza la dirección de facturación de cada tarjeta inscrita.

fun updateConsumerClick2Pay(d1Task: D1Task) {
    // Información del consumidor recibida de la entrada del usuario.
    val consumerInfo = ConsumerInfo(
        "Bella",
        "middle name",
        "Lin",
        "en-US",
        "+65",
        "99998888",
        "email@thalesgroup.com"
    )
    val billingAddress = BillingAddress("CZ")

    val callback: D1Task.Callback<Status?> =
        object : D1Task.Callback<Status?> {
            override fun onSuccess(data: Status?) {
                // Actualización del consumidor a Click to Pay correcta
                val status: Status? = data
                val operationID = data?.operationID
            }

            override fun onError(exception: D1Exception) {
                // Consulte la sección Integración del SDK D1 – Gestión de errores.
            }
        }
    d1Task.getClickToPayService().updateConsumer(
        consumerInfo,
        billingAddress,
        callback
    )
}

func updateConsumerClick2Pay(d1Task: D1Task) {
    do {
        // Información del consumidor recibida de la entrada del usuario.
        let consumerInfo = ConsumerInfo(firstName: "Bella",
                                        middleName: nil,
                                        lastName: "Lin",
                                        language: "en-US",
                                        phoneNumberCountryCode: "+65",
                                        phoneNumber: "99998888",
                                        email: "email@thalesgroup.com")
        let billingAddress = BillingAddress(countryCode: "CZ")
        let status = try await d1Task.clickToPayService().updateConsumer(consumerInfo: consumerInfo,
                                                                         billingAddress: billingAddress)
        switch status {
        case .pending(operationID: let operationID):
            // Gestionar el escenario pendiente
            print(operationID)
        case .successful(operationID: let operationID):
            // Gestionar el escenario correcto
            print(operationID)
        }
    } catch let error {
        // Gestionar el error.
    }
}

Envíe siempre el conjunto completo de datos del consumidor.

No envíe solo el campo que cambió.

API del SDK para `updateCard`

Usa updateCard cuando la aplicación del emisor actualiza una tarjeta inscrita en Click to Pay.

Esta API actualiza solo los datos a nivel de tarjeta. Úsela para la dirección de facturación, o para el nombre del titular de la tarjeta cuando la tarjeta pertenezca a Visa.

fun updateCardClickToPay(d1Task: D1Task, cardID: String, billingAddress: BillingAddress) {

    val callback: D1Task.Callback<Status?> =
        object : D1Task.Callback<Status?> {
            override fun onSuccess(data: Status?) {
                // Actualización de tarjeta a Click to Pay correcta
                val status: Status? = data
                val operationID = data?.operationID
            }

            override fun onError(exception: D1Exception) {
                // Consulte la sección Integración del SDK D1 – Gestión de errores.
            }
        }
    d1Task.getClickToPayService().updateCard(
        cardID,
        "Bella Lin",
        billingAddress,
        callback
    )
}

do {
    let cardID = ""
    let name = "Bella Lin"
    let billingAddress = BillingAddress(countryCode: "CZ")
    let status = try await d1Task.clickToPayService().updateCard(cardID,
                                                                 name: name,
                                                                 billingAddress: billingAddress)
    switch status {
    case .pending(operationID: let operationID):
        // Gestionar el escenario pendiente
        print(operationID)
    case .successful(operationID: let operationID):
        // Gestionar el escenario correcto
        print(operationID)
    }
} catch let error {
    // Gestionar el error.
}

Usa updateCard solo para datos adjuntos a una sola tarjeta.

Si cambia el perfil del usuario final, use updateConsumer en su lugar.

AnteriorActualizar perfiles de Click to Pay SiguienteDarse de baja de tarjetas de Click to Pay

Última actualización hace 2 meses

¿Te fue útil?