---
title: "Create an explicit Wallet Credits top-up by saved card or invoice."
method: POST
path: "/v2/wallet/topup"
tags: ["Wallet"]
---

# Create an explicit Wallet Credits top-up by saved card or invoice.

`POST /v2/wallet/topup`

## Request

- Base URL: `https://api.omtx.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.omtx.ai/v2/wallet/topup`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- object: Create an explicit Wallet Credits top-up by saved card or invoice.
  - `amount_cents` integer, required: USD-cent amount to add. Saved-card top-ups use the authenticated profile's wallet card-funding limit; invoice top-ups use $500 increments.
  - `payment_mode` 'saved_card' | 'pay_invoice', required
  - `invoice_buyer` WalletInvoiceBuyer (unresolved $ref)
  - `funding_operation_id` string, nullable: The operation returned by wallet_topup_prepare; required for saved_card.
  - `user_approval_confirmation` string, required: Exact user approval text. For saved_card use 'I approve adding $<amount> Wallet Credits by saved card for funding operation <id>.'. For pay_invoice use 'I approve creating a $<amount> Wallet Credits invoice.'.

## Response `200`

Successful Response

- unknown

---

[API](https://skmtc.dev/omtx/apis/gateway.md) - [All operations](https://skmtc.dev/omtx/apis/gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/omtx/apis/gateway/revisions/232715a75205?raw)