---
title: "Top up or void credits"
method: POST
path: "/api/wallets/transactions"
tags: ["Wallets"]
---

# Top up or void credits

`POST /api/wallets/transactions`

Add paid/granted credits or void existing credits from a wallet.

## Request body

- TopUpWalletDto
  - `walletId` string, required
  - `paidCredits` number — Paid credits to purchase
  - `grantedCredits` number — Free credits to grant
  - `voidedCredits` number — Credits to void
  - `metadata` object

## Response `201`

Transaction(s) created

- TopUpResponse
  - `transactions` WalletTransactionResponse[], required
    - `id` string, required
    - `walletId` string, required
    - `transactionType` 'INBOUND' | 'OUTBOUND', required
    - `status` 'PENDING' | 'SETTLED' | 'FAILED', required
    - `transactionStatus` 'PURCHASED' | 'GRANTED' | 'VOIDED' | 'INVOICED', required
    - `creditAmount` string, required — Credits added or deducted
    - `amount` string, required — Monetary equivalent
    - `invoiceId` string
    - `settledAt` string
    - `metadata` object
    - `createdAt` string, required
  - `wallet` WalletResponse, required
    - `id` string, required
    - `customerId` string, required
    - `name` string
    - `currency` string, required
    - `rateAmount` string, required — 1 credit = rateAmount in currency
    - `creditsBalance` string, required — Available credits
    - `balance` string, required — Monetary equivalent of credits
    - `consumedCredits` string, required — Lifetime consumed credits
    - `consumedAmount` string, required — Lifetime consumed amount
    - `status` 'ACTIVE' | 'TERMINATED', required
    - `expirationAt` string
    - `terminatedAt` string
    - `customer` WalletCustomerResponse
      - `id` string, required
      - `name` string, required
      - `email` string, required
    - `metadata` object
    - `createdAt` string, required
    - `updatedAt` string, required

---

[API](https://skmtc.net/novabilling/apis/novabilling-api.md) · [All operations](https://skmtc.net/novabilling/apis/novabilling-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novabilling/novabilling-api/versions/0e449a4e0dc8/schema)