Skip to main content
Rails uses webhooks to notify B2B integrators about settlement state changes.

What webhooks are for

  • order created
  • order funded
  • order settling
  • order settled
  • order failed
  • order expired

Integration rules

  • Make webhook handlers idempotent
  • Persist the last known event ID
  • Reconcile webhook state against your own order table
  • Treat retries as normal
  • Treat webhooks as a settlement signal, not the only source of truth

Operational rule

Never depend on a single webhook delivery to advance your business state.