Admin fund organisation wallet
Directly credit an organisation wallet with a specified amount. Creates a complete DEPOSIT transaction record (no payment gateway involved). Admin only.
/v1/payments/admin/fund/{organisationId}Authorization
bearer In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/payments/admin/fund/string" \ -H "Content-Type: application/json" \ -d '{ "amount": 5000 }'{ "success": true, "statusCode": 200, "message": "Request processed successfully", "timestamp": "2025-10-20T16:30:00.000Z", "path": "/v1/auth/register", "data": { "transactionId": "clx123abc", "reference": "ADMIN-FUND-1711500000000-abc123", "amount": 5000, "currency": "NGN", "status": "SUCCESS", "newBalance": 12500, "organisationId": "org_clx456def", "fundedAt": "2019-08-24T14:15:22Z" }}Admin Verify payment
Verify a payment transaction and credit wallet if successful. This endpoint is for admins and skips organisation permission checks.
Admin adjust / clawback organisation wallet (audited)
Signed, audited wallet adjustment — the single sanctioned manual mutation path (ADR-013). Positive amount credits; negative amount debits/claws back. Writes a transactions row, journals a wallet_ledgers entry (operationId adj:<ref>, with reason + adjustedBy), updates the durable Postgres balance and syncs the Redis mirror — replacing raw Redis/SQL edits. A reason is mandatory; adjustments above WALLET_ADJUST_APPROVAL_THRESHOLD require a secondApprover. Admin only.