💰Add Funds

Use this endpoint to request a payment URL that can be used to add funds to a Merchant Account. Note the reference number, this number must be provided to the DigiMali admin to verify the funds.

An optional Call Back Url can be provided to be routed to after making payment.

post

This endpoint generates a payment URL for a user to complete a transaction. The request requires an API token in the header and an amount in the request body. Optionally, a callback URL can be provided.

Header parameters

AuthorizationstringRequired

Secret Token for user authentication

Example: {"value":"Token tk-abcdef-uhhgggggf-yygfff"}

Body

application/json

amountnumber · float · min: 1 · max: 1000000Required

Amount to be charged (minimum 1, maximum 1,000,000, precision: 2 decimal places)

Example: 2100

call_back_urlstring · uriOptional

Optional callback URL to redirect users after payment

Example: https://digimali.co.za

Responses

200

Payment URL generated successfully

application/json

400

Invalid request parameters or failed to generate payment URL

application/json

500

Internal server error

application/json

post

/api/v1/payment/request

HTTPcURLJavaScriptPython

POST /api/v1/payment/request HTTP/1.1
Host: stage-api.digimali.co.za
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "amount": 2100,
  "call_back_url": "https://digimali.co.za"
}

{
  "payment_url": "https://checkout.paystack.com/psew5l79svz50yl",
  "reference": "some-id-string"
}