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.

نظرة سريعة

المصادقة: رمز موظّف أو جلسة
تتطلب صلاحية: prm_managers_deposit Deposit to manager wallet
حد المعدل: t_mutate
مفتاح عدم التكرار: request_id

المعاملات

المعامل	الوصف
`id`مطلوب path · integer	Manager id. May not be the caller themselves.
`amount`مطلوب body · number	Major units, a bare JSON number.
`request_id`مطلوب 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.

الأخطاء

الرمز	متى تُرجَع
`ERR_CONFLICT`409	the request_id is already held by a different ledger line

الطلب

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 هو عنوان مؤسستك: نفس العنوان الذي تسجّل الدخول منه.

جرّبه على شبكتك.

50 مشترك لمدة 7 أيام، من غير ما تدفع حاجة.

جرّب ببلاش كلّمنا