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 webhook secreto (whsec_...) a tu código de gestión de eventos y, a continuación, prueba el cumplimiento accediendo a Checkout como cliente:

• Pulsa el botón de finalizació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 caducidad
  • Introduce cualquier número de tres dígitos como CVC
  • Introduce cualquier código postal de facturación (90210)
• Pulsa el botón Pagar

Cuando se efectiviza 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 la salida esperada de la 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 del webhook para enviar eventos checkout.session.completed a tu servidor y luego prueba de nuevo el flujo del proceso de compra.

Configura Checkout para enviar al cliente a una página de 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 sustituye por el ID de la sesión de Checkout cuando el cliente completa el proceso de compra.

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 \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/after-checkout?session_id={CHECKOUT_SESSION_ID}"

Recibir notificaciones de los webhooks es necesario para asegurarte de que siempre actives el procesamiento de todos los pagos, pero 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.

Usa el ID de la sesión de Checkout 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 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 que se complete el intento de completar el pedido.

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

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