Deposit real money into an app user wallet

post

https://megsapp-nova-stg.85.group/api/v1/app-users/{appUserUuid}/app-user-wallet/deposits

Allows partner-portal operators to start a productless wallet deposit flow for a selected app user. The selected app user must already have an active wallet account.

Access: Auth methods: JWT bearer. Allowed user types: MVNO, PARTNER. Requires permissions: purchase:admin.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

appUserUuid

string

required

App user UUID

Body Params

amount

number

required

1 to 5000

Deposit amount in major currency units.

paymentMethod

string

enum

required

Real-money payment method to fund the wallet. Voucher, airtime, promo, and wallet-funded deposits are not supported.

Allowed:

metadata

object

Payment-method specific data. ECENTRIC_CARD requires metadata.cardToken and may include metadata.scenario / metadata.cvv. Ozow may include customerEmail, customerMobile, or selectedBankId. Nova derives Ozow mode and return URLs server-side.

paymentInput

object

Ephemeral digital-wallet payment payload. Required when paymentMethod is GOOGLE_PAY or APPLE_PAY. Never persisted.

threeDS

object

Transaction-bound 3DS browser context. Supported only for ECENTRIC_CARD; Nova derives browser IP and fixes threeDSCompInd.

Headers

Idempotency-Key

string

required

Client-generated UUID v4. Reuse the same key only when retrying the exact same wallet top-up request.

Responses

201

Wallet deposit initiated

400

Invalid deposit request

404

App user not found

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200