Reconcile out-of-order Wise Platform webhook deliveries using schema v4.0.0 and the event-ordering fields

domain: wise.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Update existing webhook subscriptions to schema version 4.0.0, added by Wise in March 2026 to provide consistent millisecond-precision timestamps across all event types
  2. Do not assume webhooks arrive in the order the underlying events occurred — use Wise's Event Ordering guide and the ordering fields on each payload to reconstruct the true sequence
  3. Handle the transfers#payout-failure and transfers#refund webhook events, including the sandbox simulation endpoints added in the May 2026 changelog, when testing failure/refund paths
  4. For KYC-gated flows, watch for the VERIFIED value on the KYC requirement state (added May 2026) in both the webhook payload and API response, not just pending/rejected states
  5. Version-gate your webhook handler so both older (pre-4.0.0) and newer event payloads can be parsed correctly during the subscription migration window

Known gotchas

Related routes

Build a unified multi-carrier webhook ingestion service with dedupe, out-of-order event handling, and idempotency
logistics-general · 6 steps · unrated
Compare webhook redelivery and idempotency guarantees across POS/aggregator providers to design a reliable order-ingestion layer that doesn't process the same event twice
food-delivery-general · 5 steps · unrated
subscribe to clover order webhooks and reconcile order details via follow-up api calls
docs.clover.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans