Migrar los métodos de pago al Dashboard

Para las integraciones existentes de Stripe Checkout que especifiquen payment_method_types, debes eliminar este parámetro para migrar las preferencias de los métodos de pago al Dashboard. Una vez que quites el parámetro de tu integración, algunos métodos de pago se activarán automáticamente, incluidas las tarjetas y los monederos. El parámetro currency restringe los métodos de pago que el cliente ve en la sesión de Checkout.

Stripe::Checkout::Session.create({
  line_items: [
    {
      price_data: {
        currency: 'eur',
        product_data: {name: 'T-shirt'},
        unit_amount: 2000,
      },
      quantity: 1,
    },
  ],
  mode: 'payment',
  # Remove the payment_method_types parameter to manage payment methods in the Dashboard
  payment_method_types: ['card'],
  return_url: 'https://example.com/return',
  ui_mode: 'embedded',
})

Visualiza la configuración de métodos de pago para ver los métodos de pago que aceptas actualmente. Esta lista incluye los métodos de pago que están activados de forma predeterminada, como las tarjetas. Estos métodos de pago tienen un coste igual o inferior que las tarjetas, y se liquidan de inmediato.

Métodos de pago

De forma predeterminada, Stripe habilita las tarjetas y otros métodos de pago comunes. Puedes activar o desactivar métodos de pago individuales en el Dashboard de Stripe. En Checkout, Stripe evalúa la divisa y las restricciones y, a continuación, presenta al cliente de forma dinámica los métodos de pago admitidos.

Para ver cómo se muestran tus métodos de pago a los clientes, introduce un ID de transacción o establece el importe y la divisa de un pedido en el Dashboard.

Puedes habilitar Apple Pay y Google Pay en la configuración de métodos de pago. De forma predeterminada, Apple Pay está habilitado y Google Pay está deshabilitado. Sin embargo, en algunos casos Stripe las filtra incluso cuando están habilitadas. Filtramos Google Pay si habilitas el impuesto automático sin recopilar la dirección de envío.

Las páginas alojadas en Stripe de Checkout no necesitan cambios de integración para habilitar Apple Pay o Google Pay. Stripe gestiona estos pagos igual que otros pagos con tarjeta.

En la página de configuración de métodos de pago del Dashboard, puedes ver los métodos de pago disponibles y activar nuevos métodos de pago para tu integración.

Puedes habilitar algunos métodos de pago simplemente seleccionando Activar. Sin embargo, algunos métodos de pago requieren pasos adicionales para su activación. En esos casos, verás un botón de Configurar o Revisar condiciones.

Para obtener más información sobre los métodos de pago adecuados para tu empresa, consulta nuestra guía de métodos de pago.

Dependiendo del tipo de método de pago que integres, puede haber un retraso de entre 2 y 14 días en la confirmación del pago. Si configuras webhooks para completar automáticamente pedidos con tu integración de Checkout, puede que necesites actualizar tu código cuando añadas tus primeros métodos de pago con notificación diferida.

Cuando se reciben pagos con un método de pago de notificación con retraso, los fondos no están disponibles de inmediato. El procesamiento de los fondos puede tardar varios días, por lo que deberías retrasar el cumplimientot del pedido hasta que los fondos estén disponibles en tu cuenta. Una vez que el pago se haya realizado correctamente, el estado PaymentIntent subyacente cambia de processing a succeeded.

Deberás gestionar los siguientes eventos de Checkout:

Todos estos eventos incluyen el objeto Sesión de Checkout.

Actualiza tu controlador de eventos para completar el pedido:

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

# You can find your endpoint's secret in the output of the `stripe listen`
# command you ran earlier
endpoint_secret = 'whsec_...'

post '/webhook' do
  event = nil

  # Verify webhook signature and extract the event
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    payload = request.body.read
    event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret)
  rescue JSON::ParserError => e
    # Invalid payload
    return status 400
  rescue Stripe::SignatureVerificationError => e
    # Invalid signature
    return status 400
  end

  case event['type']
  if event['type'] == 'checkout.session.completed'
    checkout_session = event['data']['object']

    fulfill_order(checkout_session)
  end
  when 'checkout.session.completed'
    checkout_session = event['data']['object']

    # Save an order in your database, marked as 'awaiting payment'
    create_order(checkout_session)

    # Check if the order is already paid (for example, from a card payment)
    #
    # A delayed notification payment will have an `unpaid` status, as
    # you're still waiting for funds to be transferred from the customer's
    # account.
    if checkout_session.payment_status == 'paid'
      fulfill_order(checkout_session)
    end
  when 'checkout.session.async_payment_succeeded'
    checkout_session = event['data']['object']

    # Fulfill the purchase...
    fulfill_order(checkout_session)
  when 'checkout.session.async_payment_failed'
    session = event['data']['object']

    # Send an email to the customer asking them to retry their order
    email_customer_about_failed_payment(checkout_session)
  end

  status 200
end

def fulfill_order(checkout_session)
  # TODO: fill in with your own logic
  puts "Fulfilling order for #{checkout_session.inspect}"
end

def create_order(checkout_session)
  # TODO: fill in with your own logic
  puts "Creating order for #{checkout_session.inspect}"
end

def email_customer_about_failed_payment(checkout_session)
  # TODO: fill in with your own logic
  puts "Emailing customer about payment failure for: #{checkout_session.inspect}"
end

Pruebas

Asegúrate de que se esté ejecutando stripe listen. Accede a Checkout como usuario de prueba, tal y como hiciste en los pasos anteriores. Debería llegar un evento checkout.session.completed a tu controlador de eventos, y la operación debería gestionarse correctamente.

Ahora que has completado estos pasos, puedes pasar al modo activo en la producción en el momento que decidas.

Consulta Pruebas para obtener información adicional para probar tu integración.