Skip to main content
POST
/
v1
/
wms
/
wallets
/
{walletId}
/
submit-deposit
Submit & verify a wallet deposit
curl --request POST \
  --url https://{baasHost}/api/v1/wms/wallets/{walletId}/submit-deposit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "gatewayReference": "MPESA-DEF456UVW",
  "amount": 50000,
  "fspId": "CLICKPESA",
  "description": "Deposit via partner gateway"
}
'

Authorizations

​
Authorization
string
header
required

Bearer token from POST /generate-token. Expires ~1h; on 401, re-generate and retry once.

Path Parameters

​
walletId
string<uuid>
required

Body

application/json
​
gatewayReference
string
required

Idempotency key.

​
amount
number
required

Amount.

​
fspId
string
Example:

"CLICKPESA"

​
description
string

Response

200

Verified and credited