Skip to main content
GET
/
v1
/
wallet
/
topup
/
verify
curl "https://api.vouchmark.com/v1/wallet/topup/verify?reference=..." \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "message": "Wallet topped up successfully",
  "wallet": {
    "balanceKobo": 5000000,
    "paymentThresholdKobo": 1000000,
    "autoTopUp": {
      "enabled": true,
      "triggerBelowKobo": 500000,
      "rechargeAmountKobo": 10000000
    },
    "hasSavedCard": true,
    "currency": "NGN"
  },
  "transaction": {
    "id": "...",
    "referenceNumber": "...",
    "amountKobo": 5000000,
    "vatKobo": 375000,
    "totalAmountKobo": 5375000,
    "status": "successful",
    "type": "top_up",
    "paymentMethod": "Paystack",
    "createdAt": "2026-05-18T10:00:00Z"
  }
}
Call this after the Paystack redirect to confirm payment and credit the wallet. The operation is idempotent — calling it again for an already-credited reference returns success without double-crediting.
The returned wallet reports amounts in integer kobo, and the returned transaction reports amounts in integer kobo (matching List transactions). 1 NGN = 100 kobo.

​
Query parameters

​
reference
string
required
The reference returned by Top up wallet.
curl "https://api.vouchmark.com/v1/wallet/topup/verify?reference=..." \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "message": "Wallet topped up successfully",
  "wallet": {
    "balanceKobo": 5000000,
    "paymentThresholdKobo": 1000000,
    "autoTopUp": {
      "enabled": true,
      "triggerBelowKobo": 500000,
      "rechargeAmountKobo": 10000000
    },
    "hasSavedCard": true,
    "currency": "NGN"
  },
  "transaction": {
    "id": "...",
    "referenceNumber": "...",
    "amountKobo": 5000000,
    "vatKobo": 375000,
    "totalAmountKobo": 5375000,
    "status": "successful",
    "type": "top_up",
    "paymentMethod": "Paystack",
    "createdAt": "2026-05-18T10:00:00Z"
  }
}

​
Response fields

​
success
boolean
​
message
string
Wallet topped up successfully on first verification, or Payment already processed if the reference was already credited.
​
wallet
object
Full wallet DTO as in Get wallet (values in integer kobo).
​
transaction
object
One transaction DTO as in List transactions (values in integer kobo).