Create account V2

post

https://uat.banking.live:55555/ppws/api/pws/v2/pws_create_account/

Allows to create an account in the Paymentology ledger.
The user can, optionally, create an external reference for this account should they require.
All accounts must sit within an account hierarchy in the ledger. This means that a parent account must be provided by the user.
The new account is then a child of the parent account.

Version 2 create account api support idempotency;

This hierarchy is beneficial to the user as it allows accounts to be related as wallets and allows for reporting at multiple hierarchy levels.

Body Params

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

length between 0 and 3

Billing currency (Three digit ISO_4217 standard currency code . i.e. : 048 → BHD, 060 → BMD, 036 → AUD).

ac_parent_id

int64

required

≥ 1

Parent account. Newly created accounts under a parent account will have parent child hierarchy.

ac_set_ccy

string

required

length between 0 and 3

Settlement currency (Three digit ISO-4217 standard currency code . i.e. : 048 → BHD, 060 → BMD, 036 → AUD).

account_name

string

enum

required

length between 0 and 50

account holder name.

Allowed:

api_call_unique_identifier

string

required

length between 1 and 40

Unique number that must be passed at each API request. Identifier to make each API request unique

client_id

int32

required

≥ 1

Unique identifier for the client which Paymentology will provide at outset

user_id

string

length between 0 and 50

User Id of the Customer who triggered the API request.

remarks

string

length between 0 and 200

Remarks for API request

ac_desc

string

length between 0 and 100

Description for the account holder.

ac_ext_ref

string

length between 0 and 50

account external reference.

crd_prdct_id

int32

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

int32

Account hierarchy is only applicable to charge card programs.

2 = Master client account level
3 = Corporate parent account
4 = Department account
5 = Customer parent account
6 = Customer account

cu_id

int64

Customer Id to link the newly created account to the provided customer. You can get customer id after creating customer using pws_create_customer

branch_name

string

enum

length between 0 and 50

branch name.

Allowed:

Responses

404

Webservices does not exist

500

Internal Server error

200Successful Response