Create Wallet
POST /api/payments/create-balance
Create Balance / Wallet in the Pesawise system
Header Parameters
- api-key string required
- api-secret string required
- application/json
Request Body required
- currency string required
Currency for the balance
- name string required
Name for the balance
- accountType string required
Possible values: [
CLIENT_ACCOUNT
,CLIENT_VIRTUAL_ACCOUNT
,CLIENT_SHARED_ACCOUNT
,CLIENT_HYBRID_ACCOUNT
]Type of the account.
- 200
- 400
Balance created
Response Headers
x-request-id any
Request Id for traceability
- */*
- Schema
- Example (from schema)
Schema
- status string required
Possible values: [
SUCCESS
,FAILED
,API_KEYS_INVALID
,INSUFFICIENT_FUNDS
,NOT_FOUND
,MALFORMED_URL
,INTERNAL_ERROR
,NOT_SUPPORTED
,CURRENCY_NOT_SUPPORTED
,MOBILE_MONEY_NOT_WHOLE_NUMBER
,BALANCE_NOT_FOUND
,BALANCE_NOT_AUTHORISED
,BALANCE_NOT_NUMERIC
,WEB_HOOK_NOT_SPECIFIED_FOR_OTP
,TOKEN_RESENT
,CLIENT_SIDE_ERROR
]Status code
- detail string
Detail of the message.
balance object
status string requiredPossible values: [
SUCCESS
,FAILED
,API_KEYS_INVALID
,INSUFFICIENT_FUNDS
,NOT_FOUND
,MALFORMED_URL
,INTERNAL_ERROR
,NOT_SUPPORTED
,CURRENCY_NOT_SUPPORTED
,MOBILE_MONEY_NOT_WHOLE_NUMBER
,BALANCE_NOT_FOUND
,BALANCE_NOT_AUTHORISED
,BALANCE_NOT_NUMERIC
,WEB_HOOK_NOT_SPECIFIED_FOR_OTP
,TOKEN_RESENT
,CLIENT_SIDE_ERROR
]Status code
id int64 requiredUnique identifier of the balance.
balanceName string requiredBalance name.
balanceAmount double requiredAmount held for this balance.
bankAccountNumber stringBank Account Number
branchCode stringBranch Code
bankName stringBank Name
bankCode stringBank Code
active boolean
{
"status": "SUCCESS",
"detail": "API key not valid or Internal error",
"balance": {
"status": "SUCCESS",
"id": 100121,
"balanceName": "Jamal's KES balance",
"balanceAmount": 12332.11,
"bankAccountNumber": "8000010000150",
"branchCode": "118",
"bankName": "Pesawise Bank",
"bankCode": "0001",
"active": true
}
}
Error occurred - bad request
- */*
- Schema
- Example (from schema)
Schema
- status string required
Possible values: [
SUCCESS
,FAILED
,API_KEYS_INVALID
,INSUFFICIENT_FUNDS
,NOT_FOUND
,MALFORMED_URL
,INTERNAL_ERROR
,NOT_SUPPORTED
,CURRENCY_NOT_SUPPORTED
,MOBILE_MONEY_NOT_WHOLE_NUMBER
,BALANCE_NOT_FOUND
,BALANCE_NOT_AUTHORISED
,BALANCE_NOT_NUMERIC
,WEB_HOOK_NOT_SPECIFIED_FOR_OTP
,TOKEN_RESENT
,CLIENT_SIDE_ERROR
]Status code
- detail string
Detail of the message.
balance object
status string requiredPossible values: [
SUCCESS
,FAILED
,API_KEYS_INVALID
,INSUFFICIENT_FUNDS
,NOT_FOUND
,MALFORMED_URL
,INTERNAL_ERROR
,NOT_SUPPORTED
,CURRENCY_NOT_SUPPORTED
,MOBILE_MONEY_NOT_WHOLE_NUMBER
,BALANCE_NOT_FOUND
,BALANCE_NOT_AUTHORISED
,BALANCE_NOT_NUMERIC
,WEB_HOOK_NOT_SPECIFIED_FOR_OTP
,TOKEN_RESENT
,CLIENT_SIDE_ERROR
]Status code
id int64 requiredUnique identifier of the balance.
balanceName string requiredBalance name.
balanceAmount double requiredAmount held for this balance.
bankAccountNumber stringBank Account Number
branchCode stringBranch Code
bankName stringBank Name
bankCode stringBank Code
active boolean
{
"status": "SUCCESS",
"detail": "API key not valid or Internal error",
"balance": {
"status": "SUCCESS",
"id": 100121,
"balanceName": "Jamal's KES balance",
"balanceAmount": 12332.11,
"bankAccountNumber": "8000010000150",
"branchCode": "118",
"bankName": "Pesawise Bank",
"bankCode": "0001",
"active": true
}
}