API Explorer
Client Login

Create account

post
https://uat.banking.live:55555/ppws/api/pws/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.
  • 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.

string
required
length between 0 and 3
^[0-9]{3}$

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

int64
required
≥ 1

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

string
required
length between 0 and 3
^[0-9]{3}$

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

string
enum
required
length between 0 and 50

account holder name.

Allowed:
string
required
length between 1 and 40

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

int32
required
≥ 1

Unique identifier for the client which Paymentology will provide at outset

string
length between 0 and 50

User Id of the Customer who triggered the API request.

string
length between 0 and 200

Remarks for API request

string
length between 0 and 100

Description for the account holder.

string
length between 0 and 50

account external reference.

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

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

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

string
enum
length between 0 and 50

branch name.

Allowed:
Responses

404

Webservices does not exist

500

Internal Server error

Updated 7 months ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 months ago

Did this page help you?