Skip to main content
POST
/
api
/
v1
/
wallets
/
fiat
/
create
Create Wallet
curl --request POST \
  --url https://api.example.com/api/v1/wallets/fiat/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "customerId": "<string>",
  "walletName": "<string>",
  "walletReference": "<string>"
}
'
{
  "success": true,
  "message": "Fiat wallet created successfully",
  "data": {
    "walletId": "wal_abc123xyz",
    "bankName": "Wema Bank",
    "bankCode": "035",
    "accountNumber": "1234567890"
  }
}

​
Request

​
x-api-key
string
required
API Key for authentication
​
customerId
string
required
Unique identifier for the customer
​
walletName
string
required
Name of the wallet
​
walletReference
string
required
Reference for the wallet

​
Request Example

curl -X POST https://api-staging.fossapay.com/api/v1/wallets/fiat/create \
  -H "x-api-key: fp_live_sk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cus_123456789",
    "walletName": "Main Wallet",
    "walletReference": "wallet_ref_001"
  }'

const response = await fetch('https://api-staging.fossapay.com/api/v1/wallets/fiat/create', {
  method: 'POST',
  headers: {
    'x-api-key': 'fp_live_sk_xxxxxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customerId: 'cus_123456789',
    walletName: 'Main Wallet',
    walletReference: 'wallet_ref_001'
  })
});

const data = await response.json();
const wallet = data.data;

import requests

url = "https://api-staging.fossapay.com/api/v1/wallets/fiat/create"
headers = {
    "x-api-key": "fp_live_sk_xxxxxxxx",
    "Content-Type": "application/json"
}
data = {
    "customerId": "cus_123456789",
    "walletName": "Main Wallet",
    "walletReference": "wallet_ref_001"
}

response = requests.post(url, headers=headers, json=data)
data = response.json()
wallet = data["data"]

​
Response

​
success
boolean
Indicates if the request was successful
​
message
string
Human-readable response message
​
data
object

​
Response Example

{
  "success": true,
  "message": "Fiat wallet created successfully",
  "data": {
    "walletId": "wal_abc123xyz",
    "bankName": "Wema Bank",
    "bankCode": "035",
    "accountNumber": "1234567890"
  }
}

​
Error Codes

CodeDescription
INVALID_CUSTOMERCustomer ID is invalid
MISSING_FIELDSRequired fields are missing
UNAUTHORIZEDInvalid API key or insufficient permissions
Rate Limit: 100 requests per minute
Store the walletId in your database for future reference and transaction matching.