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'],
  success_url: 'https://example.com/success',
})

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.

Payment methods

By default, Stripe enables cards and other common payment methods. You can turn individual payment methods on or off in the Stripe Dashboard. In Checkout, Stripe evaluates the currency and any restrictions, then dynamically presents the supported payment methods to the customer.

To see how your payment methods appear to customers, enter a transaction ID or set an order amount and currency in the Dashboard.

You can enable Apple Pay and Google Pay in your payment methods settings. By default, Apple Pay is enabled and Google Pay is disabled. However, in some cases Stripe filters them out even when they’re enabled. We filter ApplePay if you set setup_future_usage (either top-level or in payment_method_options for card), and we filter Google Pay if you enable automatic tax without collecting a shipping address.

Checkout’s Stripe-hosted pages don’t need integration changes to enable Apple Pay or Google Pay. Stripe handles these payments the same way as other card payments.

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:

These events all include the Checkout Session object.

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_4eC39HqLyjWDarjtT1zdp7dc'

# 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.