---
title: "Start a wallet top-up of ₹500, ₹5,000 or ₹50,000 (+18% GST). Returns pay_url for the account owner to pay, and status_url (free)"
method: POST
path: "/account/topup"
---

# Start a wallet top-up of ₹500, ₹5,000 or ₹50,000 (+18% GST). Returns pay_url for the account owner to pay, and status_url (free)

`POST /account/topup`

## Request

- Base URL: `https://indiacos.com/api/v1`
- URL: `https://indiacos.com/api/v1/account/topup`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
  - OAuth 2 (authorization code, authorization URL `https://indiacos.com/oauth/authorize`, token URL `https://indiacos.com/oauth/token`, scopes: `api`)

## Request body

- object
  - `amount` 500 | 5000 | 50000, required

## Response `201`

Pending payment with pay_url

## Other responses

- `400`: Error
- `401`: Error
- `429`: Error
- `503`: Error

---

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