Create business account

POST /api/v1/BusinessAccounts/create

Description

This endpoint allows you to create a business account.

Request

• Path Parameters:

  • version: API version (string)

• Headers:

  • Accept-Language: Change default response message language from English(en). Available languages fr,en

• Request Body:

  • CreateAccountRequest: Represents the request to create a business account (object)

Responses

• 200: Success. Returns a BusinessAccountResponse.

• 400: Bad Request. The request is not valid.

• 404: Not Found. The requested resource was not found.

Examples

Request

httpCopy codePOST /api/v{version}/BusinessAccounts/create HTTP/1.1
Host: example.com
Accept-Language: en
Content-Type: application/json
{
  "name": "Example Business",
  "industry": "Technology",
  "email": "example@example.com",
  "phone": "+123456789",
  "address": {
    "street": "123 Example Street",
    "city": "Exampleville",
    "state": "Ex",
    "country": "Exampleland",
    "zip": "12345"
  }
}

Response

httpCopy codeHTTP/1.1 200 OK
{
  "accountId": "1234",
  "name": "Example Business",
  "industry": "Technology",
  "email": "example@example.com",
  "phone": "+123456789",
  "address": {
    "street": "123 Example Street",
    "city": "Exampleville",
    "state": "Ex",
    "country": "Exampleland",
    "zip": "12345"
  },
  "status": "ACTIVE",
  "createdDate": "2024-02-16T09:00:00Z"
}

Error Response

httpCopy codeHTTP/1.1 404 Not Found
{
  "message": "Resource not found."
}

/api/v1/BusinessAccounts/create

Headers

Content-Type	Value
Accept-Language

Headers

Content-Type	Value
Content-Type	application/json

Headers

Content-Type	Value
Accept	text/plain

Body (raw)

{
  "businessId": <uuid>,
  "productId": <string>,
  "accountBIC": <string>,
  "accountType": <string>,
  "accountName": <string>,
  "accountPurpose": <string>,
  "currency": <string>
}

Response: 200

{
  "succeeded": <boolean>,
  "message": <string>,
  "errors": [
    <string>,
    <string>
  ],
  "data": {
    "id": <uuid>,
    "businessId": <uuid>,
    "accountId": <string>,
    "accountBIC": <string>,
    "accountName": <string>,
    "accountType": <string>,
    "currency": <string>,
    "availableBalance": <double>,
    "accountLimit": <double>,
    "statusDescription": <string>,
    "created": <dateTime>,
    "nubanOrIban": <string>,
    "purpose": <string>,
    "status": <string>,
    "productId": <string>,
    "clientId": <string>,
    "productName": <string>
  }
}

Response: 400

{
  "succeeded": <boolean>,
  "message": <string>,
  "errors": [
    <string>,
    <string>
  ],
  "data": <string>
}

Response: 404

{
  "succeeded": <boolean>,
  "message": <string>,
  "errors": [
    <string>,
    <string>
  ],
  "data": <string>
}