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'],
  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 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.

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 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 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:

These events all include the Checkout Session object.

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.