Quickstart

POST /wallets
Content-Type: application/json
Authorization: Bearer <token>

{
  "currency": "USD",
  "country_iso_code": "US"
}

GET /wallets
Authorization: Bearer <token>

curl -X GET "$BASE_URL/wallets" -H "Authorization: Bearer $API_KEY"

[
  {
    "id": "wlt_123",
    "currency": "USD",
    "balance": 150.25,
    "created_at": "2025-10-01T12:00:00Z"
  }
]

POST /wallets/fund
Content-Type: application/json
Authorization: Bearer <token>

{
  "userId": "<userId>",
  "walletId": "<walletId>",
  "amount": 10000,
  "phone": "+2376xxxxxxx",
  "operator": "ORANGE",
  "currency": "XAF"
}

POST /wallets/deposit
Content-Type: application/json
Authorization: Bearer <token>

{
  "sourceWallet": {
    "id": "<walletIdXAF>",
    "currency": "XAF",
    "amount": 10000,
    "feeAmount": 0,
    "totalAmount": 10000
  },
  "destinationWallet": {
    "id": "<walletIdUSD>",
    "currency": "USD",
    "amount": 15
  },
  "exchangeRate": {
    "rate": 650,
    "fromCurrency": "XAF",
    "toCurrency": "USD"
  }
}

curl -X POST "$BASE_URL/wallets/deposit" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d @payload.json

GET /wallet/transactions/wallet/<walletId>
Authorization: Bearer <token>

POST /customers
Content-Type: application/json
Authorization: Bearer <token>

{
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane@example.com",
  "phone_number": "+2376xxxxxxx",
  "country_iso_code": "CM"
}