Realiza los cambios necesarios en tu integración con la API de iDEAL

iDEAL ya no espera que los comerciantes vean un selector de banco en sus procesos de compra. En su lugar, como parte de la nueva experiencia iDEAL 2.0, los clientes eligen su banco en la nueva página de selección de bancos alojada de iDEAL. Debes dejar de enviar el banco del cliente en tus solicitudes de API para crear un pago con iDEAL, a menos que sea un cliente que vuelve y ya conozcas su banco.

¿Tengo que hacer algo?

No se requiere ninguna acción para los usuarios de Stripe en Checkout, Payment Links, Payment Element y facturas alojadas, puesto que Stripe ya los migró para cumplir con la nueva normativa de iDEAL.

Si te has integrado con el IdealBankElement, el SDK móvil o tienes una integración avanzada de API con Stripe, debes tomar medidas para realizar estos cambios.

Qué tienes que cambiar

Integración de IdealBankElement

Si estás usando el método IdealBankElement de react-stripe-js o elements.create('idealBank',options?), tendrás que:

Integración de SDK móvil

Realiza los siguientes cambios en la integración de tu aplicación móvil:

Android

// ANTES

val paymentMethodCreateParams = PaymentMethodCreateParams.create(
  ideal = PaymentMethodCreateParams.Ideal("Nombre del banco"),
  billingDetails = PaymentMethod.BillingDetails(
    name = "Julia Pérez"
  )
)
// DESPUÉS

val paymentMethodCreateParams = PaymentMethodCreateParams.create(
  ideal = PaymentMethodCreateParams.Ideal(null),
  billingDetails = PaymentMethod.BillingDetails(
    name = "Julia Pérez"
  )
)

iOS

// ANTES

let iDEALParams = STPPaymentMethodiDEALParams()
iDEALParams.bankName = "abn_amro"

let billingDetails = STPPaymentMethodBillingDetails()
billingDetails.name = "Julia Pérez"

let paymentMethodParams = STPPaymentMethodParams(
    iDEAL: iDEALParams,
    billingDetails: billingDetails,
    metadata: nil
)
// DESPUÉS

let billingDetails = STPPaymentMethodBillingDetails()
billingDetails.name = "Julia Pérez"

let paymentMethodParams = STPPaymentMethodParams(
    billingDetails: billingDetails,
    metadata: nil
)

Integración avanzada de la API

Para pagos creados para un cliente que paga con iDEAL por primera vez:

Para los clientes recurrentes, puedes almacenar el banco devuelto por Stripe en payment_method_data[ideal][bank] en Payment Intents y Setup Intents, o ideal[bank] en Sources, y especificarlo en futuras confirmaciones de pago. De este modo, se omite la página de selección de bancos de iDEAL y se dirige al cliente directamente a su banco emisor.

Si quieres que tu cliente seleccione otro banco, crea un pago sin especificar el banco emisor. Especifica un banco diferente en futuras solicitudes de pago únicamente después de que tu cliente haya ido de nuevo a la página de selección de banco de iDEAL y hayas recibido el nuevo banco desde la API de Stripe.

Qué sucede si no realizas estos cambios

Para evitar incumplimientos de la normativa, Stripe actualizará tu integración de iDEAL, de modo que no se tenga en cuenta el banco seleccionado por los usuarios en tu página del proceso de compra. El impacto de los anuncios normativos es el siguiente: