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 elimines el parámetro de tu integración, algunos métodos de pago se activarán automáticamente, por ejemplo, las tarjetas y carteras. 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 que están activados de forma predeterminada, como las tarjetas. Estos métodos de pago cuestan lo mismo que las tarjetas o menos y se acreditan 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 moneda 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 una ID de transacción o establece el importe y la moneda de un pedido en el Dashboard.

Puedes habilitar Apple Pay y Google Pay en tu 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 los filtra incluso cuando están habilitados. Filtramos Google Pay si habilitas el cálculo automático de impuestos sin recopilar una 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 de la mima manera que otros pagos con tarjeta.

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

Puedes habilitar los métodos de pago solo con seleccionar Activar. Sin embargo, se requieren algunos pasos adicionales para activar determinados métodos de pago. Para esos casos, verás un botón que dice Configurar o Revisar términos.

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

Según el tipo de método de pago que integres, la confirmación del pago puede ocurrir entre 2 y 14 días después. Si configuras webhooks para completar automáticamente pedidos con tu integración de Checkout, cuando agregas el primer método de pago con notificación diferida, es posible que tengas que actualizar el código.

Cuando recibes pagos con métodos con notificación diferida, no se dispone de los fondos de inmediato. El procesamiento puede tardar varios días, de manera que debes retrasar el cumplimiento del pedido hasta que los fondos estén en tu cuenta. Después de que el pago se efectúa correctamente, el estado del PaymentIntent subyacente cambia de processing a succeeded.

Tendrás que gestionar los siguientes eventos de Checkout:

Todos estos eventos incluyen el objeto Checkout Session.

Actualiza el 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 stripe listen se esté ejecutando. Accede a Checkout como usuario de prueba, tal como hiciste en los pasos anteriores. Debería llegar un evento checkout.session.completed al controlador de eventos, y la operación debería gestionarse satisfactoriamente.

Ahora que has completado estos pasos, estás en condiciones de pasar a modo de producción cuando lo decidas.

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