Create wallet account

POST 
/accounts

Create a new account. The following parameters are required for account creation.

• customerId
• currencyCode
• hasIban

Request

application/json

Body

required

externalId string

Possible values: <= 40 characters

currencyCode Currency (string)required

Possible values: >= 3 characters and <= 3 characters

Currency alphabetic code as specified by ISO 4217

hasIban booleanrequired

Responses

201

Created

application/json

Schema

Schema

id string

Possible values: <= 20 characters

Account id.

customerId string

Possible values: <= 20 characters

externalId string

Possible values: <= 40 characters

currencyCode Currency (string)required

Possible values: >= 3 characters and <= 3 characters

Currency alphabetic code as specified by ISO 4217

totalBalance int64

Amount in minor units

availableBalance int64

Amount in minor units

iban string

IBAN associated with this account.

bic string

Possible values: <= 20 characters

accountNumber string

Possible values: <= 40 characters

DKK account number.

bankCode string

Possible values: <= 20 characters

DKK bank code.

creationTime date-time
hasIban booleanrequired

Example (from schema)

{
  "id": "string",
  "customerId": "5435323362",
  "externalId": "string",
  "currencyCode": "EUR",
  "totalBalance": 0,
  "availableBalance": 0,
  "iban": "string",
  "bic": "string",
  "accountNumber": "string",
  "bankCode": "string",
  "creationTime": "2019-08-24T14:15:22Z",
  "hasIban": true
}

ACCOUNT

{
  "id": "509876034",
  "externalId": "42342355",
  "customerId": "5435323362",
  "currencyCode": "GBP",
  "totalBalance": 0,
  "availableBalance": 0,
  "iban": "NL74ABNA1231242344",
  "creationTime": "2019-08-24T14:15:22Z",
  "hasIban": true,
  "bic": "ABNANL2A"
}

400

Bad Request

application/json

Schema

Schema

error

object

Additional details about an error

code string

The error code.

message string

A description of the error.

details string[]

Details of any parameter value errors.

fieldErrors

object[]

Array [

field string

Identifies the JSON request field.

error string

The problem associated with the field.

]

Example (from schema)

{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      "string"
    ],
    "fieldErrors": [
      {
        "field": "string",
        "error": "string"
      }
    ]
  }
}

INVALID_CURRENCY

{
  "error": {
    "code": "5068",
    "message": "Field error(s)",
    "details": [
      "Either you submitted a request that is missing a mandatory field or the value of a field does not match the format expected."
    ],
    "fieldErrors": [
      {
        "field": "accounts[0].currencyCode",
        "error": "size must be between 3 and 3"
      }
    ]
  }
}

UNSUPPORTED_CURRENCY

{
  "error": {
    "code": "DW-CUSTOMER-CURRENCY-NOT-SUPPORTED",
    "message": "Currency is not supported for the specified country",
    "details": [
      "The currency code is not supported for the specified country",
      "BGN"
    ]
  }
}

NO_SUCH_CUSTOMER

{
  "error": {
    "code": "DW-NO-SUCH-CUSTOMER",
    "message": "Customer was not found",
    "details": [
      "No customer matching the provided customerId was found."
    ]
  }
}

500

Internal Server Error

application/json

Schema

Schema

error

object

Additional details about an error

code string

The error code.

message string

A description of the error.

details string[]

Details of any parameter value errors.

fieldErrors

object[]

Array [

field string

Identifies the JSON request field.

error string

The problem associated with the field.

]

Example (from schema)

{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      "string"
    ],
    "fieldErrors": [
      {
        "field": "string",
        "error": "string"
      }
    ]
  }
}

INTERNAL_SERVER_ERROR

{
  "error": {
    "code": "DW-INTERNAL-SERVER-ERROR",
    "message": "Internal Server Error",
    "details": [
      "There was an error while processing the operation"
    ]
  }
}

503

Service Unavailable. Please try again later.

application/json

Schema

Schema

error

object

Additional details about an error

code string

The error code.

message string

A description of the error.

details string[]

Details of any parameter value errors.

fieldErrors

object[]

Array [

field string

Identifies the JSON request field.

error string

The problem associated with the field.

]

Example (from schema)

{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      "string"
    ],
    "fieldErrors": [
      {
        "field": "string",
        "error": "string"
      }
    ]
  }
}

SERVICE_UNAVAILABLE

{
  "error": {
    "code": "DW-SERVICE-UNAVAILABLE",
    "message": "Service Unavailable",
    "details": [
      "Service Unavailable"
    ]
  }
}

Loading...