Create wallet account

POST 
/v2/customers/:customerId/accounts

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

• currencyCode
• hasVirtualInstrument

Request

Path Parameters

customerId stringrequired

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

hasVirtualInstrument booleandeprecated
virtualAccountAssignment boolean

Create a virtual banking account for this e-money account.

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

virtualInstrument

object[]

Array [

instrumentType

string

required

Possible values: [SEPA_BANK_ACCOUNT, UK_BANK_ACCOUNT, US_BANK_ACCOUNT]

Instrument type.

SEPA_BANK_ACCOUNT

iban stringrequired

The International Bank Account Number (IBAN) of the account.

bic stringrequired

The Bank Account Bank Identifier Code (BIC) code. Also known as SWIFT code.

UK_BANK_ACCOUNT

accountNumber stringrequired

A bank account number.

sortCode stringrequired

Use our sort code checker to easily find and check UK sort codes.

US_BANK_ACCOUNT

accountNumber stringrequired

Possible values: >= 4 characters and <= 17 characters

This is the bank account number.

routingNumber stringrequired

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

For USD accounts, this is the 9-digit routing number of the bank.

status string

Possible values: [ACTIVE]

Instrument status.

]

virtualAccountAssignmentStatus

object[]

Array [

instrumentType VirtualInstrumentType (string)required

Possible values: [SEPA_BANK_ACCOUNT, UK_BANK_ACCOUNT, US_BANK_ACCOUNT]

Instrument type.

requestDate date-timerequired

lastChangeDate date-time

status stringrequired

Possible values: [ACCEPTED, PENDING, COMPLETED, REJECTED, FAILED]

Status of the virtual payment instrument request.

statusReason string

Additional information for the current status of the virtual payment instrument request.

]

creationTime date-time
hasVirtualInstrument booleandeprecated
virtualAccountAssignment boolean

Create a virtual banking account for this e-money account.

Example (from schema)

{
  "id": "string",
  "customerId": "5435323362",
  "externalId": "string",
  "currencyCode": "EUR",
  "totalBalance": 0,
  "availableBalance": 0,
  "virtualInstrument": [
    {
      "instrumentType": "SEPA_BANK_ACCOUNT",
      "status": "ACTIVE"
    }
  ],
  "virtualAccountAssignmentStatus": [
    {
      "instrumentType": "SEPA_BANK_ACCOUNT",
      "requestDate": "2019-08-24T14:15:22Z",
      "lastChangeDate": "2019-08-24T14:15:22Z",
      "status": "COMPLETED",
      "statusReason": "Request has been denied by the issuing bank."
    }
  ],
  "creationTime": "2019-08-24T14:15:22Z",
  "virtualAccountAssignment": false
}

ACCOUNT

{
  "id": "509876034",
  "externalId": "42342355",
  "customerId": "5435323362",
  "currencyCode": "GBP",
  "totalBalance": 0,
  "availableBalance": 0,
  "creationTime": "2019-08-24T14:15:22Z",
  "hasVirtualInstrument": false
}

400

Bad Request

application/json

Schema

Schema

error

object

Represents details of an error.

code string

The error code.

message string

The description of the error.

details string[]

Details for the errors of any parameter value.

fieldErrors

object[]

List of field errors associated with the main error.

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

Represents details of an error.

code string

The error code.

message string

The description of the error.

details string[]

Details for the errors of any parameter value.

fieldErrors

object[]

List of field errors associated with the main error.

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

Represents details of an error.

code string

The error code.

message string

The description of the error.

details string[]

Details for the errors of any parameter value.

fieldErrors

object[]

List of field errors associated with the main error.

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...