Webhooks

No webhook receiver is implemented in the current MVP.

Current behavior#

The mock adapter returns a local result and writes a finalized receipt. Domain services reconcile that local ledger. There is no signed callback delivery, event subscription or public receiver URL.

Proposed event shape#

Example

// Illustrative contract only.
{
  "eventId": "evt_example",
  "type": "transfer.status_changed",
  "transferId": "transfer_example",
  "status": "completed"
}

Requirements for a real receiver#

Verify the provider’s authentication and signature scheme before parsing an event as authority. Deduplicate deliveries, handle out-of-order updates and reconcile against provider records. Do not mark a payment complete from an unverified payload.