Sign in

v49

OpenAPI 3.1.1raw.githubusercontent.com2026-04-2200132.4 KB
invoices_service

Create invoice

post/api/v1/services/invoices/invoice

Query parameters

app_idinteger

App ID

Request body

amountstring required

nano ton are expected

life_timeinteger required

seconds are expected

descriptionstring
currency'TON' | 'USDT'

Example request

{
  "amount": "1000000000",
  "life_time": 100,
  "description": "Test description"
}

Response

Service invoices fee

idstring required
amountstring required
overpaymentstring
descriptionstring required
status'pending' | 'paid' | 'cancelled' | 'expired' required
pay_to_addressstring required
paid_by_addressstring
payment_linkstring required
{"stackTrail":"components:schemas:InvoicesInvoice:properties:info","oasType":"schema","type":"unknown","example":{"first_key":"1","second_key":2}}
date_changeinteger required
date_expireinteger required
date_createinteger required
currency'TON' | 'USDT' required

Example response

{
  "id": "60ffb075",
  "amount": "1000000000",
  "overpayment": "1000000000",
  "description": "Test description",
  "status": "pending",
  "pay_to_address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
  "paid_by_address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
  "payment_link": "https://app.tonkeeper.com/transfer/UQ....UQ",
  "info": {
    "first_key": "1",
    "second_key": 2
  },
  "date_change": 1690889913000,
  "date_expire": 1690889913000,
  "date_create": 1690889913000
}