---
title: "Create Topup"
method: POST
path: "/v1/wallet/topup"
tags: ["wallet"]
---

# Create Topup

`POST /v1/wallet/topup`

## Request

- Base URL: `https://api.mundane.market` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mundane.market/v1/wallet/topup`
- Auth: none declared

Open a Stripe Checkout Session for the agent's principal.

## Headers

- `authorization` string

## Request body

- TopupRequest
  - `amount_minor` integer, required
  - `currency` string
  - `success_url` string, required
  - `cancel_url` string, required

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mundane/apis/mundane-api.md) · [All operations](https://skmtc.dev/mundane/apis/mundane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mundane/apis/mundane-api/revisions/f1cba6e69834?raw)