Sign in

v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
webhook-event
bank-account-details

Account details payment state change

Triggered every time a pay-in is made into the specified account details.

  • Event type: account-details-payment#state-change
  • Profile level subscriptions: Supported
  • Application level subscriptions: Supported

Events may not be delivered in the order they occurred. Use data.occurred_at to reconcile the order. See the Event ordering guide for details.

See the Webhooks guide for setup instructions, signature verification, and best practices.

postWebhookaccount-details-payment#state-change

Headers

X-Signature-SHA256string

RSA-SHA256 signature of the request body, Base64 encoded. Verify this against the Wise public key to ensure the request is authentic and has not been tampered with.

X-Delivery-Idstring uuid

Unique identifier for this webhook delivery attempt.

X-Test-Notificationboolean

Present with the value true if this is a test notification sent to verify your callback URL during subscription setup.

Payload

OR

Example payload

{
  "schema_version": "4.0.0",
  "subscription_id": "36c3f762-560d-4f07-84f9-5d8a3cacabbb",
  "event_type": "account-details-payment#state-change",
  "sent_at": "2024-01-01T12:34:56.123Z",
  "data": {
    "resource": {
      "id": 12345,
      "profile_id": 1,
      "type": "balance-account"
    },
    "account_details_id": "1",
    "target_account_id": "12345",
    "transfer": {
      "id": 36454,
      "type": "credit",
      "amount": 120,
      "currency": "EUR"
    },
    "sender": {
      "name": "Test Sender",
      "account_number": "12345678",
      "bank_code": "TESTBANK",
      "address": "Test Address"
    },
    "current_state": "COMPLETED",
    "previous_state": "PROCESSING",
    "occurred_at": "2026-02-24T11:10:13.789Z"
  }
}

Response

Return any 2xx status to acknowledge receipt of the event.

statusstring

Example response

{
  "status": "ok"
}