Initiate a bill-payment sale

post

https://megsapp-nova-stg.85.group/api/v1/sales/marketplace/bill-payments

SALE-direction bill-payment flow funded by a seller merchant account. Partner callers infer the seller from the JWT. MVNO callers omit sellingPartnerUuid to sell from the MVNO default merchant account, or supply sellingPartnerUuid to sell on behalf of a partner. The customer account number and amount are supplied inline; provider-specific biller details are derived from the selected product.

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

productUuid

string

required

Bill-payment product UUID

accountNumber

string

required

Customer account number for the selected biller. For Flash products, Nova generates the accountReference from the product biller code plus this value.

amount

number

required

Payment amount in Rand. Nova sends Flash bill-payment values in cents.

sellingPartnerUuid

string

Selected selling partner UUID. Partner callers infer this from the JWT. MVNO callers omit it to sell from the MVNO default merchant account, or supply it to sell on behalf of a partner.

sellingAgentUuid

string

Agent record UUID for partner commission attribution. Requires sellingPartnerUuid for MVNO callers and must belong to the selling partner.

Headers

Idempotency-Key

string

required

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

Responses

201

Bill-payment sale initiated

400

Invalid input

Language

Credentials

URL

Loading…

Response

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

application/json

200