Sign in

v5

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

Create bank account details order

Creates an order which will issue account details. It should use the same currency as the balance previously created. Fulfilling all the requirements will complete the order, reaching status DONE.

The possible values for a requirement status are:

  • PENDING_USER: The requirement has some pending action from the user.
  • PENDING_TW: The requirement has some pending action from Wise.
  • DONE: The requirement is completed.

The more common requirements are:

  • VERIFICATION: The user needs to be fully verified before completing this requirement.
  • TOP_UP: A fee will be charged and must be paid through wise.com before completing this requirement.
post/v1/profiles/{profileId}/account-details-orders

Path parameters

profileIdinteger required
Example:12345678

The ID of the profile to create the bank account details order for.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

currencystring required

Balance currency (ISO 4217 Alphabetic Code).

Example request

{
  "currency": "EUR"
}

Response

Bank account details order created.

status'PENDING_USER' | 'PENDING_TW' | 'DONE'

Order status.

currencystring

Currency code (ISO 4217 Alphabetic Code).

Example response

{
  "status": "PENDING_USER",
  "currency": "EUR",
  "requirements": [
    {
      "type": "VERIFICATION",
      "status": "PENDING_USER"
    }
  ]
}