API Reference
Client Login
  1. LEDGER API
  2. Accounts

Create account

post
https://api.uat.paymentology.com/pty/account/v1/pws_create_account
  • Ledger API version of the PWS Create account V2 call. Request and response use the same format, served by the Ledger API.
  • All accounts sit in an account hierarchy: ac_parent_id is required and the new account becomes its child.
  • Use program_code to assign the account to a program.
Body Params
string
required
length between 0 and 3

Billing currency (Three digit ISO-4217 currency code, e.g. 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

Settlement currency (Three digit ISO-4217 currency code, e.g. 048=BHD, 060=BMD, 036=AUD)

string
required
length between 0 and 50

Account holder name

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. Must be a correct product id so the account inherits required properties and links with business.

int32
enum

Account hierarchy level (charge card programs only):
2=Master client account level
3=Corporate parent account
4=Department account
5=Customer parent account
6=Customer account

Allowed:
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
length between 0 and 50

Branch name

string

Program code for the account. When provided, program_id is ignored. Defaults to the configured default program code if neither is provided.

int64
deprecated

Deprecated. Use program_code instead. Ignored when program_code is provided. Program ID for the account. Must be one of the configured program IDs.

Responses

401

Missing or invalid access token. Empty body.

403

Access token rejected by the API gateway (for example, expired).

Updated 1 day ago

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

Updated 1 day ago

Did this page help you?