Completa los pedidos

Crea una función en tu servidor para completar los pagos realizados correctamente. Los webhooks activan esta función, y se llama cuando los clientes son redirigidos a tu sitio web después de completar el proceso de compra. Esta guía se refiere a esta función como fulfill_checkout, pero puedes nombrarla como desees.

La función fulfill_checkout debe:

1. Gestiona correctamente que te llamen varias veces con el mismo ID de la sesión de Checkout.
2. Acepta el ID de Checkout Sessions como argumento.
3. Recupera la sesión de Checkout de la API con la propiedad line_items ampliada.
4. Revisa la propiedad payment_status para determinar si necesita cumplimiento.
5. Lleva a cabo el cumplimiento de las partidas individuales.
6. Registra el estado de cumplimiento de la sesión de Checkout proporcionada.

Utiliza el siguiente código como punto de partida para tu función fulfill_checkout. Los comentarios TODO indican las funciones que debas implementar.

def fulfill_checkout(session_id)
  # 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'

  puts "Fullfilling Checkout Session #{session_id}"

  # TODO: Make this function safe to run multiple times,
  # even concurrently, with the same session ID

  # TODO: Make sure fulfillment hasn't already been
  # performed for this Checkout Session

  # Retrieve the Checkout Session from the API with line_items expanded
  checkout_session = Stripe::Checkout::Session.retrieve({
    id: session_id,
    expand: ['line_items'],
  })

  # Check the Checkout Session's payment_status property
  # to determine if fulfillment should be performed
  if checkout_session.payment_status != 'unpaid'
    # TODO: Perform fulfillment of the line items

    # TODO: Record/save fulfillment status for this
    # Checkout Session
  end
end

Según los métodos de pago que aceptes y de las necesidades de tu empresa, quizás te convenga que la función fulfill_checkout haga lo siguiente:

• Facilita el acceso a los servicios.
• Activa el envío de bienes.
• Guarda una copia de los datos de pago y de las partidas individuales en tu propia base de datos.
• Envía al cliente un correo electrónico de recibo personalizado si no tienes habilitados los recibos de Stripe.
• Concilia las partidas individuales y las cantidades compradas si permites que los clientes ajusten las cantidades en Checkout.
• Actualiza el inventario o los registros de existencias.

Para activar el cumplimiento, crea un controlador de eventos de webhook para recibir notificaciones de los eventos de pago y activar la función fulfill_checkout.

Cuando alguien te paga, se crea un evento checkout.session.completed. Configura un punto de conexión en tu servidor para aceptar, procesar y confirmar la recepción de estos eventos.

Métodos de pago inmediatos frente a métodos de pago diferidos

Algunos métodos de pago no son instantáneos, como el adeudo directo ACH y otras transferencias bancarias. Esto significa que los fondos no estarán disponibles de inmediato cuando se complete el proceso de compra. Los métodos de pago diferido generan un evento de checkout.session.async_payment_succeeded cuando el pago se efectúa correctamente más tarde. El estado del objeto es en procesamiento hasta que el pago se realiza correctamente o falla.

require 'sinatra'

# Use the secret provided by Stripe CLI for local testing
# or your webhook endpoint's secret.
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

  if event['type'] == 'checkout.session.completed' ||
  event['type'] == 'checkout.session.async_payment_succeeded'
    fulfill_checkout(event['data']['object']['id'])
  end

  status 200
end

Es posible que también quieras recibir notificaciones y manejar eventos checkout.session.async_payment_failed. Por ejemplo, puedes enviar un correo electrónico a tu cliente cuando falla un pago retrasado.

La forma más rápida de desarrollar y probar tu controlador de eventos de webhook es con la CLI de Stripe. Si no tienes la CLI de Stripe, sigue la guía de instalación para empezar.

Cuando la CLI de Stripe esté instalada, puedes probar tu controlador de eventos localmente. Ejecuta tu servidor (por ejemplo, en localhost:4242) y, a continuación, ejecuta el comando stripe listen para que la CLI de Stripe reenvíe los eventos a tu servidor local:

stripe listen --forward-to localhost:4242/webhook

Ready! Your webhook signing secret is 'whsec_<REDACTED>' (^C to quit)

Añade el secreto del webhook (whsec_...) a tu código de gestión de eventos y, a continuación, prueba el cumplimiento accediendo a tu proceso de compra como cliente.

Cuando se complete el pago, verifica lo siguiente:

• En tu línea de comandos, donde se está ejecutando stripe listen, se muestra un evento checkout.session.completed reenviado a tu servidor local.
• Los registros de tu servidor muestran el resultado esperado de tu función fulfill_checkout.

Después de hacer pruebas locales, pon en marcha tu controlador de eventos de webhook en tu servidor. A continuación, crea un punto de conexión de webhook para enviar eventos checkout.session.completed a tu servidor y luego prueba de nuevo el flujo del proceso de compra.

Escuchar webhooks es necesario para asegurarte de activar siempre el envío por cada pago, aunque los webhooks a veces pueden retrasarse. Para optimizar tu flujo de pago y garantizar el cumplimiento inmediato cuando tu cliente esté presente, activa el procesamiento también desde tu página de inicio. Puedes configurar la página de destino especificando return_url al crear la sesión de Checkout, o especificando returnUrl a confirm en el front end.

Usa el ID de la sesión de Checkout desde la URL que especificaste para hacer lo siguiente:

1. Cuando tu servidor reciba una solicitud para tu página de inicio de Checkout, extrae el ID de la sesión de Checkout de la URL.
2. Ejecuta la función fulfill_checkout con el ID proporcionado.
3. Procesa la página una vez que se complete el intento de completar el pedido.

Al renderizar la página de destino, puede mostrar lo siguiente:

• Detalles del proceso de completar pedidos.
• Enlaces o información sobre los servicios a los que el cliente tiene ahora acceso.
• Detalles de envío o logística de bienes físicos.