---
title: "Create invoice"
method: POST
path: "/api/v1/services/invoices/invoice"
tags: ["invoices_service"]
---

# Create invoice

`POST /api/v1/services/invoices/invoice`

## Query parameters

- `app_id` integer

## Request body

- object
  - `amount` string, required — nano ton are expected
  - `life_time` integer, required — seconds are expected
  - `description` string
  - `currency` 'TON' | 'USDT'

## Response `201`

Service invoices fee

- InvoicesInvoice
  - `id` string, required
  - `amount` string, required
  - `overpayment` string
  - `description` string, required
  - `status` 'pending' | 'paid' | 'cancelled' | 'expired', required
  - `pay_to_address` string, required
  - `paid_by_address` string
  - `payment_link` string, required
  - `info` unknown
  - `date_change` integer, required
  - `date_expire` integer, required
  - `date_create` integer, required
  - `currency` 'TON' | 'USDT', required

## Other responses

- `400` — Something went wrong on client side
- `404` — The specified resource was not found
- `500` — Something went wrong on server side

---

[API](https://skmtc.net/tonkeeper/apis/rest-api-to-ton-console.md) · [All operations](https://skmtc.net/tonkeeper/apis/rest-api-to-ton-console/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonkeeper/rest-api-to-ton-console/versions/bffcc11719d3/schema)