On the web, with more detail: Receive and verify webhooks.

MishkaPay.Webhook takes each provider's signed messages at /pay/webhooks/<provider>/<tenant>, checks the signature with that tenant's webhook_secret, and hands a MishkaPay.Event to the mishka_pay:webhook:received listeners. It must come before Plug.Parsers (it needs the raw body).

In Stripe's Dashboard, point each site's endpoint at https://your-host/pay/webhooks/stripe/<site id> and send it the events of MishkaPay.Providers.Stripe.handled_events/0:

Stripe eventUpdates
checkout.session.completedthe payment, or the subscription it started
checkout.session.expired, checkout.session.async_payment_succeeded, checkout.session.async_payment_failedthe payment
payment_intent.succeeded, payment_intent.payment_failed, payment_intent.canceled, payment_intent.processing, payment_intent.requires_action, payment_intent.amount_capturable_updatedthe payment
charge.succeeded, charge.failed, charge.refunded, charge.captured, charge.expiredthe payment
refund.created, refund.updated, refund.failedthe payment
invoice_payment.paidthe payment an invoice was paid with
charge.dispute.created, charge.dispute.updated, charge.dispute.closed, charge.dispute.funds_withdrawn, charge.dispute.funds_reinstatedthe dispute and its payment
invoice.paid, invoice.payment_failed, invoice.finalized, invoice.payment_action_required, invoice.voided, invoice.marked_uncollectible, invoice.overdue, invoice.upcomingthe subscription
customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, customer.subscription.paused, customer.subscription.resumed, customer.subscription.trial_will_endthe subscription
customer.created, customer.updated, customer.deletedthe customer
setup_intent.succeeded, setup_intent.setup_failed, payment_method.attached, payment_method.detached, payment_method.updated, payment_method.automatically_updatedthe customer the setup or the payment method names
entitlements.active_entitlement_summary.updatedthe customer whose entitlements changed
customer.tax_id.created, customer.tax_id.updated, customer.tax_id.deletedthe customer the tax id belongs to

Each listed event is tested to name what it updates. Any other event is verified and stored, and changes nothing.

Listeners

Without Ash, listen on mishka_pay:webhook:received and read the object again from the provider (the webhook body is never proof):

defmodule MyApp.Pay.OnEvent do
  use MishkaInstaller.Event.Hook, event: "mishka_pay:webhook:received"

  @impl true
  def call(%{event: %MishkaPay.Event{payment_id: id, tenant: site}} = state) when is_binary(id) do
    {:ok, payment} = MishkaPay.fetch_payment(state.event.provider, id, site)
    MyApp.Orders.paid(payment)
    {:reply, state}
  end

  def call(state), do: {:reply, state}
end

Answer %{state | failed: "reason"} when the work did not happen: the endpoint answers 500 and the provider sends the event again. With the Ash layer, the inbox stores every event once and works it as an Oban job with retries; see the Ash guide.