Completa pedidos

Crea una función en tu servidor para completar los pagos efectuados correctamente. Los webhooks activan esta función, y se la llama cuando se remite a los clientes 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 quieras.

La función fulfill_checkout debe hacer lo siguiente:

1. Gestionar correctamente las llamadas múltiples con la mismo ID de la Checkout Session.
2. Aceptar un ID de Checkout Session como argumento.
3. Recuperar la Checkout Session de la API con la propiedad line_items expandida.
4. Comprobar la propiedad payment_status para determinar si requiere gestión logística.
5. Realizar la gestión logística de las partidas.
6. Registrar el estado de la gestión logística para la Checkout Session proporcionada.

Usa el código que aparece a continuación como punto de partida para tu función fulfill_checkout. Los comentarios TODO indican cualquier funcionalidad que debes 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 las necesidades de tu empresa, es posible que te convenga que la función fulfill_checkout haga lo siguiente:

• Proporcionar acceso a los servicios.
• Activar el envío de mercancías.
• Guardar una copia de los datos de pago y las partidas en tu propia base de datos.
• Enviar al cliente un correo electrónico de recibo personalizado si no tienes habilitados los recibos de Stripe.
• Conciliar las partidas y las cantidades compradas si permites que los clientes ajusten las cantidades en Checkout.
• Actualizar el inventario o los registros de existencias.

Para activar la gestión logística, crea un controlador de eventos de webhooks que reciba notificaciones de los eventos de pago y active tu 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 versus métodos de pago diferidos

Algunos métodos de pago no son instantáneos, como el ACH direct debit 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 diferidos generan un evento de checkout.session.async_payment_succeeded cuando el pago se realiza con éxito más tarde. El estado del objeto es en proceso hasta que el estado del pago se confirma 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

También es posible que quieras gestionar y recibir notificaciones de eventos checkout.session.async_payment_failed. Por ejemplo, puedes enviar un correo electrónico a tu cliente cuando falle 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 el controlador de eventos a nivel local. Ejecuta tu servidor (por ejemplo, en localhost:4242) y, luego, 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)

Agrega el webhook secreto (whsec_...) a tu código de gestión de eventos y, a continuación, prueba la ejecución del pedido completando la compra como cliente.

Cuando se complete el pago, verifica lo siguiente:

• En la 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 realizar la prueba local, pon en marcha tu controlador de eventos de webhook en tu servidor. A continuación, crea un punto de conexión de webhooks para enviar eventos checkout.session.completed a tu servidor y luego vuelve a probar el flujo de compra.

Recibir notificaciones de webhooks es necesario para asegurarte de que siempre actives la ejecución de pedidos de cada pago, pero los webhooks a veces pueden demorarse. Para optimizar tu flujo de pago y garantizar la ejecución de pedidos inmediata cuando tu cliente esté presente, activa la ejecución también desde tu página de destino. Puedes configurar la página de destino especificando return_url al crear la sesión de Checkout o especificando returnUrl en confirm en el front-end.

Usa el ID de la Checkout Session de la URL que especificaste para hacer lo siguiente:

1. Cuando tu servidor reciba una solicitud para tu página de destino 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. Renderiza la página una vez completado el intento de completar el pedido.

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

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