Skip to main content
POST
/
api
/
v3
/
wallet
/
fiat
Create a Fiat Wallet
curl --request POST \
  --url https://sandbox-api.kotanipay.io/api/v3/wallet/fiat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Wallet",
  "currency": "eg NGN or GHS or KES",
  "country": "GH or GHA for Ghana"
}
'
{
  "success": true,
  "message": "Fiat wallet has been successfully created.",
  "data": {
    "name": "My Wallet",
    "type": "eg crypto or fiat",
    "currency": "eg NGN or GHS or KES",
    "integrator": "4440cb6a-f7c7-11ed-b67e-0242ac120002",
    "id": "f053188c-d924-4423-bbba-871eda0b1cd9",
    "balance": 1000,
    "deposit_balance": 1000,
    "country": "GH or GHA for Ghana",
    "status": "eg active or inactive"
  }
}
Create a new fiat wallet for a specific currency. Each integrator can have multiple fiat wallets for different currencies.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

The name of the wallet

Example:

"My Wallet"

​
currency
enum<string>
required

The currency of the wallet

Available options:
KES,
GHS,
NGN,
ZAR,
ZAR,
USD,
XOF,
ZMW,
XAF,
SLE,
CDF,
TZS,
UGX,
EGP,
MWK,
RWF,
ETB,
MZN,
LSL,
GNF,
USDT,
BTC,
ETH,
USDC
Example:

"eg NGN or GHS or KES"

​
country
string

The country where the wallet will be used (accepts both ISO-2 and ISO-3 codes)

Example:

"GH or GHA for Ghana"

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Fiat wallet has been successfully created."

​
data
object