---
title: "Account details order state change"
method: POST
path: "account-details-order#order-state-change"
tags: ["webhook-event", "bank-account-details"]
---

# Account details order state change

`POST account-details-order#order-state-change` (webhook)

The event contains information about the order state and requirement state. Triggered when there is a change in the state of an account details order. 

* Event type: `account-details-order#order-state-change`
* Profile level subscriptions: Not Supported
* Application level subscriptions: Supported

Possible values for an order:

- `PENDING_USER`: One or more requirements has some pending action from the user.
- `PENDING_TW`: One or more requirements has some pending action from Wise.
- `REQUIREMENTS_FULFILLED`: All requirements are completed and pending account details to be created.
- `DONE`: All requirements are completed and account details has also been created.

{% img
  src="/images/diagrams/account-details-order-state-flow.png"
  alt="Create account details order statuses transition diagram"
/%}

Most common requirements:

- `VERIFICATION`: The user needs to be fully verified before completing this requirement.

Events may not be delivered in the order they occurred. Use `data.modification_time` to reconcile the order.
See the [Event ordering guide](/guides/developer/webhooks/event-ordering) for details.

See the [Webhooks guide](/guides/developer/webhooks) for setup instructions, signature verification, and best practices.

## Headers

- `X-Signature-SHA256` string
- `X-Delivery-Id` string, uuid
- `X-Test-Notification` boolean

## Payload

- union
  - V4005
    - `schema_version` '4.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event.
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent.
    - `data` object
      - `creation_time` string, date-time — When the order was created.
      - `currency` string — Currency code for the account details order.
      - `is_account_details_issued` boolean — Whether account details have been issued for this order.
      - `modification_time` string, date-time — When the order was last modified.
      - `order_id` string — Unique identifier for the account details order.
      - `order_status` 'PENDING_USER' | 'PENDING_TW' | 'REQUIREMENTS_FULFILLED' | 'DONE' — Current status of the order
      - `profile_id` integer — ID of the profile associated with this order.
      - `requirements` object[] — List of requirements for this order.
        - `status` string — Status of the individual requirement (`"DONE"`, `"PENDING"`, etc.)
        - `type` string — Type of requirement (`"VERIFICATION"`)
  - V2005
    - `schema_version` '2.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event.
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent.
    - `data` object
      - `creation_time` string, date-time — When the order was created.
      - `currency` string — Currency code for the account details order.
      - `is_account_details_issued` boolean — Whether account details have been issued for this order.
      - `modification_time` string, date-time — When the order was last modified.
      - `order_id` string — Unique identifier for the account details order.
      - `order_status` 'PENDING_USER' | 'PENDING_TW' | 'REQUIREMENTS_FULFILLED' | 'DONE' — Current status of the order.
      - `profile_id` integer — ID of the profile associated with this order.
      - `requirements` object[] — List of requirements for this order.
        - `status` string — Status of the individual requirement (`"DONE"`, `"PENDING"`, etc.)
        - `type` string — Type of requirement (`"VERIFICATION"`)

## Acknowledgement `200`

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

- object
  - `status` string

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)