Create transaction

Create a new PURCHASE transaction record for non-wallet payment flows. SALE-direction product fulfilment must use the sales endpoints so Nova can debit the seller merchant account and orchestrate fulfilment.

Access: Auth methods: JWT bearer. Requires permissions: transaction:write.

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

transactionTypeId

string
required

accountId

number
required

Transaction amount in ZAR

string
enum
required

Transaction direction. Use PURCHASE here; SALE fulfilment is orchestrated through the sales endpoints so Nova can debit the seller merchant account and fulfil the product.

Allowed:
string
enum
required

High-level payment category

Allowed:
string
enum
required

Specific payment method used

string
enum

Payment gateway or provider (e.g., PAYGATE, ECCENTRIC, OZOW)

Allowed:
string

Payment reference from payment provider

string

productId

string

productName

string

sellingPartnerId

string

sellingAgentPartnerId

string

thirdPartyProviderId

string
required

channel

string

externalReference

string

totogiReference

Responses

400

Invalid transaction data, wrong direction for caller role, or direct SALE creation attempted

404

Transaction type, account, or product not found

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json