Skip to main content
POST
/
v1
/
wallet
/
topup
curl -X POST https://api.vouchmark.com/v1/wallet/topup \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amountKobo": 5000000}'

{
  "success": true,
  "authorizationUrl": "https://checkout.paystack.com/...",
  "accessCode": "...",
  "reference": "...",
  "amountKobo": 5000000,
  "vatKobo": 375000,
  "totalKobo": 5375000
}
Creates a payment initialization for topping up your wallet. Returns a Paystack authorization URL to redirect the user for payment.
The request body and this response are in kobo (1 NGN = 100 kobo). VAT is added on top of the requested amount.

​
Body

​
amountKobo
integer
required
Amount to top up, in kobo.
curl -X POST https://api.vouchmark.com/v1/wallet/topup \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amountKobo": 5000000}'

{
  "success": true,
  "authorizationUrl": "https://checkout.paystack.com/...",
  "accessCode": "...",
  "reference": "...",
  "amountKobo": 5000000,
  "vatKobo": 375000,
  "totalKobo": 5375000
}

​
Response fields

​
success
boolean
​
authorizationUrl
string
Redirect the user here to pay via Paystack.
​
accessCode
string
​
reference
string
Pass this to the verify endpoint after the redirect.
​
amountKobo
integer
Base amount in kobo.
​
vatKobo
integer
VAT in kobo.
​
totalKobo
integer
Total charged in kobo (amountKobo + vatKobo).
Redirect the user to authorizationUrl to pay via Paystack, then call the verify endpoint with the reference to confirm payment and credit the wallet.