Credit a manager wallet

POST /api/v1/managers/{id}/wallet/deposit prm_managers_deposit

Moves money into a reseller's wallet and posts the matching ledger entry. Idempotent on request_id through the ledger's own unique constraint.

issue_invoice defaults differently here than on the subscriber wallet. Omitting it on a manager deposit issues the document; omitting it on a subscriber deposit does not. Send it explicitly if you care either way.

At a glance

Authentication: Staff token or session
Requires permission: prm_managers_deposit Deposit to manager wallet
Rate limit: t_mutate
Idempotency key: request_id

Parameters

Parameter	Description
`id`required path · integer	Manager id. May not be the caller themselves.
`amount`required body · number	Major units, a bare JSON number.
`request_id`required body · string	Idempotency key.
`reason` body · string	Free-text note recorded on the ledger row.
`issue_invoice` body · boolean	Also record the human-facing accounting document. Defaults to TRUE when omitted on the manager side, unlike the subscriber side.

Errors

Code	When it is returned
`ERR_CONFLICT`409	the request_id is already held by a different ledger line

Request

curl -X POST "$BASE/api/v1/managers/{id}/wallet/deposit" \
  -H "Authorization: Bearer $XR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "amount": 5000.00,
  "reason": "bank transfer 2026-09-20",
  "request_id": "e1a7b204-1c4f-4a2e-8d66-90b3f7c1d452"
}'

BASE is your tenant host: the same address you sign in on.

Try it on your own network.

50 subscribers for 7 days. You pay nothing.

Try it free Talk to us