API Reference
  1. MVNO
  2. Purchases

Initiate a cellular purchase for a specified app user

post
https://megsapp-nova-stg.85.group/api/v1/purchases/marketplace/cellular

MVNO SUPER_ADMIN marketplace cellular flow for MOBILE_AIRTIME, MOBILE_DATA, MOBILE_SMS, or MOBILE_VOICE products. The customer app user must be supplied explicitly and pays from MY_WALLET. Fulfilment routes by the selected product vendor. App-user JWT callers must use POST /app-user/purchases/marketplace/cellular.

Access: Auth methods: JWT bearer or API key. Allowed user types: MVNO. Requires permissions: purchase:admin. Allowed MVNO roles: SUPER_ADMIN.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Marketplace cellular product UUID

string
required

Recipient mobile number for the selected airtime product. Local SA numbers are normalised to 27-prefixed digits.

number

Payment amount in Rand. Required for flexible-price airtime products; ignored for fixed-price products.

string
required

Customer's app_user UUID. Required on the standard purchase route; app-user self-service purchases infer this from the JWT.

Headers
string
required

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

Responses

201

Cellular airtime purchase initiated

400

Invalid input

Updated 3 months ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?