Skip to main content
POST
/
v1
/
wms
/
wallets
/
{walletId}
/
reserve
Reserve funds (escrow hold)
curl --request POST \
  --url https://{baasHost}/api/v1/wms/wallets/{walletId}/reserve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 15000,
  "currency": "TZS",
  "reference": "ORDER-2026-001",
  "description": "Hold for merchant delivery"
}
'
{
  "transactionId": "tx-uuid-..."
}

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
amount
number
required

Amount.

currency
string
required
Example:

"TZS"

reference
string

Your order reference.

description
string

Response

200 - application/json

Hold placed