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
}
Wallet & Billing
Top up wallet
Initialize a wallet top-up via Paystack.
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
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
Redirect the user toauthorizationUrl to pay via Paystack, then call the verify endpoint with the reference to confirm payment and credit the wallet.