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 webhooks 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, 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 secreto de webhooks (whsec_...) a tu código de gestión de eventos y, a continuación, prueba la gestión logística accediendo a Checkout como cliente:

• Presiona el botón de confirmación de compra que te lleva a Checkout, o visita tu Payment Link
• Proporciona los siguientes datos de prueba en Checkout:
  • Introduce 4242 4242 4242 4242 como número de tarjeta
  • Introduce cualquier fecha futura como fecha de vencimiento de la tarjeta
  • Introduce cualquier número de tres dígitos para el CVC
  • Introduce cualquier código postal de pagos (90210)
• Presiona el botón Paga

Cuando se efectivice 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.

Configura el Checkout para que se remita al cliente a una página en tu sitio web después de que complete el proceso de compra. Incluye el marcador de posición {CHECKOUT_SESSION_ID} en la URL de tu página, que se reemplaza con el ID de la sesión de Checkout cuando se redirige al cliente desde el Checkout.

Proceso de compra alojado

En el caso de las Checkout Sessions con la ui_mode predeterminada de hosted, establece el valor success_url.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/after-checkout?session_id={CHECKOUT_SESSION_ID}"

Payment Links

Para Payment Links que crees con la API, establece el after_completion.redirect.url.

curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "after_completion[type]"=redirect \
  --data-urlencode "after_completion[redirect][url]"="https://example.com/after-checkout?session_id={CHECKOUT_SESSION_ID}"

Para Payment Links que crees en el Dashboard:

1. Ve a la pestaña Después del pago.
2. Selecciona No mostrar página de confirmación.
3. Proporciona la URL de tu página de destino que incluya el marcador de posición {CHECKOUT_SESSION_ID} (por ejemplo, https://example.com/after-checkout?session_id={CHECKOUT_SESSION_ID})

La recepción de notificaciones de eventos webhooks es necesaria para asegurarte de que siempre actives la gestión logística de cada pago, pero los webhooks a veces pueden retrasarse. Para optimizar tu flujo de pagos y garantizar la gestión logística inmediata cuando tu cliente esté presente, activa la gestión logística también desde tu página de inicio.

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

1. Cuando tu servidor reciba una solicitud para tu página de inicio de Checkout, extraer el ID de la Checkout Session de la URL.
2. Ejecutar la función fulfill_checkout con el ID proporcionado.
3. Renderizar la página una vez completado el intento de gestión logística.

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

• Detalles del proceso de gestión logística.
• 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.