Docs

This documentation is also available in the Russian language.

The $GOVNO payment system provides a secure and efficient way to integrate $GOVNO token payments into your digital platform or application. This documentation outlines the core features, API endpoints, and best practices for seamless integration.

Our goal is to enable you to easily accept and manage $GOVNO transactions with minimal friction.

To authenticate API requests, you must include an authorization token, obtained when creating your store in our bot, in the Authorization header

Open Bot

Example auth header:

Authorization: d21b7466-e955-48cb-808c-c2e0862ea268

For a complete reference to the API, please see the following documentation:

Open API docs

At this stage, you have access to 4 API methods:

Getting an invoice - allows you to retrieve information about an issued invoice by its unique identifier (uuid)
Issuing an invoice - allows you to create an invoice. In response, you will receive reference information about the invoice and two links for the client to pay. One of the links leads to a Telegram mini app, the second leads to a separate website. You can use either, depending on your preferences.
Transfer of funds - allows you to transfer funds from your store's account to the $GOVNO Pay wallet account of any Telegram user, by their id. When transferring funds, you must specify a unique request identifier in your system. This is necessary to prevent double payouts.
Getting the status of a funds transfer - provides information on the transaction for transferring funds to a user's account in the $GOVNO Pay wallet

In the bot, you can also set up a Webhook to receive instant notifications of successful payments.

Notifications will be sent to the webhook using the POST method with a json body.

Example request body:

{

"invoice_uuid": "439b14f1-6d75-495e-98b8-51831b630ca5",
"is_payed": true,
"payload": [],
"price_govno": "0.0010000000",
"price_usd": "0.0238063010",
"title": "123",
"paid_at": "2025-02-06T03:03:52+00:00"

}