---
title: "Create Account"
method: POST
path: "/pws/v2/pws_create_account/"
tags: ["Account V2"]
---

# Create Account

`POST /pws/v2/pws_create_account/`

<ul>
<li class="docBullet">Allows to create an account in the Paymentology ledger.</li>
<li class="docBullet">The user can, optionally, create an external reference for this account should they require.</li>
<li class="docBullet">All accounts must sit within an account hierarchy in the ledger. This means that a parent account must be provided by the user.</li>
<li class="docBullet">The new account is then a child of the parent account.</li>
<p>Version 2 create account api support idempotency;</p>
<li class="docBullet">This hierarchy is beneficial to the user as it allows accounts to be related as wallets and allows for reporting at multiple hierarchy levels.</li>
</ul>

## Request body

- CreateAccountModel — -- This web service creates accounts. -- All accounts are created under a Banking.Live parent account. --The accounts will have a parent child hierarchy. -- An account is created for a card automatically once a new card is created, unless a pre-existing account is designated.
  - `ac_bill_ccy` string, required — Billing currency (Three digit ISO_4217 standard currency code . i.e. : 048 → BHD, 060 → BMD, 036 → AUD).
  - `ac_parent_id` integer, required — Parent account. Newly created accounts under a parent account will have parent child hierarchy.
  - `ac_set_ccy` string, required — Settlement currency (Three digit ISO-4217 standard currency code . i.e. : 048 → BHD, 060 → BMD, 036 → AUD).
  - `account_name` 'range[-infinity, 50]', required — account holder name.
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request
  - `ac_desc` string — Description for the account holder.
  - `ac_ext_ref` string — account external reference.
  - `crd_prdct_id` integer — Card product id. (Need to input correct product id for your card so it will inherit full required properties and be fully linked with business.)
  - `ac_level` integer — Account hierarchy is only applicable to charge card programs. <ul> <li class="docBullet">2 = Master client account level</li> <li class="docBullet">3 = Corporate parent account</li> <li class="docBullet">4 = Department account</li> <li class="docBullet">5 = Customer parent account </li> <li class="docBullet">6 = Customer account</li></ul>
  - `cu_id` integer — Customer Id to link the newly created account to the provided customer. You can get customer id after creating customer using <a href="#operation/pws_create_customer" class="external-link">pws_create_customer</a>
  - `branch_name` 'range[-infinity, 50]' — branch name.

## Response `200`

Successful Response

- CreateAccountResponse — This is create account response model
  - `header` CreateAccountHeader
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` CreateAccountBody
    - `ac_id` integer — Newly Created account ID.

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)