Deposit real money into the current app user wallet

post

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

Starts a wallet deposit flow using the same real-money payment rails as customer airtime/data purchases. Voucher-to-wallet, wallet-funded, airtime-funded, and promo-funded deposits are intentionally excluded.

Access: Auth methods: JWT bearer. Allowed user types: APP_USER. Requires permissions: purchase:write.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

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 deposit request.

Responses

201

Wallet deposit initiated

400

Invalid deposit request

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