# Table of Contents - [Welcome | goodPayments.io](#welcome-goodpayments-io) - [Термины и определения | goodPayments.io](#-goodpayments-io) - [Что такое goodPayments? | goodPayments.io](#-goodpayments-goodpayments-io) - [Добро пожаловать | goodPayments.io](#-goodpayments-io) - [Регистрация в системе | goodPayments.io](#-goodpayments-io) - [Основные функции | goodPayments.io](#-goodpayments-io) - [Комиссии и лимиты | goodPayments.io](#-goodpayments-io) - [Настройка 2FA аутентификации | goodPayments.io](#-2fa-goodpayments-io) - [Смена пароля | goodPayments.io](#-goodpayments-io) - [Установка Telegram уведомлений | goodPayments.io](#-telegram-goodpayments-io) - [Настройки аккаунта | goodPayments.io](#-goodpayments-io) - [Добавление кошелька для выплат | goodPayments.io](#-goodpayments-io) - [Поддерживаемые валюты и сети | goodPayments.io](#-goodpayments-io) - [Переплата и неполная оплата по инвойсу | goodPayments.io](#-goodpayments-io) - [Реферальная программа | goodPayments.io](#-goodpayments-io) - [Панель управления и Дашборд пользователя | goodPayments.io](#-goodpayments-io) - [Описание процесса аутентификации | goodPayments.io](#-goodpayments-io) - [Получение API-ключа | goodPayments.io](#-api-goodpayments-io) - [Описание методов взаимодействия (структура запроса/ответа) | goodPayments.io](#-goodpayments-io) - [Пополнение баланса | goodPayments.io](#-goodpayments-io) - [Статусы платежа | goodPayments.io](#-goodpayments-io) - [Общая информация | goodPayments.io](#-goodpayments-io) - [AML-проверки | goodPayments.io](#aml-goodpayments-io) - [Платежное окно | goodPayments.io](#-goodpayments-io) - [Получение информации о пользователе | goodPayments.io](#-goodpayments-io) - [Terms and Definitions | goodPayments.io](#terms-and-definitions-goodpayments-io) - [Получение актуального курса конвертации | goodPayments.io](#-goodpayments-io) - [What is goodPayments? | goodPayments.io](#what-is-goodpayments-goodpayments-io) - [Fees and Limits | goodPayments.io](#fees-and-limits-goodpayments-io) - [Создание инвойса | goodPayments.io](#-goodpayments-io) - [Supported Tokens and Chains | goodPayments.io](#supported-tokens-and-chains-goodpayments-io) - [Получение информации об инвойсе | goodPayments.io](#-goodpayments-io) - [Получение списка транзакций | goodPayments.io](#-goodpayments-io) - [Получение информации о транзакции | goodPayments.io](#-goodpayments-io) - [Вебхуки | goodPayments.io](#-goodpayments-io) - [Account Settings | goodPayments.io](#account-settings-goodpayments-io) - [Key Features | goodPayments.io](#key-features-goodpayments-io) - [Создание массовой рассылки | goodPayments.io](#-goodpayments-io) - [Получение списка инвойсов | goodPayments.io](#-goodpayments-io) - [Расчет стоимости массовой рассылки | goodPayments.io](#-goodpayments-io) - [Отмена инвойса | goodPayments.io](#-goodpayments-io) - [Overpayment and Underpayment | goodPayments.io](#overpayment-and-underpayment-goodpayments-io) - [Balance Top-Up | goodPayments.io](#balance-top-up-goodpayments-io) - [Payment Window | goodPayments.io](#payment-window-goodpayments-io) - [Referral Program | goodPayments.io](#referral-program-goodpayments-io) - [Account Registration | goodPayments.io](#account-registration-goodpayments-io) - [Adding a Payout Wallet | goodPayments.io](#adding-a-payout-wallet-goodpayments-io) - [Создание инвойса | goodPayments.io](#-goodpayments-io) - [Активация адресов | goodPayments.io](#-goodpayments-io) - [User Dashboard and Control Panel | goodPayments.io](#user-dashboard-and-control-panel-goodpayments-io) - [Enabling Telegram Notifications | goodPayments.io](#enabling-telegram-notifications-goodpayments-io) - [Password Change | goodPayments.io](#password-change-goodpayments-io) - [Authentication Process | goodPayments.io](#authentication-process-goodpayments-io) - [2FA Authentication | goodPayments.io](#2fa-authentication-goodpayments-io) - [AML Checks | goodPayments.io](#aml-checks-goodpayments-io) - [Address Activation | goodPayments.io](#address-activation-goodpayments-io) - [Payment Statuses | goodPayments.io](#payment-statuses-goodpayments-io) - [Массовые рассылки | goodPayments.io](#-goodpayments-io) - [General Information | goodPayments.io](#general-information-goodpayments-io) - [Mass Payouts | goodPayments.io](#mass-payouts-goodpayments-io) - [Invoice Creation | goodPayments.io](#invoice-creation-goodpayments-io) - [Ответы на часто задаваемые вопросы | goodPayments.io](#-goodpayments-io) - [Contact Us | goodPayments.io](#contact-us-goodpayments-io) - [API Methods Overview (Request/Response Structure) | goodPayments.io](#api-methods-overview-request-response-structure-goodpayments-io) - [Frequently Asked Questions | goodPayments.io](#frequently-asked-questions-goodpayments-io) - [Getting an API Key | goodPayments.io](#getting-an-api-key-goodpayments-io) - [Контакты | goodPayments.io](#-goodpayments-io) - [Get Merchant Account Information | goodPayments.io](#get-merchant-account-information-goodpayments-io) - [Get Current Conversion Rate | goodPayments.io](#get-current-conversion-rate-goodpayments-io) - [Get Invoice Information | goodPayments.io](#get-invoice-information-goodpayments-io) - [Calculate a Mass Payout Cost | goodPayments.io](#calculate-a-mass-payout-cost-goodpayments-io) - [Get List of Invoices | goodPayments.io](#get-list-of-invoices-goodpayments-io) - [Get Transaction Information | goodPayments.io](#get-transaction-information-goodpayments-io) - [Get List of Transactions | goodPayments.io](#get-list-of-transactions-goodpayments-io) - [Create a Mass Payout | goodPayments.io](#create-a-mass-payout-goodpayments-io) - [Cancel an Invoice | goodPayments.io](#cancel-an-invoice-goodpayments-io) - [Create an Invoice | goodPayments.io](#create-an-invoice-goodpayments-io) - [Webhooks | goodPayments.io](#webhooks-goodpayments-io) --- # Welcome | goodPayments.io Welcome to the official documentation for [**goodPayments**arrow-up-right](https://goodpayments.io/) – a solution for accepting cryptocurrency payments in **TRX** and **USDT (TRC-20)** with automatic processing, status tracking, and seamless payouts directly to your wallet. ### [hashtag](https://goodpayments.gitbook.io/docs#what-you-can-do-with-goodpayments) **What you can do with goodPayments** * Accept payments in **TRX** and **USDT (TRC-20)** * Create invoices via the dashboard or API * Use one-time temporary addresses to track payments * Receive instant payment status updates via [**Webhooks**](https://goodpayments.gitbook.io/docs/api-reference/webhooks) * Automatically receive funds to your payout wallet ### [hashtag](https://goodpayments.gitbook.io/docs#jump-right-in) Jump right in [](https://goodpayments.gitbook.io/docs/getting-started/account-registration) #### [hashtag](https://goodpayments.gitbook.io/docs#undefined) address-card **Create an Account** Sign up to start using goodPayments [](https://goodpayments.gitbook.io/docs/getting-started/account-settings) #### [hashtag](https://goodpayments.gitbook.io/docs#undefined-1) gears **Account Settings** Configure your profile and security settings [](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up) #### [hashtag](https://goodpayments.gitbook.io/docs#undefined-2) envelope-open-dollar **Balance Top-Up** Add funds to your balance to activate service features [](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation) #### [hashtag](https://goodpayments.gitbook.io/docs#undefined-3) receipt **Create an Invoice** Generate your first payment invoice [](https://goodpayments.gitbook.io/docs/api-reference/general-information) #### [hashtag](https://goodpayments.gitbook.io/docs#undefined-4) computer **goodPayments API** Automate invoice creation and integrate payments via API [NextWhat is goodPayments?chevron-right](https://goodpayments.gitbook.io/docs/general-info/what-is-goodpayments) Last updated 5 days ago --- # Термины и определения | goodPayments.io **Мерчант** – пользователь goodPayments, использующий сервис в качестве решения по приему криптовалютных платежей за предоставляемые товары и услуги. **Плательщик** – клиент мерчанта, осуществляет оплату по созданному мерчантом счету на оплату (инвойсу). **Инвойс** – счет на оплату, созданный мерчантом через API или личный кабинет goodPayments, содержащий сумму, валюту, срок действия и криптовалютный адрес для оплаты. **Временный адрес** – уникальный одноразовый криптовалютный адрес, генерируемый при создании инвойса с типом «Временный». Действует только на протяжении срока, отведенного для оплаты по инвойсу. После совершения оплаты либо после истечения срока действия инвойса данный адрес становится неактивным. **Статичный адрес** – постоянный криптовалютный адрес, генерируемый при создании инвойса с типом «Статичный». В отличие от временного адреса, статичный остается активным и мониторится до момента ручной деактивации такого адреса мерчантом. На статичные адреса можно может поступать множество входящих платежей. **Адрес для пересылок** – адрес, принадлежащий мерчанту и устанавливаемый в настройках. На этот адрес сервис goodPayments автоматически переводит (пересылает) средства, полученные по оплаченным инвойсам. Используется как конечный адрес для зачисления входящих платежей. **Адрес для активаций** – адрес, который создается сервисом goodPayments и используется для обеспечения процесса активации временных адресов, генерируемых при создании инвойсов. **Активация адреса** – процесс запуска нового адреса в блокчейне Tron, необходимый для возможности совершения с него исходящих транзакций. **AML-проверка** – автоматическая проверка входящих транзакций на предмет риска. Проверка предназначена для выявления потенциальных связей входящего актива с незаконной деятельностью. **Комиссия сервиса** – комиссия goodPayments за обработку входящего платежа и последующую выплату на адрес мерчанта. Размер комиссии зависит от наличия USDT на адресе мерчанта и составляет **6.5 TRX** или **13 TRX**. [ПредыдущаяОсновные функцииchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/osnovnye-funkcii) [СледующаяПоддерживаемые валюты и сетиchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/podderzhivaemye-valyuty-i-seti) Последнее обновление 1 месяц назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Что такое goodPayments? | goodPayments.io **goodPayments** – это сервис, позволяющий вашему бизнесу беспрепятственно принимать платежи в криптовалюте. Сервис обеспечивает полный цикл обработки транзакции от плательщика: все средства мгновенно поступают прямо на ваш кошелек без задержек. Процесс регистрации в goodPayments прост и не требует прохождения KYC. Для начала работы достаточно [пополнить баланс](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa) и [установить адрес](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/dobavlenie-koshelka-dlya-vyplat) , на который будут приниматься платежи. Создание счетов на оплату доступно как из личного кабинета, так и посредством [API-взаимодействия](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/obshaya-informaciya) . Настройка интеграции не займет много времени, подключайтесь к нашему API и принимайте платежи уже сегодня. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/chto-takoe-goodpayments#klyuchevye-osobennosti-platformy) Ключевые особенности платформы * Быстрая регистрация без необходимости прохождения верификации личности (KYC); * goodPayments не взимает платы за подключение, комиссии фиксированные: 6.5 или 13 TRX за полный цикл оплаты; * Генерация уникального временного адреса под каждый счет на оплату (инвойс); * Перевод средств на ваш криптокошелек, goodPayments не хранит средств плательщиков, а пересылает их вам; * Сервис позволяет легко отслеживать поступающие платежи, управлять созданными адресами и контролировать расходы на комиссии с помощью удобного интерфейса личного кабинета; * Настройка уведомлений о транзакциях в Telegram, получайте информацию о платежах клиентов прямо в мессенджер. [ПредыдущаяДобро пожаловатьchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru) [СледующаяОсновные функцииchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/osnovnye-funkcii) Последнее обновление 1 месяц назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Добро пожаловать | goodPayments.io Добро пожаловать в официальную документацию сервиса [**goodPayments**arrow-up-right](https://goodpayments.io/) – решения для приема криптовалютных платежей в **TRX** и **USDT (TRC-20)** с автоматической обработкой, отслеживанием статуса и пересылкой средств напрямую на ваш кошелек. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru#chto-vy-mozhete-delat-s-goodpayments) Что вы можете делать с goodPayments * Принимать платежи в **TRX** и **USDT** **(TRC-20)** * [Создавать инвойсы](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa) через личный кабинет и API * Использовать одноразовые временные адреса для отслеживания оплат * Получать мгновенные уведомления о статусе платежей через [Webhooks](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/vebkhuki) * Автоматически получать средства на свой кошелек ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru#nachnite-pryamo-seichas) Начните прямо сейчас [](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/registraciya-v-sisteme) #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru#undefined) address-card **Регистрация в сервисе** Зарегистрируйтесь в goodPayments [](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta) #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru#undefined-1) gears **Настройки аккаунта** Настройте свой аккаунт [](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa) #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru#undefined-2) envelope-open-dollar **Пополнение баланса** Пополните баланс [](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa) #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru#undefined-3) receipt **Создание инвойса** Создайте свой первый инвойс [](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/obshaya-informaciya) #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru#undefined-4) computer **goodPayments API** Автоматизируйте создание инвойсов с помощью API [СледующаяЧто такое goodPayments?chevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/chto-takoe-goodpayments) Последнее обновление 1 месяц назад * [Что вы можете делать с goodPayments](https://goodpayments.gitbook.io/docs/documentation/ru#chto-vy-mozhete-delat-s-goodpayments) * [Начните прямо сейчас](https://goodpayments.gitbook.io/docs/documentation/ru#nachnite-pryamo-seichas) sun-brightdesktopmoon sun-brightdesktopmoon --- # Регистрация в системе | goodPayments.io Для получения доступа к личному кабинету сервиса необходимо оставить заявку на регистрацию на главной странице сайта [https://goodpayments.io/arrow-up-right](https://goodpayments.io/) (кнопка **Sign Up**). В появившейся форме необходимо заполнить следующие поля: Поле Обязательность Имя пользователя Обязательное поле E-mail адрес пользователя Обязательное поле Telegram Username Необязательное поле Официальный сайт компании мерчанта Необязательное поле Количество транзакций в месяц Обязательное поле Сфера бизнеса Обязательное поле ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252F6aSgsOZbmKthXWPaQqV4%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-02%2520%25D0%25B2%252013.36.30.png%3Falt%3Dmedia%26token%3De7d4d7f0-728a-437e-ad53-71ab7f8206c7&width=768&dpr=3&quality=100&sign=6d0be6d6&sv=2) После заполнения регистрационной формы заявка на регистрацию проверяется администратором сервиса goodPayments. В случае успешного одобрения заявки на E-mail адрес, указанный в форме, поступит сообщение с паролем для входа в личный кабинет. Настоятельно рекомендуется после первой авторизации [изменить пароль](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/smena-parolya) от личного кабинета и настроить [двухфакторную аутентификацию](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/nastroika-2fa) . [ПредыдущаяКомиссии и лимитыchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity) [СледующаяНастройки аккаунтаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta) Последнее обновление 1 месяц назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Основные функции | goodPayments.io Основные функции goodPayments: [**Регистрация и управление аккаунтом мерчанта**](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/registraciya-v-sisteme) : для начала работы необходимо зарегистрироваться на платформе, подтвердить учетную запись, настроить профиль, включить 2FA, указать адрес для выплат, получить API-ключ и настроить уведомления в Telegram. [**Генерация счетов на оплату (инвойсов)**](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa) : Создание счета на оплату доступно через API или личный кабинет платформы. При создании инвойса сервис генерирует новый криптовалютный адрес. В настоящий момент поддерживается генерация двух типов адресов: **временного адреса и статичного адреса**. circle-info Временный адрес действителен только в течение срока, отведенного на совершение оплаты по созданному инвойсу. После совершения оплаты или по истечении срока действия счета на оплату адрес перестает быть активным, мониторинг по данному адресу прекращается. circle-info Статичный адрес - это постоянный адрес, который остается активным бессрочно. Статичный адрес может принимать множество входящих платежей. Идеально подходит, если необходимо закрепить определенный адрес за конкретным клиентом. [**Формирование окна оплаты**](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/platezhnoe-okno) : При создании инвойса формируется платежная страница, которая содержит адрес оплаты, сумму, валюту, QR-код, срок действия инвойса, а также инструкцию по оплате. Данное платежное окно может быть сформировано как отдельная ссылка, либо же встроено в интерфейс решения мерчанта. [**Обработка поступления платежа**](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/statusy-platezha) : Сервис в режиме реального времени осуществляет мониторинг поступления средств по созданным счетам на оплату. После получения входящей транзакции сервис фиксирует данные по внесенной сумме и токену, сохраняет хэш транзакции; [**Перевод средств на адрес мерчанта**](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/dobavlenie-koshelka-dlya-vyplat) : После подтверждения поступления средств на сгенерированный адрес сервис осуществляет перевод полученной криптовалюты на адрес мерчанта, установленный в настройках. [**Отправка уведомлений**](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/ustanovka-telegram-uvedomlenii) : Каждый шаг в процессе обработки входящего платежа от плательщика сопровождается уведомлениями. [**История платежей**](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#istoriya-platezhei) : Мерчант имеет доступ к истории всех поступлений по созданным счетам на оплату. Поддерживается поиск, фильтрация, выгрузка данных в формате таблицы. [**AML-проверки входящих транзакций**](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki) : Мерчант может подключить автоматические AML-проверки входящих транзакций. Каждый входящий платеж проверяется на предмет риска: транзакции, превышающие установленный порог риска, возвращаются отправителю. [**Массовые рассылки**arrow-up-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki) : инструмент для одновременной отправки выплат в TRX или USDT TRC-20 на множество адресов. Список получателей и суммы можно загрузить файлом в формате XLSX, CSV или TXT, либо ввести вручную. [**Реферальная программа**arrow-up-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/referalnaya-programma) : мерчант получает 5% с каждого пополнения основного кошелька привлеченных партнеров. Бонус начисляется автоматически и сразу зачисляется на баланс пересылок. [ПредыдущаяЧто такое goodPayments?chevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/chto-takoe-goodpayments) [СледующаяТермины и определенияchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/terminy-i-opredeleniya) Последнее обновление 5 дней назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Комиссии и лимиты | goodPayments.io ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#komissii-servisa) Комиссии сервиса Размер комиссии сервиса goodPayments за обработанные входящие платежи зависит от следующих условий: Размер комиссии Условие 6.5 TRX * Оплата по инвойсу в токене **TRX** * Если оплата по инвойсу в токене **USDT**: на адресе мерчанта (на который осуществляется перевод входящих платежей) **есть** **USDT** 13 TRX * Оплата по инвойсу в токене **USDT**: на адресе мерчанта (на который осуществляется перевод входящих платежей) **нет USDT** * * * ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#vklyuchenie-komissii-v-summu-invoisa) Включение комиссии в сумму инвойса При создании временного инвойса мерчанту доступен флаг **«Включить комиссии в сумму инвойса»**. Если данный флаг активирован, комиссия сервиса включается в сумму к оплате по инвойсу – ее оплачивает плательщик. Принцип работы: * комиссия сервиса добавляется к сумме инвойса и выставляется плательщику – он платит больше, чем исходная сумма заказа; * с баланса пересылок мерчанта комиссия списывается в обычном порядке; * за счет средств, включенных в инвойс, мерчант фактически возвращает себе эту комиссию. circle-exclamation Комиссия включается в сумму инвойса в той валюте, в которой создается инвойс. Списание с баланса мерчанта при этом происходит независимо от данной настройки. * * * ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#aktivaciya-adresov-generiruemykh-pri-sozdanii-invoisov-s-balansa-dlya-aktivacii) Активация адресов, генерируемых при создании инвойсов (с баланса для активаций) * Если плательщик отправляет TRX на адрес, созданный в инвойсе – плата не взимается; * Если плательщик отправляет USDT (TRC-20) на адрес, созданный в инвойсе – осуществляется техническая транзакция в размере 0.000001 TRX с адреса для активаций + 1.1 TRX (комиссия блокчейна Tron). Иные сборы и дополнительные комиссии не предусматриваются сервисом. * * * ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#komissiya-za-aml-proverku) Комиссия за AML-проверку При активированной функции AML-проверок за каждую проведенную проверку взимается комиссия. Комиссия списывает с баланса мерчанта для пересылок (основного баланса) в токене TRX. Размер комиссии = **1$**, конвертируется в TRX по актуальному курсу пары USDT/TRX. Комиссия списывается вне зависимости от результата проверки, как при прохождении, так и при отклонении транзакции. * * * ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#limity) Лимиты Лимит Значение Минимальная сумма платежа 0.01 USDT (но рекомендуется > 1 USDT/TRX для покрытия комиссии) Максимальная сумма платежа Не ограничена сервисом Время действия временного адреса Устанавливается мерчантом при создании инвойса (по умолчанию – 30 минут) * * * ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#vazhno) Важно Комиссия сервиса не удерживается из суммы платежа по счету, а списывается с баланса мерчанта. Если баланса мерчанта недостаточно для оплаты комиссии за использование сервиса, то обработка платежей по инвойсам приостанавливается. [ПредыдущаяПоддерживаемые валюты и сетиchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/podderzhivaemye-valyuty-i-seti) [СледующаяРегистрация в системеchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/registraciya-v-sisteme) Последнее обновление 5 дней назад * [Комиссии сервиса](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#komissii-servisa) * [Включение комиссии в сумму инвойса](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#vklyuchenie-komissii-v-summu-invoisa) * [Активация адресов, генерируемых при создании инвойсов (с баланса для активаций)](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#aktivaciya-adresov-generiruemykh-pri-sozdanii-invoisov-s-balansa-dlya-aktivacii) * [Комиссия за AML-проверку](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#komissiya-za-aml-proverku) * [Лимиты](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#limity) * [Важно](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity#vazhno) sun-brightdesktopmoon sun-brightdesktopmoon --- # Настройка 2FA аутентификации | goodPayments.io Подключение двухфакторной аутентификации осуществляется в личном кабинете мерчанта. Перейдите в раздел **«Настройки»** и выберите вкладку **«Безопасность»**. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FRzD51DC86fj4H8fkcyf7%252Funknown.png%3Falt%3Dmedia%26token%3D21a74d9d-2ab9-4bd7-8414-59fe98009fc0&width=768&dpr=3&quality=100&sign=560d9fe3&sv=2) Нажмите на кнопку **«Включить 2FA»** для установки данной настройки. Появится модальное окно с инструкцией по подключению. Для подключения приложения-аутентификатора выполните шаги ниже. 1 Откройте приложение-аутентификатор Google Authenticator. 2 Сканируйте QR-код или введите резервный ключ вручную. 3 Введите одноразовый код из приложения, чтобы завершить настройку. В модальном окне нажмите на **«Получить QR-код»**. Будет сгенерирован QR-код и резервный ключ для ручного ввода. Отсканируйте QR-код в приложении-аутентификаторе (например Google Authenticator), либо добавьте резервный ключ вручную. После сканирования QR-кода введите одноразовый 6-значный код в поле ввода и нажмите на кнопку **«Включить 2FA»**. Теперь ваша учетная запись дополнительно защищена двухфакторной аутентификацией. При необходимости, вы можете отключить двухфакторную аутентификацию. Отключение 2FA производится на той же вкладке **«Безопасность»** раздела **«Настройки»** и доступно, если ранее данная настройка была установлена. Для отключения настройки необходимо ввести одноразовый код из приложения-аутентификатора. Обращаем ваше внимание, что отключение двухфакторной аутентификации снизит безопасность вашего аккаунта. [ПредыдущаяНастройки аккаунтаchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta) [СледующаяСмена пароляchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/smena-parolya) Последнее обновление 4 месяца назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Смена пароля | goodPayments.io Для смены пароля от личного кабинета необходимо перейти в раздел **«Настройки»**. Далее, на вкладке **«Пароль»** будет доступна смена текущего пароля. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FuJwKpqNoIUDtIPGmvmv1%252Funknown.png%3Falt%3Dmedia%26token%3De21f9a20-d304-4ddb-a217-4082de72b839&width=768&dpr=3&quality=100&sign=98b52766&sv=2) Заполните поле **«Текущий пароль»** и укажите новое значение в поле **«Новый пароль»**, повторите новый пароль в поле **«Подтвердите новый пароль»**. Если все указано верно, кнопка **«Изменить пароль»** станет активной. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/smena-parolya#trebovaniya-k-parolyu) Требования к паролю Длина пароля Минимум 8 символов Пароль должен содержать * Строчная буква (a-z) * Заглавная буква (A-Z) * Цифра (0-9) * Специальный символ [ПредыдущаяНастройка 2FA аутентификацииchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/nastroika-2fa) [СледующаяУстановка Telegram уведомленийchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/ustanovka-telegram-uvedomlenii) Последнее обновление 4 месяца назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Установка Telegram уведомлений | goodPayments.io Вы можете получать уведомления о совершаемых платежах прямо на ваш Telegram-аккаунт. Подключить Telegram-уведомления можно в разделе **«Настройки»** на вкладке **«Уведомления»**. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252F4WAEkC2FV29imeE5XsPL%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252011.14.05.png%3Falt%3Dmedia%26token%3D74d55801-6e5c-43cf-889c-6af71b2cbec5&width=768&dpr=3&quality=100&sign=45b7e9df&sv=2) Процесс подключения уведомлений в Telegram очень прост. 1 Нажмите на кнопку **«Подключить Telegram»** и вы увидите модальное окно с инструкцией по добавлению уведомлений. 2 Перейдите в Telegram-бота по кнопке **«Открыть в Telegram»** 3 Запустите бота командой **/start**. После запуска бота ваш Telegram-аккаунт будет автоматически получать уведомления о событиях: * Изменения баланса * Вход в личный кабинет * Переводы средств * Инвойсы и платежи Вы можете отключить уведомления в любой момент времени в том же разделе **«Настройки»** на вкладке **«Уведомления»**. Для этого нажмите на кнопку **«Отключить Telegram»** и подтвердите действие в появившемся модальном окне. [ПредыдущаяСмена пароляchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/smena-parolya) [СледующаяДобавление кошелька для выплатchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/dobavlenie-koshelka-dlya-vyplat) Последнее обновление 4 месяца назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Настройки аккаунта | goodPayments.io [Настройка 2FA аутентификацииchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/nastroika-2fa) [Смена пароляchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/smena-parolya) [Установка Telegram уведомленийchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/ustanovka-telegram-uvedomlenii) [ПредыдущаяРегистрация в системеchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/registraciya-v-sisteme) [СледующаяНастройка 2FA аутентификацииchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/nastroika-2fa) Последнее обновление 4 месяца назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Добавление кошелька для выплат | goodPayments.io Создание [инвойсов (счетов на оплату)](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa) невозможно без добавления целевого адреса для выплат (в контексте сервиса goodPayments – **«Адрес для пересылок»**). После установки целевого адреса, мерчант будет получать на данный адрес криптовалюту по всем оплаченным плательщиками инвойсам. Для того, чтобы установить адрес для получения оплат, необходимо перейти в раздел **«Настройки»** на вкладку **«Кошелек»**. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FCY2TzseUVcstXYGpCvWQ%252Funknown.png%3Falt%3Dmedia%26token%3D5535a28d-56dc-4ab6-a5d2-f5b39e926839&width=768&dpr=3&quality=100&sign=4459eaef&sv=2) Вам будет доступно указание адреса в поле **«Новый TRON адрес»**. Адрес должен быть активирован в сети Tron. Указание неактивированного адреса недоступно. circle-info Чтобы активировать Tron-адрес, достаточно отправить на него минимально возможную сумму TRX – 0.000001 TRX (1 sun). При этом, с отправляемого адреса будет списано 1.1 TRX в качестве комиссии за транзакцию. circle-exclamation **Важно!** Необходимо указать только адрес, созданный в сети Tron (адрес в формате base58 – начинается с символа T и имеет 34 символа). Внимательно проверьте корректность указываемого адреса, в противном случае, если адрес будет указан неверно, это может привести к потере средств. Укажите адрес для приема средств и нажмите на **«Установить TRON адрес»**. Введите одноразовый 2FA код, если установлена двухфакторная аутентификация и нажмите **«Подтвердить»**. Установленный адрес будет отображен на странице раздела. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FiTu7wU4ypOZVcRx0KwpX%252Funknown.png%3Falt%3Dmedia%26token%3D81195c2f-7e84-49eb-9e41-4634424d114a&width=768&dpr=3&quality=100&sign=e61c1ad6&sv=2) При необходимости, вы можете изменить текущий адрес для получения выплат. Для этого нажмите на кнопку **«Изменить адрес»**, откроется форма для указания нового TRON-адреса. Отметим, что установить адрес для пересылок возможно также через [Дашборд мерчанта](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor) в личном кабинете. Принцип установки адреса аналогичен тому, что описан выше. [ПредыдущаяУстановка Telegram уведомленийchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/nastroiki-akkaunta/ustanovka-telegram-uvedomlenii) [СледующаяПанель управления и Дашборд пользователяchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor) Последнее обновление 1 месяц назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Поддерживаемые валюты и сети | goodPayments.io goodPayments поддерживает прием платежей в сети **Tron Mainnet**. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/podderzhivaemye-valyuty-i-seti#podderzhivaemye-tokeny) Поддерживаемые токены Токен Сеть TRX Tron (TRC-20) USDT Tron (TRC-20) В дальнейшем список доступных сетей и криптовалют будет расширяться. [ПредыдущаяТермины и определенияchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/terminy-i-opredeleniya) [СледующаяКомиссии и лимитыchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/obshaya-informaciya-o-goodpayments/komissii-i-limity) Последнее обновление 1 месяц назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Переплата и неполная оплата по инвойсу | goodPayments.io ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/pereplata-i-nepolnaya-oplata-po-invoisu#pereplata-po-invoisu) Переплата по инвойсу Если плательщик отправляет сумму больше, чем указано в инвойсе: * Сервис goodPayments обрабатывает такой платеж полностью; * Вся полученная сумма переводится на адрес мерчанта (адрес для пересылок); * Инвойс закрывается со статусом **«Переплачен»**; * Вопрос возврата или компенсации переплаты решается **напрямую между плательщиком и мерчантом**, без участия сервиса. Сервис не распределяет и не возвращает переплаченную часть средств. Мы передаем всю полученную сумму целиком мерчанту. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/pereplata-i-nepolnaya-oplata-po-invoisu#nepolnaya-oplata-po-invoisu) Неполная оплата по инвойсу Если плательщик отправляет меньше, чем указано в инвойсе: * Сервис goodPayments обрабатывает поступившую сумму сразу после получения первой транзакции; * Полученные средства переводятся на адрес мерчанта (адрес для пересылок) в полном объеме; * Инвойсу присваивается статус **«Недоплачен»**. Вопрос компенсации недостающей суммы решается **напрямую между плательщиком и мерчантом**, без участия сервиса. circle-info Данное правило применяется только для временных адресов. Для статичных адресов сумма не указывается в инвойсе. [ПредыдущаяСтатусы платежаchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/statusy-platezha) [СледующаяАктивация адресовchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aktivaciya-adresov) Последнее обновление 5 дней назад * [Переплата по инвойсу](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/pereplata-i-nepolnaya-oplata-po-invoisu#pereplata-po-invoisu) * [Неполная оплата по инвойсу](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/pereplata-i-nepolnaya-oplata-po-invoisu#nepolnaya-oplata-po-invoisu) sun-brightdesktopmoon sun-brightdesktopmoon --- # Реферальная программа | goodPayments.io Раздел **«Реферальная программа»** позволяет мерчанту получать бонусы за привлечение новых партнеров в сервис goodPayments. Бонус начисляется в виде процента с пополнений основного кошелька привлеченных мерчантов. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/referalnaya-programma#princip-raboty) Принцип работы Каждому мерчанту в личном кабинете доступна персональная реферальная ссылка. При регистрации нового мерчанта по данной ссылке он автоматически закрепляется за реферером. **Размер бонуса составляет 5%** и начисляется с каждого пополнения основного кошелька (баланса пересылок) привлеченного партнера. Начисленная сумма сразу зачисляется на баланс пересылок реферера и доступна для использования в сервисе. circle-info Бонус начисляется **только с пополнений основного кошелька** (баланса пересылок) привлеченного партнера. Пополнения кошелька активаций, оплата инвойсов и прочие операции в расчет не входят. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/referalnaya-programma#stranica-referalnoi-programmy) Страница реферальной программы ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FAujYEkxCjMmfrAzq4Dfw%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252016.22.54.png%3Falt%3Dmedia%26token%3D3ce08139-a1e1-43fa-900b-a510062b8ad1&width=768&dpr=3&quality=100&sign=7d1ae40c&sv=2) На странице раздела **«Реферальная программа»** отображается следующая информация: * **Ваш процент с пополнений реферала** – текущий размер бонуса в процентах; * **Всего начислено бонусов** – суммарный объем TRX, полученных по реферальной программе за все время; * **Мерчантов по вашей ссылке** – количество партнеров, зарегистрировавшихся по реферальной ссылке мерчанта; * **Ваша реферальная ссылка** – персональная ссылка для привлечения новых мерчантов с кнопкой копирования. [ПредыдущаяМассовые рассылкиchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki) [СледующаяОбщая информацияchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/obshaya-informaciya) Последнее обновление 6 дней назад * [Принцип работы](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/referalnaya-programma#princip-raboty) * [Страница реферальной программы](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/referalnaya-programma#stranica-referalnoi-programmy) sun-brightdesktopmoon sun-brightdesktopmoon --- # Панель управления и Дашборд пользователя | goodPayments.io Панель управления и Дашборд пользователя доступны после авторизации в личном кабинете мерчанта. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#panel-upravleniya) Панель управления Панель управления обеспечивает доступ к функционалу платформы goodPayments и позволяет мерчантам управлять различными параметрами: настройками аккаунта, балансом, API и инвойсами. Панель управления состоит из нескольких разделов: **Дашборд** – основной раздел личного кабинета мерчанта. Содержит сводные данные по ключевым метрикам и дает быстрый обзор текущего состояния аккаунта мерчанта. **Баланс** – раздел управления балансами пользователя. В данном разделе мерчант может пополнить баланс для использования функций сервиса goodPayments и увидеть текущее состояние баланса, а также историю пополнений и списаний. **Инвойсы** – раздел для создания инвойсов (счетов на оплату) и просмотра истории всех платежей и транзакций. **AML** – раздел для управления AML проверками входящих транзакций. Здесь мерчант может включить или отключить функцию AML проверок, настроить порог риска, а также просмотреть результаты проведенных проверок. **API** – раздел управления API-ключом. Содержит информацию о текущем API-ключе мерчанта, позволяет обновить API-ключ и ознакомиться с API-документацией. **Настройки** – раздел управления настройками аккаунта. Доступна установка двухфакторной аутентификации, изменение пароля, настройка уведомлений в Telegram и адреса для получения выплат. **Смена языка интерфейса** – переключатель языка интерфейса личного кабинета. На текущий момент интерфейс goodPayments доступен на 2 языках: русский и английский. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#dashbord) Дашборд Дашборд является основным разделом личного кабинета и предоставляет сводную информацию о состоянии аккаунта мерчанта и текущей активности. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#osnovnye-bloki-dashborda) Основные блоки Дашборда #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#adres-dlya-peresylok) **Адрес для пересылок** Блок содержит адрес мерчанта, предназначенный для получения платежей от клиентов (TRX и USDT TRC-20). Все транзакции от плательщиков пересылаются с генерируемых сервисом goodPayments адресов на установленный адрес мерчанта. goodPayments не имеет доступа к данному адресу, адрес для пересылок полностью контролируется мерчантом. В блоке отображаются: * Сам адрес мерчанта; * Кнопка быстрого копирования адреса; * Кнопка «Изменить адрес» – позволяет изменить адрес приема средств. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#adres-dlya-aktivacii) **Адрес для активаций** Адрес, генерируемый сервисом goodPayments для каждого мерчанта. Используется для активации временных адресов, если на них поступает USDT. Более подробное описание работы данного адреса доступно в разделе [«Активация адресов»](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aktivaciya-adresov) . В блоке отображаются: * Сам адрес активаций; * Кнопка быстрого копирования адреса. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#tranzakcii) **Транзакции** В блоке содержится информация о количестве входящих транзакций за последние 24 часа. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#raskhod-balansa) **Расход баланса** Блок отображает статистику использования баланса мерчанта для оплаты комиссий сервиса за последние 24 часа. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#kolichestvo-invoisov) **Количество инвойсов** Блок отображает общее количество инвойсов, созданных мерчантом за все время. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#uspeshnye-invoisy) **Успешные инвойсы** Количество успешно обработанных инвойсов мерчанта (платеж успешно получен и переслан на адрес мерчанта). #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#neuspeshnye-invoisy) **Неуспешные инвойсы** Отображается количество инвойсов, завершившихся с ошибкой или отмененных по причине отрицательной AML проверки за все время. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#aml-proverki) **AML проверки** Блок отображает общее количество проведенных AML проверок. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#uspeshnye-aml) **Успешные AML** Отображается общее количество успешно проведенных AML проверок за все время. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#neuspeshnye-aml) **Неуспешные AML** Блок отображает общее количество AML проверок за все время, по которым получен отрицательный результат. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#poslednie-invoisy) **Последние инвойсы** Блок показывает 10 последних созданных инвойсов и их статусы. Для каждого инвойса отображается: * ID * Адрес * Время * Валюты для оплаты * Статус * Сумма [ПредыдущаяДобавление кошелька для выплатchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/nachalo-raboty/dobavlenie-koshelka-dlya-vyplat) [СледующаяПополнение балансаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa) Последнее обновление 1 месяц назад * [Панель управления](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#panel-upravleniya) * [Дашборд](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#dashbord) * [Основные блоки Дашборда](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor#osnovnye-bloki-dashborda) sun-brightdesktopmoon sun-brightdesktopmoon --- # Описание процесса аутентификации | goodPayments.io Все запросы к API goodPayments должны быть авторизованы с использованием уникального API-ключа мерчанта. Авторизация выполняется путем передачи API-ключа в HTTP-заголовке каждого запроса. **Базовый URL:** [https://app.goodpayments.io/v1/apiarrow-up-right](https://app.goodpayments.io/v1/api) API-ключ передается в заголовке: Копировать Authorization: **Пример запроса:** Копировать curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/merchant' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес отсутствует в белом списке, сервер возвращает ответ с кодом **403**. **Пример ответа с ошибкой:** Копировать { "detail": "Invalid API key" } [ПредыдущаяПолучение API-ключаchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/poluchenie-api-klyucha) [СледующаяОписание методов взаимодействия (структура запроса/ответа)chevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta) Последнее обновление 5 дней назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Получение API-ключа | goodPayments.io Для работы с goodPayments API необходимо получить уникальный пользовательский API-ключ. Данный ключ позволяет идентифицировать мерчанта, обеспечивает авторизацию запросов и защищает от несанкционированного доступа. Обращаем ваше внимание, что API-ключ доступен только пользователям, прошедшим регистрацию в сервисе goodPayments. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/poluchenie-api-klyucha#whitelist-ip-adresov) Whitelist IP-адресов Перед получением API-ключа мерчанту необходимо добавить хотя бы один IP-адрес в белый список. Доступ к API будет разрешен только с указанных адресов. Для добавления IP-адреса необходимо перейти в раздел **«API»** личного кабинета, ввести IP-адрес в формате IPv4 в соответствующее поле и нажать кнопку **«Добавить»**. circle-info Максимальное количество IP-адресов в белом списке – **5**. Если в списке остался только один адрес, его удаление недоступно. circle-exclamation Пока в белом списке не добавлен хотя бы один IP-адрес, кнопки **«Показать ключ»** и **«Обновить ключ»** недоступны. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/poluchenie-api-klyucha#poluchenie-api-klyucha) Получение API-ключа 1 Перейдите в раздел **«API»** личного кабинета (через панель управления) 2 Добавьте хотя бы один IP-адрес в белый список 3 Нажмите на кнопку **«Показать ключ»** ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FXJhGzzP7PCnPmKB03B9h%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252017.46.11.png%3Falt%3Dmedia%26token%3D550a98b6-f7f3-49e7-9dbf-7a94ff2cef14&width=768&dpr=3&quality=100&sign=8cf1048a&sv=2) Ключ будет показан в модальном окне. Рекомендуем сохранить ключ и хранить его в безопасном месте. При необходимости, вы можете изменить API-ключ. Для этого необходимо нажать на кнопку **«Обновить ключ»**. Будет сгенерирован новый API-ключ после подтверждения действия. [ПредыдущаяОбщая информацияchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/obshaya-informaciya) [СледующаяОписание процесса аутентификацииchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-processa-autentifikacii) Последнее обновление 6 дней назад * [Whitelist IP-адресов](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/poluchenie-api-klyucha#whitelist-ip-adresov) * [Получение API-ключа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/poluchenie-api-klyucha#poluchenie-api-klyucha) sun-brightdesktopmoon sun-brightdesktopmoon --- # Описание методов взаимодействия (структура запроса/ответа) | goodPayments.io [Получение информации о пользователеchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele) [Создание инвойсаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa) [Получение информации об инвойсеchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise) [Получение списка инвойсовchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov) [Получение информации о транзакцииchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii) [Получение списка транзакцийchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii) [Отмена инвойсаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa) [Получение актуального курса конвертацииchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii) [ПредыдущаяОписание процесса аутентификацииchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-processa-autentifikacii) [СледующаяПолучение информации о пользователеchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele) Последнее обновление 1 месяц назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Пополнение баланса | goodPayments.io Для того, чтобы пользоваться функционалом сервиса goodPayments, мерчанту необходимо пополнить баланс в системе. При регистрации мерчанта goodPayments генерирует 2 отдельных адреса для пополнения: **Адрес для оплаты комиссий сервиса (TRX Баланс)** – предназначен для пополнения основного баланса мерчанта, с которого осуществляется списание комиссий за генерацию инвойсов и пересылку средств на постоянный адрес мерчанта. Пополнение данного типа адреса доступно в токенах **TRX** и **USDT (TRC-20)**. **Адрес для оплаты активаций** – необходим для пополнения баланса активаций. С данного адреса осуществляется активация генерируемых временных адресов при обработке платежей в USDT (TRC-20). Пополнение данного типа адреса возможно **только в токене TRX**. Описание принципа работы данного адреса доступно в разделе [«Активация адресов»](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aktivaciya-adresov) . ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa#popolnenie-balansa-dlya-oplaty-komissii-servisa) Пополнение баланса для оплаты комиссии сервиса Пополнение баланса для оплаты комиссии за использование сервиса производится в разделе **«Баланс»**. При нажатии на кнопку **«Пополнить пересылки»** откроется модальное окно, в котором содержится: * Адрес пополнения * QR-код для сканирования * Селектор валюты пополнения (TRX или USDT TRC-20). Для того, чтобы пополнить баланс пересылок, необходимо отправить на указанный адрес криптовалюту с внешнего кошелька. После того, как транзакция будет подтверждена в блокчейне Tron, средства отобразятся в личном кабинете. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252Fy9FxY6bNlbCHECLpNY5n%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252011.27.54.png%3Falt%3Dmedia%26token%3Dd3cc1a96-a083-46fe-aa07-b2f2debe8ca6&width=768&dpr=3&quality=100&sign=bf661b2b&sv=2) **Для пополнения баланса доступны следующие валюты:** TRX Tron (TRC-20) USDT Tron (TRC-20) circle-exclamation **Обращаем ваше внимание**, что учет баланса в сервисе goodPayments ведется в токене **TRX**, поэтому при пополнении баланса в токене **USDT (TRC-20)**, сервис **автоматически конвертирует полученную валюту в TRX по курсу TRX/USDT** на момент совершения пополнения + **будет учтена комиссия сервиса в размере 6%.** ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa#popolnenie-balansa-aktivacii) Пополнение баланса активаций Пополнение баланса активаций аналогично пополнению баланса для оплаты комиссий сервиса. В разделе **«Баланс»** необходимо нажать на кнопку **«Пополнить активации»**, после чего откроется модальное окно с адресом пополнения и QR-кодом. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252Fptn9quD4aEYzHUrwzk5D%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252011.29.08.png%3Falt%3Dmedia%26token%3D83c52cdd-2308-45c9-b4b6-890972c8ae83&width=768&dpr=3&quality=100&sign=5bf82259&sv=2) После отправки средств на этот адрес и подтверждения транзакции в блокчейне Tron средства отобразятся на балансе активаций в личном кабинете мерчанта. circle-exclamation **Обращаем ваше внимание**, что пополнение баланса активаций доступно только в токене **TRX**. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa#istoriya-tranzakcii) История транзакций В разделе **«Баланс»** доступна история пополнений и списаний по балансам мерчанта. В истории отображается: * **Хэш транзакции** (ссылка на блокчейн-обозреватель) * **Тип операции** (Пополнение / Списание / Списание за AML) * **Сумма по операции** * **Счет** (Основной / Активации) * **Дата и время совершения операции** [ПредыдущаяПанель управления и Дашборд пользователяchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/editor) [СледующаяСоздание инвойсаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa) Последнее обновление 1 месяц назад * [Пополнение баланса для оплаты комиссии сервиса](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa#popolnenie-balansa-dlya-oplaty-komissii-servisa) * [Пополнение баланса активаций](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa#popolnenie-balansa-aktivacii) * [История транзакций](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa#istoriya-tranzakcii) sun-brightdesktopmoon sun-brightdesktopmoon --- # Статусы платежа | goodPayments.io **Активный** – инвойс создан, по нему ожидается оплата. **Завершен** – инвойс успешно обработан, плательщик совершил оплату и сервис goodPayments осуществил перевод полученной криптовалюты на адрес мерчанта. **Переплачен** – плательщик отправил сумму, превышающую сумму инвойса. Полученные средства пересылаются на адрес мерчанта в полном объеме. **Недоплачен** – плательщик отправил сумму, меньшую чем сумма инвойса. Полученные средства пересылаются на адрес мерчанта в полном объеме. **Отменен** – инвойс отменен. **Истекло время** – инвойс отменен, так как срок действия данного счета на оплату истек. **Ошибка** – инвойс не был успешно обработан из-за технического сбоя или некорректного выполнения операции (например, ошибка сети или сбой при переводе криптовалюты). Также данный статус устанавливается, если плательщик ошибочно перевел не ту криптовалюту, которая была указана в инвойсе. **AML-проверка не пройдена** – входящая транзакция не прошла AML-проверку. После присвоения данного статуса goodPayments возвращает полученные средства на адрес отправителя, инвойс закрывается и дальнейшая работа по инвойсу останавливается. [ПредыдущаяПлатежное окноchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/platezhnoe-okno) [СледующаяПереплата и неполная оплата по инвойсуchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/pereplata-i-nepolnaya-oplata-po-invoisu) Последнее обновление 5 дней назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Общая информация | goodPayments.io Данный раздел описывает способы интеграции с сервисом goodPayments и предназначен для разработчиков, которые хотят автоматизировать процесс приема платежей. goodPayments предоставляет REST API и использует формат JSON для передачи данных. Все запросы выполняются по защищенному протоколу HTTPS. В документации подробно описаны методы взаимодействия, структура запросов и ответов, правила авторизации, а также коды ошибок. Основные возможности API: * Авторизация запросов: получение и использование API-ключа, правила аутентификации и требования к заголовкам. * Информация о пользователе: получение сведений об аккаунте мерчанта и текущем балансе. * Работа с инвойсами: создание нового инвойса, получение информации по конкретному инвойсу, получение списка созданных инвойсов, отмена активного инвойса. * Курс конвертации: получение актуальных значений курса TRX/USDT для расчетов. [ПредыдущаяРеферальная программаchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/referalnaya-programma) [СледующаяПолучение API-ключаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/poluchenie-api-klyucha) Последнее обновление 4 месяца назад sun-brightdesktopmoon sun-brightdesktopmoon --- # AML-проверки | goodPayments.io goodPayments поддерживает AML-проверки входящих транзакций на предмет риска. При включенном режиме AML каждая входящая транзакция проходит проверку на AML перед отправкой на адрес мерчанта. Если уровень риска, полученный в ходе проверки транзакции, превышает установленный мерчантом порог, средства автоматически возвращаются на адрес отправителя. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki#aktivaciya-funkcii-aml-proverok) Активация функции AML-проверок Для включения функции AML-проверок необходимо перейти в раздел **«AML»** личного кабинета мерчанта и активировать переключатель **«Включить AML проверки»**. После активации становится доступной настройка **«Порог риска»**. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FPQKM5LIxn5xsugtWXLxv%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-03-16%2520%25D0%25B2%252017.51.01.png%3Falt%3Dmedia%26token%3Dfd2a334e-44c0-4672-a596-054b77cf8498&width=768&dpr=3&quality=100&sign=b0f28659&sv=2) #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki#porog-riska) Порог риска Порог риска определяет максимально допустимый уровень риска (0-100%) для входящих транзакций. Если значение риска, полученное при проверке, превышает установленный порог, проверка будет считаться не пройденной. Порог риска настраивается с помощью передвижения ползунка, при установке нового значения изменения сохраняются немедленно. circle-info Пример: при установленном пороге риска = 70%, любая транзакция, у которой при проверке значение риска выше данного параметра, будет отклонена. circle-info Если AML-проверки ни разу не активировались, ползунок настройки порога риска и история проверок не отображаются в интерфейсе раздела. При первой активации функции AML установка порога риска и история проверок отображаются мерчанту. Если была осуществлена хотя бы одна проверка, история проверок остается доступной даже при выключенной функции AML. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki#kak-rabotayut-aml-proverki) Как работают AML-проверки 1. Плательщик отправляет USDT TRC-20 на адрес, указанный в инвойсе. 2. goodPayments фиксирует входящую транзакцию и производит проверку данной транзакции на AML. 3. goodPayments сравнивает полученное в ходе проверки значение уровня риска с порогом, установленным мерчантом в личном кабинете. 4. Если проверка **пройдена** (значение риска в ходе проверки меньше установленного мерчантом значения в личном кабинете), стандартный процесс обработки платежа продолжается. 5. Если проверка **не пройдена** (значение риска в ходе проверки больше или равно установленному мерчантом значению в личном кабинете), инвойсу присваивается статус **«AML-проверка не пройдена»**, средства возвращаются отправителю. При этом, комиссия за AML-проверку и за обработку платежа списывается с баланса пересылок мерчанта, несмотря на отрицательный статус. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki#komissiya-za-aml-proverku) Комиссия за AML-проверку Стоимость каждой AML-проверки списывается с баланса пересылок мерчанта (основного баланса) в токене TRX. Размер комиссии = 1$, конвертируется в TRX по актуальному курсу пары USDT/TRX. Комиссия списывается вне зависимости от результата проверки, как при прохождении, так и при отклонении транзакции. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki#istoriya-proverok) История проверок В разделе **«AML»** личного кабинета мерчанта отображается таблица с историей всех проведенных проверок. Таблица содержит следующие данные: Колонка Описание ID инвойса Кликабельная ссылка на страницу с подробной информацией об инвойсе Хеш транзакции Хеш входящей транзакции, по которой проводилась проверка Адрес Адрес, на который поступили средства (сгенерированный в инвойсе) Результат Числовое значение уровня риска и статус проверки. Выделяется цветом: зеленый - проверка пройдена, красный - проверка не пройдена PDF отчет Кнопка для скачивания отчета о проверке в формате PDF Стоимость проверки Стоимость проверки в токене TRX Дата / время Дата и время проведения проверки [ПредыдущаяАктивация адресовchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aktivaciya-adresov) [СледующаяМассовые рассылкиchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki) Последнее обновление 1 месяц назад * [Активация функции AML-проверок](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki#aktivaciya-funkcii-aml-proverok) * [Как работают AML-проверки](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki#kak-rabotayut-aml-proverki) * [Комиссия за AML-проверку](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki#komissiya-za-aml-proverku) * [История проверок](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki#istoriya-proverok) sun-brightdesktopmoon sun-brightdesktopmoon --- # Платежное окно | goodPayments.io При создании инвойса генерируется платежное окно – веб-страница, которая отображается плательщику и доступна по уникальному URL-адресу. Платежное окно при первом открытии содержит следующие детали платежа: * **ID инвойса** * **Таймер обратного отсчета** (указывается при создании инвойса) * **Сумма в USDT ($)** * **Статус** * **Выбор валюты оплаты** ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FBhQmKmlKDMEQAdG4mkI7%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.54.27.png%3Falt%3Dmedia%26token%3D73c9a664-e53d-408b-bca8-198cfc54c9b3&width=768&dpr=3&quality=100&sign=de13a3da&sv=2) Перед осуществлением оплаты в платежном окне необходимо выбрать валюту, в которой будет производиться оплата по инвойсу. После выбора валюты оплаты в платежном окне раскрывается дополнительная информация: * **Способ оплаты:** * **Криптовалюта** * **Сеть** * **Адрес, на который плательщик должен отправить средства** * **Кнопка копирования адреса** * **Сумма в выбранной криптовалюте** * **QR-код адреса для сканирования в мобильном приложении криптовалютного кошелька** * **Кнопка отмены платежа** ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FCRez7CEVIKVBheQMghO0%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.55.22.png%3Falt%3Dmedia%26token%3D43cd4a61-90b5-4f5c-8bc3-994ec6b09ffe&width=768&dpr=3&quality=100&sign=fe06cb20&sv=2) При создании инвойса в сервисе goodPayments сумма оплаты указывается в USDT, однако плательщикам также доступна оплата в токене TRX (если данный токен был выбран в качестве доступного к оплате в момент создания инвойса). Если плательщик выбирает TRX в качестве валюты оплаты по инвойсу, то в платежном окне в поле **«Сумма к оплате»** отображается точная сумма TRX, пересчитанная по текущему курсу пары TRX/USDT. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FNFA7U2cIoqxSgKQPsgyx%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.56.14.png%3Falt%3Dmedia%26token%3Dbdce406c-3b0e-49db-bcff-ff8d27d33ca0&width=768&dpr=3&quality=100&sign=cc5d71e2&sv=2) После совершения успешной оплаты по инвойсу платежное окно обновится и плательщику будет отображен статус по операции: ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FgO7k5nlgIlO3r7fK6dyD%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.57.58.png%3Falt%3Dmedia%26token%3Dba8e6748-7edc-49a6-b7ae-b2b46bc58693&width=768&dpr=3&quality=100&sign=fc895e4a&sv=2) Если инвойс не будет оплачен плательщиком в течение срока действия данного инвойса, платежное окно обновится и плательщик будет уведомлен о том, что срок действия инвойса истек. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FsJgu7IUivU8tPIVd3pwD%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.58.50.png%3Falt%3Dmedia%26token%3D1ec26b62-9716-4c10-b213-6891e68b04c5&width=768&dpr=3&quality=100&sign=e9312974&sv=2) Если инвойс будет отменен мерчантом по какой-либо причине, то платежное окно будет содержать информацию о том, что инвойс отменен. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FQsPJVxHvoy740WL69QVM%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.58.24.png%3Falt%3Dmedia%26token%3D8dc7a357-7c41-4a44-ab02-d71d36804033&width=768&dpr=3&quality=100&sign=229a93f6&sv=2) [ПредыдущаяСоздание инвойсаchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa) [СледующаяСтатусы платежаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/statusy-platezha) Последнее обновление 1 месяц назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Получение информации о пользователе | goodPayments.io Запрос на получение данных об аккаунте мерчанта. GET [https://app.goodpayments.io/v1/api/merchantarrow-up-right](https://app.goodpayments.io/v1/api/merchant) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#telo-zaprosa) Тело запроса Данный запрос не предполагает передачу параметров в теле. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#primer-zaprosa) Пример запроса Копировать curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/merchant' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#otvet) Ответ Имя Тип Описание Пример email string Электронная почта, указанная при регистрации аккаунта example@gmail.com balance number Баланс мерчанта для оплаты комиссии за использование сервиса (в TRX) 771.011200337155 target\_wallet\_address string Адрес, куда пересылаются входящие платежи по инвойсам TQ7yFpVJh1zdQRVkBmi5EbtoTunkURNwst topup\_wallet\_address string Адрес пополнения баланса для оплаты комиссии за использование сервиса TEhxXuomfC57nX7ohdiRHVm6DF5Ram6YAr activation\_wallet\_address string Адрес пополнения баланса для активаций TSsixXatTUkAn8LsfRQdjwk3dUDQD2PD2u activation\_balance number Баланс адреса активаций (в TRX) 4524.233396065855 aml\_check boolean Флаг активации / деактивации функции AML проверок true aml\_risk\_limit integer Установленный порог риска 50.04 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#primer-otveta) Пример ответа 200 Success 403 Authentication credentials were not provided ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#vozmozhnye-oshibki) Возможные ошибки Если заголовок с корректным API-ключом отсутствует или ключ недействителен, сервер возвращает ответ с кодом **403**. [ПредыдущаяОписание методов взаимодействия (структура запроса/ответа)chevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta) [СледующаяСоздание инвойсаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa) Последнее обновление 1 месяц назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать { "email": "example@gmail.com", "balance": 771.011200337155, "target_wallet_address": "TQ7yFpVJh1zdQRVkBmi5EbtoTunkURNwst", "topup_wallet_address": "TEhxXuomfC57nX7ohdiRHVm6DF5Ram6YAr", "activation_wallet_address": "TSsixXatTUkAn8LsfRQdjwk3dUDQD2PD2u", "activation_balance": 4524.233396065855, "aml_check": true, "aml_risk_limit": 50.04 } Копировать { "detail": "Authentication credentials were not provided." } sun-brightdesktopmoon --- # Terms and Definitions | goodPayments.io **Merchant** – a goodPayments user who uses the service to accept cryptocurrency payments for goods or services. **Payer** – the merchant’s customer who completes the payment using the invoice created by the merchant. **Invoice** – a payment request generated by the merchant via the API or the goodPayments dashboard. Each invoice includes the payment amount, currency, expiration time, and the cryptocurrency address for payment. **Temporary Address** – a unique, single-use blockchain address generated when an invoice is created. It remains active only for the duration of the invoice’s payment window. Once the payment is completed or the invoice expires, this address becomes inactive and is no longer monitored. **Static Address** – a permanent cryptocurrency address generated when an invoice is created with the «Static» address type. Unlike a temporary address, a static address remains active and continues to be monitored until manually deactivated by the merchant. A static address can receive multiple incoming payments. **Forwarding Address** – the merchant’s own wallet address, specified in the account settings. goodPayments automatically forwards all funds received on paid invoices to this address. This is the final destination for incoming payments. **Activation Address** – a service-generated address used by goodPayments to activate temporary addresses created for invoices. It ensures that temporary addresses can perform outbound transactions when needed. **Address Activation** – the process required in the Tron blockchain to enable outgoing transactions from a newly created address. **AML Check** – an automated screening of incoming transactions for risk. The check is designed to identify potential links between the incoming asset and illegal activity. **Service Fee** – the goodPayments fee for processing an incoming payment and forwarding funds to the merchant’s wallet. The fee amount depends on whether the merchant’s address holds USDT. The fee is **6.5 TRX** if the merchant wallet contains USDT, otherwise **13 TRX**. [PreviousKey Featureschevron-left](https://goodpayments.gitbook.io/docs/general-info/key-features) [NextSupported Tokens and Chainschevron-right](https://goodpayments.gitbook.io/docs/general-info/supported-tokens-and-chains) Last updated 1 month ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Получение актуального курса конвертации | goodPayments.io Запрос на получение актуального курса конвертации. Возможно указание значений: TRX и USDT. Для осуществления запроса параметр currency необходимо передать в URL-эндпойнте. GET [https://app.goodpayments.io/v1/api/rates?currency=TRXarrow-up-right](https://app.goodpayments.io/v1/api/rates?currency=TRX) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#telo-zaprosa) Тело запроса Данный запрос не предполагает передачу параметров в теле. Все необходимые параметры указываются в URL-эндпойнте. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#primer-zaprosa) Пример запроса Копировать curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/rates?currency=TRX' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#otvet) Ответ Имя Тип Описание Пример currency string Валюта. Возможные значения: * `TRX` * `USDT` TRX rate number Актуальный курс конвертации 0.27700958 fee number Размер комиссии сервиса, взимаемой при пополнении баланса мерчанта в USDT 0.06 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#primer-otveta) Пример ответа 200 Success 403 Authentication credentials were not provided 404 Currency not found ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#vozmozhnye-oshibki) Возможные ошибки Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**. Если в запросе указана некорректная валюта, сервер возвращает ответ с кодом **404**. [ПредыдущаяОтмена инвойсаchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa) [СледующаяВебхукиchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/vebkhuki) Последнее обновление 5 дней назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать { "currency": "TRX", "rate": 0.27700958, "fee": 0 } Копировать { "detail": "Authentication credentials were not provided." } Копировать { "detail": "Currency not found" } sun-brightdesktopmoon --- # What is goodPayments? | goodPayments.io **goodPayments** is a service that enables your business to accept cryptocurrency payments effortlessly. The platform handles the full payment flow end-to-end: every transaction from your customer is processed automatically, and the funds are sent directly to your wallet with no delays. Getting started with goodPayments is quick and doesn’t require any KYC. Simply [top up your balance](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up) and [set the address](https://goodpayments.gitbook.io/docs/getting-started/adding-a-payout-wallet) where you want to receive incoming payments – that’s it. You can create payment invoices either through the dashboard or programmatically via the [API](https://goodpayments.gitbook.io/docs/api-reference/general-information) . The integration process is straightforward, so you can connect to our API and start accepting payments the same day. #### [hashtag](https://goodpayments.gitbook.io/docs/general-info/what-is-goodpayments#key-features-of-the-platform) Key Features of the Platform * Fast onboarding – no identity verification (KYC) required * No setup fees; fixed service fees of 6.5 or 13 TRX per full payment cycle * A unique temporary address is generated for each invoice * Funds are sent directly to your wallet – goodPayments does not hold customer funds * A clear and intuitive dashboard to track payments, manage generated addresses, and monitor commission expenses * Optional Telegram notifications – instantly receive updates about your customers’ payments right in your messenger [PreviousWelcomechevron-left](https://goodpayments.gitbook.io/docs) [NextKey Featureschevron-right](https://goodpayments.gitbook.io/docs/general-info/key-features) Last updated 4 months ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Fees and Limits | goodPayments.io ### [hashtag](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#service-fees) **Service Fees** The goodPayments service fee for processing incoming payments depends on the following conditions: Fee Condition **6.5 TRX** • The invoice is paid in **TRX** • The invoice is paid in **USDT**, and the merchant’s payout address **has USDT** on it **13 TRX** • The invoice is paid in **USDT**, and the merchant’s payout address **does not contain any USDT** * * * ### [hashtag](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#including-fees-in-the-invoice-amount) Including Fees in the Invoice Amount When creating a temporary invoice, the merchant can enable the **«Include fees in the invoice amount»** flag. If this option is active, the service fee is added to the invoice total and is paid by the buyer. How it works: * the service fee is added on top of the order amount and charged to the payer – they pay more than the original invoice amount; * funds are still debited from the merchant's forwarding balance as usual; * the merchant recovers the fee via the amount included in the invoice total. circle-exclamation The fee is included in the invoice amount in the currency the invoice is created. The debit from the merchant's forwarding balance occurs regardless of this setting. * * * ### [hashtag](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#address-activation-fees-from-the-activation-balance) **Address Activation Fees (from the activation balance)** Activation fees apply only when a temporary invoice address needs to be activated for outgoing transactions: * **If the payer sends TRX** to the generated invoice address – **no activation fee is charged**. * **If the payer sends USDT (TRC-20)** – the system performs a technical transaction of **0.000001 TRX + 1.1 TRX** (Tron network activation fee) from the activation address. No additional or hidden fees are charged by the service. * * * ### [hashtag](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#aml-check-fee) **AML Check Fee** When the AML checks feature is enabled, a fee is charged for each check performed. The fee is deducted from the merchant's forwarding balance (main balance) in TRX. The fee amount is **$1**, converted to TRX at the current USDT/TRX exchange rate. The fee is charged regardless of the check result – both for passed and failed checks. * * * ### [hashtag](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#limits) **Limits** Limit Value **Minimum payment amount** 0.01 USDT (recommended > 1 USDT/TRX to cover fees) **Maximum payment amount** Not limited by the service **Temporary address lifetime** Set by the merchant when creating an invoice (default: 30 minutes) * * * ### [hashtag](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#important-notes) **Important Notes** * The service fee is **not deducted** from the customer’s payment. It is charged separately from the merchant’s balance. * If the merchant’s balance is insufficient to pay the service fee, **payment processing for all invoices will be paused** until the balance is topped up. [PreviousSupported Tokens and Chainschevron-left](https://goodpayments.gitbook.io/docs/general-info/supported-tokens-and-chains) [NextAccount Registrationchevron-right](https://goodpayments.gitbook.io/docs/getting-started/account-registration) Last updated 5 days ago * [Service Fees](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#service-fees) * [Including Fees in the Invoice Amount](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#including-fees-in-the-invoice-amount) * [Address Activation Fees (from the activation balance)](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#address-activation-fees-from-the-activation-balance) * [AML Check Fee](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#aml-check-fee) * [Limits](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#limits) * [Important Notes](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits#important-notes) sun-brightdesktopmoon sun-brightdesktopmoon --- # Создание инвойса | goodPayments.io Раздел **«Инвойсы»** личного кабинета мерчанта предназначен для управления счетами на оплату, выставленными в адрес плательщиков. В данном разделе мерчанту доступно создание инвойсов и отслеживание истории транзакций по всем платежам. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#sozdanie-invoisa) Создание инвойса Для создания инвойса необходимо нажать на кнопку **«Новый инвойс»**, после чего откроется модальное окно создания инвойса. На первом шаге необходимо выбрать тип адреса: * **Временный адрес** – одноразовый адрес, действует в течение заданного периода времени (по умолчанию 30 минут). Подходит для разовых платежей. * **Статичный адрес** – постоянный адрес, может принимать множество входящих платежей и остается активным до момента ручной деактивации адреса мерчантом. В зависимости от типа адреса набор доступных полей для заполнения и логика работы адреса будут отличаться. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#vremennyi-adres) Временный адрес ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FXfvpnAM8juCjpSKs5Rf4%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-17%2520%25D0%25B2%252011.16.22.png%3Falt%3Dmedia%26token%3Dc959a2cc-db23-420b-8f97-717633caf039&width=768&dpr=3&quality=100&sign=fac20b90&sv=2) В модальном окне мерчанту доступны для заполнения следующие поля: Поле Обязательность Значение **Сумма USDT** Обязательное поле Ввод суммы к оплате по данному счету (в USD/USDT) **Включить комиссии в сумму инвойса** Необязательное поле Флаг добавления комиссии за пересылку в сумму инвойса. Если данный флаг активирован, комиссия сервиса включается в сумму к оплате по инвойсу – ее оплачивает плательщик. **Разрешенные валюты** Обязательное поле Селектор разрешенной валюты для оплаты. Доступен выбор: * TRX * USDT (TRC-20) * TRX и USDT (TRC-20): разрешена отправка в обоих токенах. **Время истечения (минуты)** Необязательное поле Установка времени, в течение которого данный инвойс активен. По умолчанию установлено **30 минут**. **ID заказа** Необязательное поле Идентификатор заказа в системе мерчанта **URL перенаправления** Необязательное поле Адрес страницы, на которую будет перенаправлен плательщик после совершения оплаты по инвойсу. **URL вебхука** Необязательное поле Адрес, на который сервис goodPayments будет отправлять уведомление после совершения плательщиком оплаты по инвойсу **Комментарий** Необязательное поле Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу После заполнения всех требуемых полей для создания инвойса на оплату необходимо нажать на кнопку **«Создать»**. Созданный инвойс отобразится в таблице с историей платежей в разделе **«Инвойсы»**. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#statichnyi-adres) Статичный адрес ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FLplFpb2sOQAdGvoc5SXM%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-03-17%2520%25D0%25B2%252010.07.34.png%3Falt%3Dmedia%26token%3Dffea966a-efe0-4db4-b57d-2c3b4f3f823d&width=768&dpr=3&quality=100&sign=d6e3b7be&sv=2) Статичный адрес – это постоянный адрес для приема платежей, который остается активным до момента ручной деактивации. В отличие от временного адреса, он не привязан к конкретному сроку и может принимать неограниченное количество платежей. В модальном окне мерчанту доступны для заполнения следующие поля: Поле Обязательность Значение **Разрешенные валюты** Обязательное поле Селектор разрешенной валюты для оплаты. Доступен выбор: * TRX * USDT (TRC-20) * TRX и USDT (TRC-20): разрешена отправка в обоих токенах. **ID заказа** Необязательное поле Идентификатор заказа в системе мерчанта **URL вебхука** Необязательное поле Адрес, на который сервис goodPayments будет отправлять уведомление после совершения плательщиком оплаты по инвойсу **Комментарий** Необязательное поле Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу Поле **«Время истечения (минуты)»** для статичного адреса не отображается – такой инвойс не имеет срока действия. circle-info Ссылка на платежное окно для статичного адреса бессрочная, таймер обратного отсчета на ней не отображается. Ссылка перестает быть активной только после деактивации адреса мерчантом. **Деактивация статичного адреса** – для прекращения приема платежей по статичному адресу необходимо деактивировать адрес. Деактивация осуществляется по кнопке **«Отмена»**, которая расположена в таблице инвойсов в колонке **«Действия»**. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#istoriya-platezhei) История платежей История платежей представляет собой таблицу, где хранятся записи по всем созданным мерчантам инвойсам. Таблица расположена в разделе **«Инвойсы»** и содержит следующие значения: * **ID инвойса**: уникальный идентификатор созданного инвойса. При нажатии на ID открывается страница с подробной информацией об инвойсе; * **Ссылка на оплату**: ссылка на платежное окно сформированного инвойса. Также присутствует кнопка **«Копировать»**, для копирования ссылки на платежное окно; * **Транзакция оплаты**: ссылка на хэш входящей транзакции по данному инвойсу; * **Адрес**: созданный адрес для приема криптовалюты от плательщика; * **Тип адреса**: временный, статичный или рассылок; * **Время**: дата и время создания инвойса; * **Валюты для оплаты**: разрешенные валюты для оплаты по инвойсу; * **Сеть**: сеть приема валюты; * **Статус**: текущий статус инвойса; * **Сумма**: ожидаемая сумма оплаты по инвойсу; * **Действия**: кнопка отмены созданного инвойса. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#podrobnaya-informaciya-ob-invoise) Подробная информация об инвойсе После создания инвойса в сервисе goodPayments мерчанту доступна страница с подробной информацией об инвойсе. Для перехода на данную страницу необходимо нажать на ID инвойса в таблице с историей платежей. Страница с подробной информацией об инвойсе содержит 5 основных блоков с данными. 1. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#obshaya-informaciya) Общая информация Отображается: * ID инвойса * текущий статус инвойса * дата и время создания инвойса * дата и время действия инвойса * дата и время последнего изменения статуса инвойса * ссылка на хэш транзакции активации временного адреса * ссылка на платежное окно * тип адреса * ID заказа в системе мерчанта * разрешенные валюты для оплаты инвойса 1. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#summy) Суммы Отображаются запрошенные и фактические суммы по инвойсу: * ожидаемая сумма по инвойсу * сколько получено * сколько переслано мерчанту * комментарий по инвойсу (если при создании инвойса мерчант ничего не указал в поле **«Комментарий»** – то отображается значение **«Комментарий отсутствует»**) 1. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#tranzakcii) Транзакции Содержатся блокчейн-данные о приеме и пересылке средств: * ссылка на хэш транзакции поступления средств от плательщика * ссылка на хэш транзакции пересылки поступивших средств на адрес мерчанта * адреса приема – отображаются адреса плательщика и временный адрес, сгенерированный при создании инвойса * адреса пересылки – отображаются адрес, сгенерированный при создании инвойса и адрес мерчанта, куда были переведены средства Для статичных адресов транзакции отображаются в модальном окне, доступном при нажатии на кнопку **«Смотреть транзакции»**. В модальном окне доступны дополнительные данные: * полученная сумма по транзакции * валюта платежа 1. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#perenapravleniya-i-vebkhuki) Перенаправления и вебхуки Содержат URL: * Адрес страницы, на которую перенаправляется плательщик после совершения оплаты по инвойсу * Адрес, на который сервис goodPayments отправляет уведомление после совершения плательщиком оплаты по инвойсу 1. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#aml-proverka) AML проверка При активированной функции AML-проверок отображается дополнительный блок с AML проверками. При нажатии на кнопку **«Смотреть проверки AML»** осуществляется перенаправление в раздел **«AML»** личного кабинета мерчанта. [ПредыдущаяПополнение балансаchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa) [СледующаяПлатежное окноchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/platezhnoe-okno) Последнее обновление 5 дней назад * [Создание инвойса](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#sozdanie-invoisa) * [История платежей](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#istoriya-platezhei) * [Подробная информация об инвойсе](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/sozdanie-invoisa#podrobnaya-informaciya-ob-invoise) sun-brightdesktopmoon sun-brightdesktopmoon --- # Supported Tokens and Chains | goodPayments.io goodPayments currently supports receiving payments on the **Tron Mainnet**. #### [hashtag](https://goodpayments.gitbook.io/docs/general-info/supported-tokens-and-chains#supported-tokens) Supported Tokens Token Network **TRX** Tron (TRC-20) **USDT** Tron (TRC-20) We plan to expand the list of supported networks and cryptocurrencies in the future. [PreviousTerms and Definitionschevron-left](https://goodpayments.gitbook.io/docs/general-info/terms-and-definitions) [NextFees and Limitschevron-right](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits) Last updated 1 month ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Получение информации об инвойсе | goodPayments.io Запрос на получение данных конкретного инвойса по id инвойса. Id инвойса указывается в URL-эндпойнте. GET [https://app.goodpayments.io/v1/api/payment/get/{id}arrow-up-right](https://app.goodpayments.io/v1/api/payment/get/%7Bid%7D) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#telo-zaprosa) Тело запроса Данный запрос не предполагает передачу параметров в теле. Все необходимые параметры указываются в URL-эндпойнте. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#primer-zaprosa) Пример запроса Копировать curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/payment/get/123477361' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#otvet) Ответ Имя Тип Описание Пример id integer Уникальный идентификатор инвойса 123477361 status string Статус инвойса. Возможные значения: * `ACTIVE` * `COMPLETED` * `CANCELED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Тип инвойса. `SINGLE` - временный адрес `MULTIPLE` - статичный адрес `MULTIPLE_TRANSFER` - адрес рассылок SINGLE paymentURL string Ссылка на платежное окно [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Сумма к оплате, указанная в инвойсе (в USD) 1 currencies string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Сумма к оплате по инвойсу в принимаемой валюте "TRX": 3.6329 transfer\_amounts string Фактически полученная сумма "TRX": 3.6329 cost number Комиссия сервиса за обработку платежа 6.5 order\_id string Идентификатор заказа в системе мерчанта. Макс. 256 символов 12345 address string Сгенерированный временный адрес для оплаты TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Флаг, определяющий, кто оплачивает комиссию за пересылку. Только для инвойса с типом `SINGLE`. * true – комиссия списывается с клиента. Сумма инвойса увеличивается на размер комиссии, и клиент оплачивает итоговую сумму. * false – комиссию оплачивает мерчант. true / false webhook\_url string Адрес, на который сервис goodPayments будет отправлять уведомление (webhook) после совершения плательщиком оплаты по инвойсу https://example.com/webhook redirect\_url string Адрес страницы, на которую будет перенаправлен плательщик после совершения оплаты по инвойсу https://example.com/thank-you description string Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу Payment for order #123 merchant\_contact string Контактные данные мерчанта @username target\_wallets object Объект, содержащий список адресов и сумму к отправке (для инвойсов с типом `MULTIPLE_TRANSFER`) expired\_at string Дата и время истечения срока действия инвойса 2025-11-23T14:28:57.786076+00:00 created\_at string Дата и время создания инвойса 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#primer-otveta) Пример ответа 200 Success 404 No Invoice matches the given query ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#vozmozhnye-oshibki) Возможные ошибки Если в теле запроса указан некорректный id, сервер возвращает ответ с кодом **404**. [ПредыдущаяСоздание инвойсаchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa) [СледующаяПолучение списка инвойсовchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov) Последнее обновление 5 дней назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать { "id": 336575574, "status": "ACTIVE", "type": "SINGLE", "paymentURL": "https://app.goodpayments.io/payment/336575574", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "currencies_amounts": { "TRX": 33.402357, "USDT": 10 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": null, "client_commission": true, "order_id": null, "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53", "webhook_url": null, "redirect_url": null, "description": "", "merchant_contact": "@username", "target_wallets": {}, "expired_at": "2026-03-17T11:59:07.515594+03:00", "created_at": "2026-03-17T11:29:07.518981+03:00" } Копировать { "detail": "No Invoice matches the given query." } sun-brightdesktopmoon --- # Получение списка транзакций | goodPayments.io Запрос для получения постраничного списка транзакций мерчанта с поддержкой фильтрации, сортировки и поиска. _**Фильтрация**_ `type` – фильтрация типу транзакции: (`PAYMENT`, `TRANSFER`, `TOPUP`, `ACTIVATION`) `invoice_id` – фильтрация по ID связанного инвойса `from_address` – фильтрация по адресу отправителя `to_address` – фильтрация по адресу получателя `trn_hash` – фильтрация по хэшу транзакции `has_aml` – фильтрация по наличию AML-проверки: (`true`, `false`) `currency` – фильтрация по валюте инвойса (`"TRX"`, `"USDT"`) `date_from` – отбор инвойсов, созданных начиная с указанной даты (включительно). Формат: `YYYY-MM-DD` `date_to` – отбор инвойсов, созданных до указанной даты (включительно). Формат: `YYYY-MM-DD` _**Сортировка**_ Используйте параметр `ordering` для сортировки результатов по полям `created_at`, `amount` или `status`. Для сортировки по убыванию добавьте префикс `-`, например: `ordering` \= `-created_at` _**Пагинация**_ Управляется параметрами `limit` и `offset` Значение по умолчанию `limit`: **10** _**Поиск**_ Поиск доступен по параметрам: `trn_hash`, `invoice_id`, `type`, `currency`, `from_address`, `to_address` GET [https://app.goodpayments.io/v1/api/transaction/list?date\_from=2025\_10\_25&has\_aml=truearrow-up-right](https://app.goodpayments.io/v1/api/transaction/list?date_from=2025_10_25&has_aml=true) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#telo-zaprosa) Тело запроса Данный запрос не предполагает передачу параметров в теле. Все необходимые параметры указываются в URL-эндпойнте. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#primer-zaprosa) Пример запроса ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#otvet) Ответ Имя Тип Описание Пример trn\_hash string Хэш транзакции 896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b invoice integer ID связанного инвойса 123477361 type string Тип транзакции. Возможные значения: `PAYMENT`, `TRANSFER`, `TOPUP`, `ACTIVATION` PAYMENT from\_address string Адрес отправителя TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn to\_address string Адрес получателя TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze amount number Отправленная сумма 1 currency string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` "TRX" aml\_check object Результат AML проверки. Присутствует только если по транзакции проводилась проверка. Структура объекта описана ниже event\_id string UUID, связывающий входящий платеж и соответствующий исходящий перевод в рамках одного платежного события null created\_at string Дата и время создания транзакции 2025-11-23T13:58:57.789617+00:00 #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#obekt-aml_check) Объект aml\_check Имя Тип Описание Пример id string Идентификатор AML-проверки status string Статус проверки: `SUCCESS`, `FAILED`, `TIMEOUT`, `ERROR`. SUCCESS risk\_score number Значение риска, полученное в ходе проверки 50 risk\_level string Текстовое обозначение уровня риска: `low`, `medium` или `high`. low exposure object Объект с детализацией источников риска report\_url string URL для скачивания PDF-отчета https://... cost number Комиссия за AML проверку (в токене TRX) 3.1 completed boolean Завершена ли AML проверка true created\_at string Дата и время создания проверки 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#primer-otveta) Пример ответа 200 Success 403 Authentication credentials were not provided 404 Address not found ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#vozmozhnye-oshibki) Возможные ошибки Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**. Если в запросе указан некорректный id, сервер возвращает ответ с кодом **404**. [ПредыдущаяПолучение информации о транзакцииchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii) [СледующаяСоздание массовой рассылкиchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki) Последнее обновление 5 дней назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/transaction/list?date_from=2025_10_25&has_aml=true' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' Копировать { "trn_hash": "896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b", "invoice": 123477361, "type": "PAYMENT", "from_address": "TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn", "to_address": "TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze", "amount": 3.6329, "currency": "TRX", "aml_check": null, "event_id": null, "created_at": "2025-11-23T16:59:30.477619+03:00" } Копировать { "detail": "Authentication credentials were not provided." } Копировать { "detail": "Address not found." } sun-brightdesktopmoon --- # Получение информации о транзакции | goodPayments.io Запрос для получения подробной информации о конкретной транзакции по ее хэшу. Если по транзакции проводилась AML-проверка, ответ включает объект aml\_check с полными результатами проверки. GET [https://app.goodpayments.io/v1/api/transaction/{trn\_hash}arrow-up-right](https://app.goodpayments.io/v1/api/transaction/%7Btrn_hash%7D) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#telo-zaprosa) Тело запроса Данный запрос не предполагает передачу параметров в теле. Все необходимые параметры указываются в URL-эндпойнте. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#primer-zaprosa) Пример запроса Копировать curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/transaction/896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#otvet) Ответ Имя Тип Описание Пример trn\_hash string Хэш транзакции 896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b invoice integer ID связанного инвойса 123477361 type string Тип транзакции. Возможные значения: `PAYMENT`, `TRANSFER`, `TOPUP`, `ACTIVATION` PAYMENT from\_address string Адрес отправителя TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn to\_address string Адрес получателя TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze amount number Отправленная сумма 1 currency string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` "TRX" aml\_check object Результат AML проверки. Присутствует только если по транзакции проводилась проверка. Структура объекта описана ниже event\_id string UUID, связывающий входящий платеж и соответствующий исходящий перевод в рамках одного платежного события null created\_at string Дата и время создания транзакции 2025-11-23T13:58:57.789617+00:00 #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#obekt-aml_check) Объект aml\_check Имя Тип Описание Пример id string Идентификатор AML-проверки status string Статус проверки: `SUCCESS`, `FAILED`, `TIMEOUT`, `ERROR`. SUCCESS risk\_score number Значение риска, полученное в ходе проверки 50 risk\_level string Текстовое обозначение уровня риска: `low`, `medium` или `high`. low exposure object Объект с детализацией источников риска report\_url string URL для скачивания PDF-отчета https://... cost number Комиссия за AML проверку (в токене TRX) 3.1 completed boolean Завершена ли AML проверка true created\_at string Дата и время создания проверки 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#primer-otveta) Пример ответа 200 Success 403 Authentication credentials were not provided 404 Address not found ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#vozmozhnye-oshibki) Возможные ошибки Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**. Если в запросе указан некорректный id, сервер возвращает ответ с кодом **404**. [ПредыдущаяПолучение списка инвойсовchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov) [СледующаяПолучение списка транзакцийchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii) Последнее обновление 5 дней назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать { "trn_hash": "896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b", "invoice": 123477361, "type": "PAYMENT", "from_address": "TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn", "to_address": "TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze", "amount": 3.6329, "currency": "TRX", "aml_check": null, "event_id": null, "created_at": "2025-11-23T16:59:30.477619+03:00" } Копировать { "detail": "Authentication credentials were not provided." } Копировать { "detail": "Address not found." } sun-brightdesktopmoon --- # Вебхуки | goodPayments.io Вебхуки позволяют автоматически получать уведомления о смене статуса инвойса без необходимости постоянных API-запросов. Уведомления отправляются на URL-адрес, который указывается мерчантом при создании инвойса (в личном кабинете или через API). Чтобы получать вебхуки, необходимо при создании инвойса указать параметр `webhook_url`, например: Копировать "webhook_url": "https://example.com/webhook" Вебхук отправляется при каждом изменении статуса инвойса на одно из следующих значений: COMPLETED Инвойс оплачен, средства переданы мерчанту. Только для инвойсов с временными адресами TIMEOUT Срок действия инвойса истек. Только для инвойсов с временными адресами AML\_FAILED Платеж не прошел AML-проверку. Средства возвращены отправителю OVERPAID Инвойс переплачен, средства переданы мерчанту. Только для инвойсов с временными адресами. UNDERPAID Инвойс недоплачен, средства переданы мерчанту. Только для инвойсов с временными адресами. ERROR Инвойс обработан с ошибкой. Платеж по инвойсу со статичным адресом Получен и обработан платеж по инвойсу со статичным адресом. Отправляется отдельно для каждого платежного события Формат вебхука: Копировать { "id": 336575574, "status": "ACTIVE", "type": "SINGLE", "paymentURL": "https://app.goodpayments.io/payment/336575574", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "currencies_amounts": { "TRX": 33.402357, "USDT": 10 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": null, "client_commission": true, "order_id": null, "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53", "webhook_url": null, "redirect_url": null, "description": "", "merchant_contact": "@username", "target_wallets": {}, "expired_at": "2026-03-17T11:59:07.515594+03:00", "created_at": "2026-03-17T11:29:07.518981+03:00" } Имя Тип Описание Пример id integer Уникальный идентификатор инвойса 123477361 status string Статус инвойса. Возможные значения: * `COMPLETED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Тип инвойса. `SINGLE` - временный адрес `MULTIPLE` - статичный адрес `MULTIPLE_TRANSFER` - адрес рассылок SINGLE paymentURL string Ссылка на платежное окно [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Сумма к оплате, указанная в инвойсе (в USD) 1 currencies string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Сумма к оплате по инвойсу в принимаемой валюте "TRX": 3.6329 transfer\_amounts string Фактически полученная сумма "TRX": 3.6329 cost number Комиссия сервиса за обработку платежа 6.5 order\_id string Идентификатор заказа в системе мерчанта. Макс. 256 символов 12345 address string Сгенерированный временный адрес для оплаты TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Флаг, определяющий, кто оплачивает комиссию за пересылку. Только для инвойса с типом `SINGLE`. * true – комиссия списывается с клиента. Сумма инвойса увеличивается на размер комиссии, и клиент оплачивает итоговую сумму. * false – комиссию оплачивает мерчант. true / false webhook\_url string Адрес, на который сервис goodPayments будет отправлять уведомление (webhook) после совершения плательщиком оплаты по инвойсу https://example.com/webhook redirect\_url string Адрес страницы, на которую будет перенаправлен плательщик после совершения оплаты по инвойсу https://example.com/thank-you description string Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу Payment for order #123 merchant\_contact string Контактные данные мерчанта @username target\_wallets object Объект, содержащий список адресов и сумму к отправке (для инвойсов с типом `MULTIPLE_TRANSFER`) expired\_at string Дата и время истечения срока действия инвойса 2025-11-23T14:28:57.786076+00:00 created\_at string Дата и время создания инвойса 2025-11-23T13:58:57.789617+00:00 Вебхук отправляется однократно. Если ваш сервер не ответил в течение 10 секунд, вебхук не будет повторно отправлен. В таком случае рекомендуется самостоятельно запрашивать статус инвойса через API при необходимости. [ПредыдущаяПолучение актуального курса конвертацииchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii) [СледующаяОтветы на часто задаваемые вопросыchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy) Последнее обновление 5 дней назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Account Settings | goodPayments.io [2FA Authenticationchevron-right](https://goodpayments.gitbook.io/docs/getting-started/account-settings/2fa-authentication) [Password Changechevron-right](https://goodpayments.gitbook.io/docs/getting-started/account-settings/password-change) [Enabling Telegram Notificationschevron-right](https://goodpayments.gitbook.io/docs/getting-started/account-settings/enabling-telegram-notifications) [PreviousAccount Registrationchevron-left](https://goodpayments.gitbook.io/docs/getting-started/account-registration) [Next2FA Authenticationchevron-right](https://goodpayments.gitbook.io/docs/getting-started/account-settings/2fa-authentication) Last updated 4 months ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Key Features | goodPayments.io #### [hashtag](https://goodpayments.gitbook.io/docs/general-info/key-features#core-features-of-goodpayments) **Core Features of goodPayments** [**Merchant registration and account management.**](https://goodpayments.gitbook.io/docs/getting-started/account-registration) To get started, simply sign up on the platform, verify your account, configure your profile, enable 2FA, set your payout address, obtain your API key, and enable Telegram notifications. [**Invoice generation.**](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation) You can create payment invoices through the API or directly in the dashboard. When an invoice is created, the system generates a new cryptocurrency address. The service currently supports two address types: **temporary address and static address**. circle-info A temporary address is valid only for the duration of the invoice. Once the payment is completed – or the invoice expires – the address becomes inactive and monitoring stops. circle-info A static address is a permanent address that stays active indefinitely. It can receive multiple incoming payments. Ideal for cases where a specific address needs to be assigned to a particular customer. [**Payment window creation.**](https://goodpayments.gitbook.io/docs/user-guide/payment-window) Each invoice automatically generates a payment page containing the payment address, amount, currency, QR code, expiration time, and step-by-step payment instructions. This payment page can be shared via a link or embedded directly into your own product. [**Real-time payment processing.**](https://goodpayments.gitbook.io/docs/user-guide/payment-statuses) The system continuously monitors all payments sent to generated invoice addresses. As soon as funds arrive, goodPayments records the deposited amount, token type, and transaction hash. [**Forwarding funds to the merchant.**](https://goodpayments.gitbook.io/docs/getting-started/adding-a-payout-wallet) After confirming the incoming payment, the service automatically sends the received cryptocurrency to the merchant’s payout address specified in their account settings. [**Notifications.**](https://goodpayments.gitbook.io/docs/getting-started/account-settings/enabling-telegram-notifications) Every step of the payment flow is accompanied by notifications, ensuring you always know what’s happening. [**Payment history.**](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#payment-history) Merchants have full access to the history of all payments across all invoices, with search, filtering, and table export options available. [**AML checks on incoming transactions.**](https://goodpayments.gitbook.io/docs/user-guide/aml-checks) Merchants can enable automatic AML checks on incoming transactions. Each incoming payment is screened for risk: transactions that exceed the configured risk threshold are returned to the sender. [**Mass Payouts.**](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts) A tool for sending bulk payouts in TRX or USDT TRC-20 to multiple addresses simultaneously. The recipients list and amounts can be uploaded as an XLSX, CSV, or TXT file, or entered manually. [**Referral Program.**](https://goodpayments.gitbook.io/docs/user-guide/referral-program) Merchants earn 5% of every main-wallet top-up made by referred partners. The bonus is credited automatically and applied directly to the forwarding balance. [PreviousWhat is goodPayments?chevron-left](https://goodpayments.gitbook.io/docs/general-info/what-is-goodpayments) [NextTerms and Definitionschevron-right](https://goodpayments.gitbook.io/docs/general-info/terms-and-definitions) Last updated 5 days ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Создание массовой рассылки | goodPayments.io Запрос на создание массовой рассылки. POST [https://app.goodpayments.io/v1/api/payment/multiple\_transfer/createarrow-up-right](https://app.goodpayments.io/v1/api/payment/multiple_transfer/create) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#telo-zaprosa) Тело запроса Имя Тип Описание Пример target\_wallets\* object Объект, содержащий список адресов и сумму к отправке по адресу currency\* string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` USDT ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#primer-zaprosa) Пример запроса Копировать curl -X 'POST' \ 'https://app.goodpayments.io/v1/api/payment/multiple_transfer/create' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' \ -H 'Content-Type: application/json' \ -d '{ "target_wallets": [\ {\ "address": "TLpMouAbUvAXTspcXviipKMvijGUczUuGw",\ "amount": 10\ },\ {\ "address": "TXWGCCTgKMYWXpSSfLzutMMfKgeaCgbfbe",\ "amount": 35.5\ }\ ], "currency": "USDT" }' ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#otvet) Ответ Имя Тип Описание Пример id integer Уникальный идентификатор инвойса (массовой рассылки) 123477361 status string Статус инвойса. Возможные значения: * `ACTIVE` * `COMPLETED` * `CANCELED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Тип инвойса. `MULTIPLE_TRANSFER` - адрес рассылок `MULTIPLE_TRANSFER` paymentURL string Ссылка на платежное окно [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Сумма к отправке, указанная в инвойсе (в USD) 1 currency string Валюта к отправке. Возможные значения: * `TRX` * `USDT` USDT currencies\_amounts string Сумма к пополнению в принимаемой валюте "TRX": 3.6329 transfer\_amounts string Фактически отправленная сумма по рассылке "TRX": 3.6329 cost number Общая сумма комиссии сервиса за обработку рассылки 6.5 order\_id string Идентификатор заказа в системе мерчанта. Макс. 256 символов (пустое для массовых рассылок) null address string Сгенерированный временный адрес для пополнения TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Флаг, определяющий, кто оплачивает комиссию за пересылку. Только для инвойса с типом `SINGLE`. (для `MULTIPLE_TRANSFER` всегда false) false webhook\_url string Адрес, на который сервис goodPayments будет отправлять уведомление (webhook) после выполнения массовой рассылки (пустое для массовых рассылок) null redirect\_url string Адрес страницы, на которую будет перенаправлен плательщик после совершения оплаты на временный адрес рассылок (пустое для массовых рассылок) null description string Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу (пустое для массовых рассылок) null merchant\_contact string Контактные данные мерчанта @username target\_wallets object Объект, содержащий список адресов и сумму к отправке expired\_at string Дата и время истечения срока действия инвойса 2025-11-23T14:28:57.786076+00:00 created\_at string Дата и время создания инвойса 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#primer-otveta) Пример ответа 201 Success 403 Authentication credentials were not provided JSON parse error ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#vozmozhnye-oshibki) Возможные ошибки Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**. Если в теле запроса были переданы некорректные данные, сервер возвращает ответ с указанием строки, где была совершена ошибка. [ПредыдущаяПолучение списка транзакцийchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-tranzakcii) [СледующаяРасчет стоимости массовой рассылкиchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki) Последнее обновление 5 дней назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать { "id": 520946038, "status": "ACTIVE", "type": "MULTIPLE_TRANSFER", "paymentURL": "https://app.goodpayments.io/payment/520946038", "amount": 45.5, "currencies": [\ "USDT"\ ], "currencies_amounts": { "USDT": 45.5 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": 19.5, "order_id": null, "address": "TYrUmKqLDYzWR8RQRZEJx5Jph8tMhpi19K", "client_commission": false, "webhook_url": null, "redirect_url": null, "description": null, "merchant_contact": "@username", "target_wallets": [\ {\ "address": "TLpMouAbUvAXTspcXviipKMvijGUczUuGw",\ "amount": 10\ },\ {\ "address": "TXWGCCTgKMYWXpSSfLzutMMfKgeaCgbfbe",\ "amount": 35.5\ }\ ], "expired_at": "2026-04-17T16:10:04.917926+03:00", "created_at": "2026-04-17T13:10:04.921634+03:00" } Копировать { "detail": "Authentication credentials were not provided." } Копировать { "detail":"JSON parse error - Expecting value: line 2 column 13 (char 14)" } sun-brightdesktopmoon --- # Получение списка инвойсов | goodPayments.io Запрос для получения списка инвойсов мерчанта с возможностью настройки фильтрации, пагинации, поиска и сортировки. _**Фильтрация**_ `type` – фильтрация по типу инвойса (`SINGLE`, `MULTIPLE`, `MULTIPLE_TRANSFER`) `status` – фильтрация по статусу инвойса (`ACTIVE`, `COMPLETED`, `CANCELED`, `TIMEOUT`, `ERROR`, `AML_FAILED`, `OVERPAID`, `UNDERPAID`) `currency` – фильтрация по валюте инвойса (`"TRX"`, `"USDT"`, `"TRX,USDT"`) `date_from` – отбор инвойсов, созданных начиная с указанной даты (включительно). Формат: `YYYY-MM-DD` `date_to` – отбор инвойсов, созданных до указанной даты (включительно). Формат: `YYYY-MM-DD` _**Сортировка**_ Используйте параметр `ordering` для сортировки результатов по полям `created_at`, `amount` или `status`. Для сортировки по убыванию добавьте префикс `-`, например: `ordering` \= `-created_at` _**Пагинация**_ Управляется параметрами `limit` и `offset` Значение по умолчанию `limit`: **10** Максимально допустимое значение `limit`: **300** _**Поиск**_ Поиск доступен по параметрам: `id`, `address`, `description`, `status`, `currencies` GET [https://app.goodpayments.io/v1/api/payment/list?status=TIMEOUT&date\_from=2025-11-21&date\_to=2025-11-24¤cy=TRX&ordering=amount&limit=10arrow-up-right](https://app.goodpayments.io/v1/api/payment/list?status=TIMEOUT&date_from=2025-11-21&date_to=2025-11-24¤cy=TRX&ordering=amount&limit=10) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#telo-zaprosa) Тело запроса Данный запрос не предполагает передачу параметров в теле. Все необходимые параметры указываются в URL-эндпойнте. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#primer-zaprosa) Пример запроса ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#otvet) Ответ Имя Тип Описание Пример id integer Уникальный идентификатор инвойса 123477361 status string Статус инвойса. Возможные значения: * `ACTIVE` * `COMPLETED` * `CANCELED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Тип инвойса. `SINGLE` - временный адрес `MULTIPLE` - статичный адрес `MULTIPLE_TRANSFER` - адрес рассылок SINGLE paymentURL string Ссылка на платежное окно [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Сумма к оплате, указанная в инвойсе (в USD) 1 currencies string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Сумма к оплате по инвойсу в принимаемой валюте "TRX": 3.6329 transfer\_amounts string Фактически полученная сумма "TRX": 3.6329 cost number Комиссия сервиса за обработку платежа 6.5 order\_id string Идентификатор заказа в системе мерчанта. Макс. 256 символов 12345 address string Сгенерированный временный адрес для оплаты TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Флаг, определяющий, кто оплачивает комиссию за пересылку. Только для инвойса с типом `SINGLE`. * true – комиссия списывается с клиента. Сумма инвойса увеличивается на размер комиссии, и клиент оплачивает итоговую сумму. * false – комиссию оплачивает мерчант. true / false webhook\_url string Адрес, на который сервис goodPayments будет отправлять уведомление (webhook) после совершения плательщиком оплаты по инвойсу https://example.com/webhook redirect\_url string Адрес страницы, на которую будет перенаправлен плательщик после совершения оплаты по инвойсу https://example.com/thank-you description string Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу Payment for order #123 merchant\_contact string Контактные данные мерчанта @username target\_wallets object Объект, содержащий список адресов и сумму к отправке (для инвойсов с типом `MULTIPLE_TRANSFER`) expired\_at string Дата и время истечения срока действия инвойса 2025-11-23T14:28:57.786076+00:00 created\_at string Дата и время создания инвойса 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#primer-otveta) Пример ответа 200 Success 403 Authentication credentials were not provided ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#vozmozhnye-oshibki) Возможные ошибки Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**. [ПредыдущаяПолучение информации об инвойсеchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise) [СледующаяПолучение информации о транзакцииchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-tranzakcii) Последнее обновление 5 дней назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-spiska-invoisov#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/payment/list?status=TIMEOUT&date_from=2025-11-21&date_to=2025-11-24¤cy=TRX&ordering=amount&limit=10' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' Копировать { "count": 1, "next": null, "previous": null, "results": [\ {\ "id": 336575574,\ "status": "ACTIVE",\ "type": "SINGLE",\ "paymentURL": "https://app.goodpayments.io/payment/336575574",\ "amount": 10,\ "currencies": [\ "TRX",\ "USDT"\ ],\ "currencies_amounts": {\ "TRX": 33.402357,\ "USDT": 10\ },\ "transfer_amounts": {\ "input": {\ "TRX": 0,\ "USDT": 0\ },\ "output": {\ "TRX": 0,\ "USDT": 0\ }\ },\ "cost": null,\ "client_commission": true,\ "order_id": null,\ "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53",\ "webhook_url": null,\ "redirect_url": null,\ "description": "",\ "merchant_contact": "@username",\ "target_wallets": {},\ "expired_at": "2026-03-17T11:59:07.515594+03:00",\ "created_at": "2026-03-17T11:29:07.518981+03:00"\ }\ ] } Копировать { "detail": "Authentication credentials were not provided." } sun-brightdesktopmoon --- # Расчет стоимости массовой рассылки | goodPayments.io Запрос на расчет стоимости по массовой рассылке. POST [https://app.goodpayments.io/v1/api/payment/multiple\_transfer/costarrow-up-right](https://app.goodpayments.io/v1/api/payment/multiple_transfer/cost) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#telo-zaprosa) Тело запроса Имя Тип Описание Пример target\_wallets\* object Объект, содержащий список адресов и сумму к отправке по адресу currency\* string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` USDT ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#primer-zaprosa) Пример запроса Копировать curl -X 'POST' \ 'https://app.goodpayments.io/v1/api/payment/multiple_transfer/create' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' \ -H 'Content-Type: application/json' \ -d '{ "target_wallets": [\ {\ "address": "TLpMouAbUvAXTspcXviipKMvijGUczUuGw",\ "amount": 10\ },\ {\ "address": "TXWGCCTgKMYWXpSSfLzutMMfKgeaCgbfbe",\ "amount": 35.5\ }\ ], "currency": "USDT" }' ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#otvet) Ответ Имя Тип Описание Пример amount number Сумма к отправке, указанная в инвойсе (в USD) 1 currency string Валюта к отправке. Возможные значения: * `TRX` * `USDT` USDT target\_wallets object Объект, содержащий список адресов и сумму к отправке need\_energy integer Количество энергии, необходимое для осуществления рассылки 196000 need\_bandwidth integer Количество bandwidth, необходимое для осуществления рассылки 740 cost number Общая сумма комиссии сервиса за обработку рассылки 6.5 activation\_cost number Стоимость активации временного адреса рассылок 1.1 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#primer-otveta) Пример ответа 200 Success 403 Authentication credentials were not provided JSON parse error ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#vozmozhnye-oshibki) Возможные ошибки Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**. Если в теле запроса были переданы некорректные данные, сервер возвращает ответ с указанием строки, где была совершена ошибка. [ПредыдущаяСоздание массовой рассылкиchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki) [СледующаяОтмена инвойсаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa) Последнее обновление 5 дней назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать { "amount": 45.5, "currency": "USDT", "target_wallets": [\ {\ "address": "TLpMouAbUvAXTspcXviipKMvijGUczUuGw",\ "amount": 10\ },\ {\ "address": "TXWGCCTgKMYWXpSSfLzutMMfKgeaCgbfbe",\ "amount": 35.5\ }\ ], "need_energy": 196000, "need_bandwidth": 740, "cost": 19.5, "activation_cost": 1.1 } Копировать { "detail": "Authentication credentials were not provided." } Копировать { "detail":"JSON parse error - Expecting value: line 2 column 13 (char 14)" } sun-brightdesktopmoon --- # Отмена инвойса | goodPayments.io Запрос, предназначенный для отмены ранее созданного инвойса по параметру id. Id инвойса указывается в URL-эндпойнте. DELETE [https://app.goodpayments.io/v1/api/payment/{id}/cancelarrow-up-right](https://app.goodpayments.io/v1/api/payment/448255354/cancel) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#telo-zaprosa) Тело запроса Данный запрос не предполагает передачу параметров в теле. Все необходимые параметры указываются в URL-эндпойнте. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#primer-zaprosa) Пример запроса Копировать curl -X 'DELETE' \ 'https://app.goodpayments.io/v1/api/payment/448255354/cancel' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#otvet) Ответ Имя Тип Описание Пример id integer Уникальный идентификатор инвойса 123477361 status string Статус инвойса. Возможные значения: * `CANCELED` CANCELED type string Тип инвойса. `SINGLE` - временный адрес `MULTIPLE` - статичный адрес `MULTIPLE_TRANSFER` - адрес рассылок SINGLE paymentURL string Ссылка на платежное окно [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Сумма к оплате, указанная в инвойсе (в USD) 1 currencies string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Сумма к оплате по инвойсу в принимаемой валюте "TRX": 3.6329 transfer\_amounts string Фактически полученная сумма "TRX": 3.6329 cost number Комиссия сервиса за обработку платежа 6.5 order\_id string Идентификатор заказа в системе мерчанта. Макс. 256 символов 12345 address string Сгенерированный временный адрес для оплаты TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Флаг, определяющий, кто оплачивает комиссию за пересылку. Только для инвойса с типом `SINGLE`. * true – комиссия списывается с клиента. Сумма инвойса увеличивается на размер комиссии, и клиент оплачивает итоговую сумму. * false – комиссию оплачивает мерчант. true / false webhook\_url string Адрес, на который сервис goodPayments будет отправлять уведомление (webhook) после совершения плательщиком оплаты по инвойсу https://example.com/webhook redirect\_url string Адрес страницы, на которую будет перенаправлен плательщик после совершения оплаты по инвойсу https://example.com/thank-you description string Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу Payment for order #123 merchant\_contact string Контактные данные мерчанта @username target\_wallets object Объект, содержащий список адресов и сумму к отправке (для инвойсов с типом `MULTIPLE_TRANSFER`) expired\_at string Дата и время истечения срока действия инвойса 2025-11-23T14:28:57.786076+00:00 created\_at string Дата и время создания инвойса 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#primer-otveta) Пример ответа 200 Success 400 Invoice cannot be canceled 403 Authentication credentials were not provided 404 No Invoice matches the given query ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#vozmozhnye-oshibki) Возможные ошибки Если инвойс не может быть отменен (например, указанный инвойс уже находится в статусе `ERROR`, `TIMEOUT`, `COMPLETED` или `CANCELLED`), сервер возвращает ответ с кодом **400**. Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**. Если в запросе указан некорректный id, сервер возвращает ответ с кодом **404**. [ПредыдущаяРасчет стоимости массовой рассылкиchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/raschet-stoimosti-massovoi-rassylki) [СледующаяПолучение актуального курса конвертацииchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-aktualnogo-kursa-konvertacii) Последнее обновление 5 дней назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/otmena-invoisa#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать { "id": 336575574, "status": "CANCELLED", "type": "SINGLE", "paymentURL": "https://app.goodpayments.io/payment/336575574", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "currencies_amounts": { "TRX": 33.402357, "USDT": 10 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": null, "client_commission": true, "order_id": null, "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53", "webhook_url": null, "redirect_url": null, "description": "", "merchant_contact": "@username", "target_wallets": {}, "expired_at": "2026-03-17T11:59:07.515594+03:00", "created_at": "2026-03-17T11:29:07.518981+03:00" } Копировать { "detail": "Invoice cannot be canceled" } Копировать { "detail": "Authentication credentials were not provided." } Копировать { "detail": "No Invoice matches the given query." } sun-brightdesktopmoon --- # Overpayment and Underpayment | goodPayments.io ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/overpayment-and-underpayment#overpayments) **Overpayments** If the payer sends more than the amount specified in the invoice: * goodPayments processes the payment in full. * The entire received amount is forwarded to the merchant’s forwarding address. * The invoice is marked as **«Overpaid».** * Any refunds or compensation for the overpaid amount must be handled **directly between the merchant and the payer** – goodPayments does not participate in this process. The service does not split or return any overpaid funds. The full amount received is always sent to the merchant. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/overpayment-and-underpayment#underpayments) **Underpayments** If the payer sends less than the amount specified in the invoice: * goodPayments processes the received amount immediately upon the first incoming transaction; * The received funds are forwarded to the merchant's forwarding address in full; * The invoice is marked as **«Underpaid»**. Any compensation for the shortfall must be handled **directly between the merchant and the payer** – goodPayments does not participate in this process. circle-info This rule applies to temporary addresses only. For static addresses, no amount is specified in the invoice. [PreviousPayment Statuseschevron-left](https://goodpayments.gitbook.io/docs/user-guide/payment-statuses) [NextAddress Activationchevron-right](https://goodpayments.gitbook.io/docs/user-guide/address-activation) Last updated 5 days ago * [Overpayments](https://goodpayments.gitbook.io/docs/user-guide/overpayment-and-underpayment#overpayments) * [Underpayments](https://goodpayments.gitbook.io/docs/user-guide/overpayment-and-underpayment#underpayments) sun-brightdesktopmoon sun-brightdesktopmoon --- # Balance Top-Up | goodPayments.io To use the goodPayments, a merchant must top up their account balance. When a merchant completes registration, goodPayments generates two separate deposit addresses: **Service Fee Address (Forwarding Balance)** – used to top up the merchant’s main balance, from which the fees for invoice generation and forwarding funds are deducted. This address supports deposits in **TRX** and **USDT (TRC-20)**. **Activation Address (Activation Balance)** – used to top up the activation balance. This balance is required to activate temporary addresses generated for processing USDT (TRC-20) payments. This address **only supports TRX deposits**. A detailed description of this mechanism is available in the [Address Activation](https://goodpayments.gitbook.io/docs/user-guide/address-activation) section. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up#topping-up-the-forwarding-balance) Topping Up the Forwarding Balance The balance used to pay service fees can be topped up in the **«Balance»** section. Click **«Top Up Forwarding»**, and a modal window will open containing: * The deposit address * A QR code for quick scanning * A currency selector (TRX or USDT TRC-20) To top up the balance, send cryptocurrency from any external wallet to the provided address. Once the transaction is confirmed on the Tron blockchain, the funds will appear in your dashboard. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FCvmWQ0l2M398nf31CH8y%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252011.30.05.png%3Falt%3Dmedia%26token%3D674b1487-d4d0-46db-baa9-72968063bb93&width=768&dpr=3&quality=100&sign=fe23a4ef&sv=2) **Supported deposit currencies:** TRX Tron (TRC-20) USDT Tron (TRC-20) circle-exclamation **Important:** The merchant’s balance is internally calculated in **TRX**. Therefore, when topping up with USDT (TRC-20), the service will **automatically convert USDT to TRX** at the TRX/USDT rate at the time of deposit **plus a 6% service fee**. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up#topping-up-the-activation-balance) Topping Up the Activation Balance Topping up the activation balance works similarly to topping up the forwarding balance. In the **«Balance»** section, click **«Top Up Activation»**, and a modal window will provide the activation deposit address and QR code. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FhL2BzGpOjHV3SFcgTQd8%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252011.31.15.png%3Falt%3Dmedia%26token%3D7f3b5b36-e4eb-4fe2-a18f-22b195fb62b9&width=768&dpr=3&quality=100&sign=3eb5cf01&sv=2) Once funds are sent and confirmed on the Tron blockchain, they will appear in your activation balance. circle-exclamation **Note:** The activation balance **can only be topped up with TRX**. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up#transaction-history) Transaction History The **«Balance»** section includes a detailed history of all merchant balance top-ups and deductions. The history includes: * **Transaction hash** (with a link to a blockchain explorer) * **Operation type** (Top-up / Withdrawal / AML charge) * **Amount** * **Balance type** (Main / Activation) * **Date and time** of the operation [PreviousUser Dashboard and Control Panelchevron-left](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel) [NextInvoice Creationchevron-right](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation) Last updated 1 month ago * [Topping Up the Forwarding Balance](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up#topping-up-the-forwarding-balance) * [Topping Up the Activation Balance](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up#topping-up-the-activation-balance) * [Transaction History](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up#transaction-history) sun-brightdesktopmoon sun-brightdesktopmoon --- # Payment Window | goodPayments.io When an invoice is created, a payment window is generated – a dedicated web page shown to the payer and accessible through a unique URL. Upon the first opening, the payment window displays the following payment details: * **Invoice ID** * **Countdown timer** (defined during invoice creation) * **Amount in USDT ($)** * **Status** * **Payment currency selection** ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FFtnJm0RxvOlDRAwm5Ehl%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.49.09.png%3Falt%3Dmedia%26token%3D9a35e818-967c-4d15-9fac-29ba986d8685&width=768&dpr=3&quality=100&sign=73e12953&sv=2) Before making a payment in the payment window, the payer must select the currency in which the invoice will be paid. After selecting the payment currency, additional details appear in the payment window: * **Payment method** * **Cryptocurrency** * **Network** * **The address to which the payer must send the funds** * **Copy-address button** * **Amount in the selected cryptocurrency** * **QR code for scanning with a mobile cryptowallet** * **«Cancel payment» button** ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FNvxhFAj0rYACizhkVGLE%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.50.37.png%3Falt%3Dmedia%26token%3De6bf801f-566d-42e0-8ab7-231b9fd92b29&width=768&dpr=3&quality=100&sign=c8fe65a4&sv=2) When an invoice is created in goodPayments, the payment amount is specified in USDT. However, the payer can also choose to pay in TRX (if TRX was enabled as an accepted currency when the invoice was created). If the payer selects TRX as the payment currency, the **«Amount to pay»** field displays the exact TRX amount calculated according to the current TRX/USDT exchange rate. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252F05YSHYDfarA7n5Md94Xv%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.51.08.png%3Falt%3Dmedia%26token%3Dd6c40d10-96ad-46cb-b1f7-3a411ae210bd&width=768&dpr=3&quality=100&sign=3a87324&sv=2) After a successful payment, the payment window automatically updates and displays the current status of the operation to the payer. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FJcJIEh1DC84k0TVHHXk2%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.45.58.png%3Falt%3Dmedia%26token%3D3c439fab-b4de-4bcc-8d6d-148370dc8e6f&width=768&dpr=3&quality=100&sign=7ef3df2a&sv=2) If the invoice is not paid before it expires, the payment window will update and notify the payer that the invoice has expired. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252Fi54hGvfIAK2m71nyxGM9%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.46.38.png%3Falt%3Dmedia%26token%3D9a10b248-660e-434d-9606-a4bb84f7889d&width=768&dpr=3&quality=100&sign=a5b9711d&sv=2) If the invoice is cancelled by the merchant for any reason, the payment window will show that the invoice has been cancelled. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252Flb2txAaGsn214cek5dHA%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-03%2520%25D0%25B2%252012.47.04.png%3Falt%3Dmedia%26token%3D4fc43c27-917e-43c4-8848-4f8873cb9217&width=768&dpr=3&quality=100&sign=c396ca13&sv=2) [PreviousInvoice Creationchevron-left](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation) [NextPayment Statuseschevron-right](https://goodpayments.gitbook.io/docs/user-guide/payment-statuses) Last updated 1 month ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Referral Program | goodPayments.io The **«Referral Program»** section allows merchants to earn bonuses for bringing new partners to goodPayments. The bonus is calculated as a percentage of the main-wallet top-ups made by referred merchants. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/referral-program#how-it-works) How It Works Every merchant has access to a personal referral link in their dashboard. When a new merchant signs up through that link, they are automatically attributed to the referrer. **The bonus rate is 5%** and is applied to each top-up of the referred merchant's main (forwarding) wallet. The amount is credited immediately to the referrer's forwarding balance and is available for use in the service. circle-info The bonus applies **only to top-ups of the referred merchant's main (forwarding) wallet**. Activation-wallet top-ups, invoice payments, and other activity do not count – only funds added to the main wallet. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/referral-program#referral-program-page) Referral Program Page ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FGzRd6Ig6YMTyHmNgh5BA%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252016.30.38.png%3Falt%3Dmedia%26token%3Dcfa42660-662b-4482-b5d4-a9258ddf30bb&width=768&dpr=3&quality=100&sign=82575bf5&sv=2) The **«Referral Program»** page displays the following information: * **Your rate on referral top-ups** – your current bonus percentage; * **Total bonus credited** – the total amount of TRX earned under the program since registration; * **Merchants from your link** – the number of partners who have registered via your referral link; * **Your referral link** – your personal link for inviting new merchants, with a copy button. [PreviousMass Payoutschevron-left](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts) [NextGeneral Informationchevron-right](https://goodpayments.gitbook.io/docs/api-reference/general-information) Last updated 6 days ago * [How It Works](https://goodpayments.gitbook.io/docs/user-guide/referral-program#how-it-works) * [Referral Program Page](https://goodpayments.gitbook.io/docs/user-guide/referral-program#referral-program-page) sun-brightdesktopmoon sun-brightdesktopmoon --- # Account Registration | goodPayments.io To access your personal dashboard, you need to submit a registration request on the website: [**https://goodpayments.io/**arrow-up-right](https://goodpayments.io/) (click **«Sign Up»**). In the registration form, please fill in the following fields: Field Required First name Required E-mail Required Telegram @username Optional Company website Optional Number of transactions per month Required Business area Required ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FBVdP8fCG3F17f0ig63Z9%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-02%2520%25D0%25B2%252013.36.30.png%3Falt%3Dmedia%26token%3D3b2fa2f6-d95c-4fe5-8146-fbb126ccc78b&width=768&dpr=3&quality=100&sign=39de1e28&sv=2) After submitting the registration form, your request will be reviewed by a goodPayments administrator. If your application is approved, a message containing a login password will be sent to the email address you provided. We strongly recommend [changing this password](https://goodpayments.gitbook.io/docs/getting-started/account-settings/password-change) after your first login and enabling [two-factor authentication](https://goodpayments.gitbook.io/docs/getting-started/account-settings/2fa-authentication) for improved security. [PreviousFees and Limitschevron-left](https://goodpayments.gitbook.io/docs/general-info/fees-and-limits) [NextAccount Settingschevron-right](https://goodpayments.gitbook.io/docs/getting-started/account-settings) Last updated 4 months ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Adding a Payout Wallet | goodPayments.io To [create invoices (payment requests)](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation) , you must first add a payout address – referred to in goodPayments as the **«Forwarding Address»**. Once this address is set, all successfully paid invoices will automatically be forwarded to it. To add your payout address, go to **«Settings» → «Wallet»**. In the field **«New TRON Address»**, enter the wallet address where you want to receive payments. The address **must be activated** on the Tron network – inactive addresses cannot be added. circle-info To activate a Tron address, simply send the minimum possible amount of TRX to it (0.000001 TRX / 1 sun). The sender will be charged a 1.1 TRX network fee for this activation transaction. circle-exclamation **Important:** Only Tron Mainnet addresses are supported (Base58 format starting with **T**, 34 characters long). Make sure the address is correct – entering the wrong address may lead to irreversible loss of funds. After entering the payout address, click **«Set TRON Address»**, then confirm the action with your 2FA code (if two-factor authentication is enabled). The configured address will appear on the «Wallet» page. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FtfOc7t9bC7p1mS6wiUjD%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-02%2520%25D0%25B2%252014.02.41.png%3Falt%3Dmedia%26token%3D9fdd6c41-3ac8-481f-8c81-fd495e1e716a&width=768&dpr=3&quality=100&sign=c2d5829d&sv=2) If needed, you can change your payout address at any time. Click **«Change Address»**, then enter the new TRON address in the form that appears. You can also set your forwarding address directly from the merchant [«Dashboard»](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel) – the process works the same way as described above. [PreviousEnabling Telegram Notificationschevron-left](https://goodpayments.gitbook.io/docs/getting-started/account-settings/enabling-telegram-notifications) [NextUser Dashboard and Control Panelchevron-right](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel) Last updated 4 months ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Создание инвойса | goodPayments.io Запрос на создание нового инвойса (счета на оплату). POST [https://app.goodpayments.io/v1/api/payment/createarrow-up-right](https://app.goodpayments.io/v1/api/payment/create) ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#zagolovki) Заголовки Имя Тип Описание Пример Authorization\* string Уникальный API-ключ мерчанта 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#telo-zaprosa) Тело запроса Имя Тип Описание Пример type\* string Тип инвойса. `SINGLE` – временный адрес `MULTIPLE` – статичный адрес SINGLE amount\* number Сумма к оплате, указанная в инвойсе (в USD) 10 currencies\* string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] expiry\_minutes integer Время, в течение которого данный инвойс активен (в минутах) 30 client\_comission boolean Флаг, определяющий, кто оплачивает комиссию за пересылку. Только для инвойса с типом `SINGLE`. * true – комиссия списывается с клиента. Сумма инвойса увеличивается на размер комиссии, и клиент оплачивает итоговую сумму. * false – комиссию оплачивает мерчант. true / false order\_id string Идентификатор заказа в системе мерчанта. Максимум 256 символов 12345 webhook\_url string Адрес, на который сервис goodPayments будет отправлять уведомление (webhook) после совершения плательщиком оплаты по инвойсу https://example.com/webhook redirect\_url string Адрес страницы, на которую будет перенаправлен плательщик после совершения оплаты по инвойсу https://example.com/thank-you description string Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу Payment for order #123 circle-info Для статичных адресов (`MULTIPLE`) поля `amount`, `redirect_url` и `expiry_minutes` необязательны и игнорируются. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#primer-zaprosa) Пример запроса Копировать curl -X 'POST' \ 'https://app.goodpayments.io/v1/api/payment/create' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' \ -H 'Content-Type: application/json' \ -d '{ "type": "SINGLE", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "expiry_minutes": 30 }' ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#otvet) Ответ Имя Тип Описание Пример id integer Уникальный идентификатор инвойса 123477361 status string Статус инвойса. Возможные значения: * `ACTIVE` * `COMPLETED` * `CANCELED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Тип инвойса. `SINGLE` - временный адрес `MULTIPLE` - статичный адрес `MULTIPLE_TRANSFER` - адрес рассылок SINGLE paymentURL string Ссылка на платежное окно [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Сумма к оплате, указанная в инвойсе (в USD) 1 currencies string Список принимаемых валют. Возможные значения: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Сумма к оплате по инвойсу в принимаемой валюте "TRX": 3.6329 transfer\_amounts string Фактически полученная сумма "TRX": 3.6329 cost number Комиссия сервиса за обработку платежа 6.5 order\_id string Идентификатор заказа в системе мерчанта. Макс. 256 символов 12345 address string Сгенерированный временный адрес для оплаты TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Флаг, определяющий, кто оплачивает комиссию за пересылку. Только для инвойса с типом `SINGLE`. * true – комиссия списывается с клиента. Сумма инвойса увеличивается на размер комиссии, и клиент оплачивает итоговую сумму. * false – комиссию оплачивает мерчант. true / false webhook\_url string Адрес, на который сервис goodPayments будет отправлять уведомление (webhook) после совершения плательщиком оплаты по инвойсу https://example.com/webhook redirect\_url string Адрес страницы, на которую будет перенаправлен плательщик после совершения оплаты по инвойсу https://example.com/thank-you description string Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу Payment for order #123 merchant\_contact string Контактные данные мерчанта @username target\_wallets object Объект, содержащий список адресов и сумму к отправке (для инвойсов с типом `MULTIPLE_TRANSFER`) expired\_at string Дата и время истечения срока действия инвойса 2025-11-23T14:28:57.786076+00:00 created\_at string Дата и время создания инвойса 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#primer-otveta) Пример ответа 200 Success 400 User's target wallet address is not set 403 Authentication credentials were not provided JSON parse error ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#vozmozhnye-oshibki) Возможные ошибки Если в настройках аккаунта мерчанта не был установлен адрес для пересылок, сервер возвращает ответ с кодом **400**. Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**. Если в теле запроса были переданы некорректные данные, сервер возвращает ответ с указанием строки, где была совершена ошибка. [ПредыдущаяПолучение информации о пользователеchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-o-polzovatele) [СледующаяПолучение информации об инвойсеchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/poluchenie-informacii-ob-invoise) Последнее обновление 5 дней назад * [Заголовки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#zagolovki) * [Тело запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#telo-zaprosa) * [Пример запроса](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#primer-zaprosa) * [Ответ](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#otvet) * [Пример ответа](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#primer-otveta) * [Возможные ошибки](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-invoisa#vozmozhnye-oshibki) sun-brightdesktopmoon Копировать { "id": 336575574, "status": "ACTIVE", "type": "SINGLE", "paymentURL": "https://app.goodpayments.io/payment/336575574", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "currencies_amounts": { "TRX": 33.402357, "USDT": 10 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": null, "client_commission": true, "order_id": null, "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53", "webhook_url": null, "redirect_url": null, "description": "", "merchant_contact": "@username", "target_wallets": {}, "expired_at": "2026-03-17T11:59:07.515594+03:00", "created_at": "2026-03-17T11:29:07.518981+03:00" } Копировать { "detail": "User's target wallet address is not set" } Копировать { "detail": "Authentication credentials were not provided." } Копировать { "detail":"JSON parse error - Expecting value: line 2 column 13 (char 14)" } sun-brightdesktopmoon --- # Активация адресов | goodPayments.io Новые созданные адреса в блокчейне Tron по умолчанию не активированы. Для того, чтобы была возможность отправлять транзакции с созданного адреса, он должен быть активирован в сети. Активация адреса в блокчейне Tron производится путем отправки любого количества TRX или TRC-10 токенов с существующего адреса на новый адрес (достаточно отправить минимально допустимое количество TRX – 0.000001 TRX). При этом, в момент отправки транзакции с существующего адреса списывается комиссия за активацию в размере **1.1 TRX.** Поскольку при создании инвойса в сервисе goodPayments генерируется новый адрес в блокчейне Tron, для перевода средств с данного адреса на адрес мерчанта, установленный в настройках для приема, необходима активация нового адреса. Сервис goodPayments осуществляет прием платежей в токенах **TRX** и **USDT (TRC-20)**, поэтому: * **при отправке TRX на адрес, созданный в инвойсе** – сеть Tron автоматически активирует данный адрес (так как при отправке TRX плательщик платит комиссию за активацию); * **при отправке USDT (TRC-20) на адрес, созданный в инвойсе** – получение USDT **не** активирует адрес, в связи с этим данный адрес активируется с помощью _индивидуального адреса активаций мерчанта_ (с адреса активаций мерчанта отправляется техническая транзакция в размере **0.000001 TRX** на адрес, созданный в инвойсе, для возможности дальнейшей пересылки полученных USDT). Для каждого мерчанта при регистрации автоматически создается индивидуальный адрес для активации кошельков. Он отображается в личном кабинете и используется только для активации адресов, которые были сгенерированы в инвойсах данного мерчанта. Чтобы система могла активировать такие адреса, на адрес активаций мерчанту необходимо заранее [пополнить баланс](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/popolnenie-balansa#popolnenie-balansa-aktivacii) TRX. С этого адреса будут совершаться технические транзакции, которые активируют новые адреса инвойсов. circle-exclamation #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aktivaciya-adresov#vazhno) Важно: * Адрес активаций уникален для каждого мерчанта; * Баланс для активаций пополняется мерчантом самостоятельно; * Активация происходит только с адреса конкретного мерчанта – адреса разных мерчантов не смешиваются, и чужие кошельки не активируются. [ПредыдущаяПереплата и неполная оплата по инвойсуchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/pereplata-i-nepolnaya-oplata-po-invoisu) [СледующаяAML-проверкиchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki) Последнее обновление 1 месяц назад sun-brightdesktopmoon sun-brightdesktopmoon --- # User Dashboard and Control Panel | goodPayments.io The user dashboard and control panel are accessible after logging into the merchant account. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#control-panel) **Control Panel** The control panel gives full access to all features of the goodPayments.io and allows merchants to manage account settings, balances, invoices and API configuration. The control panel includes the following sections: * **Dashboard** – the main section of the merchant account. It displays key metrics and gives an overview of the current account status. * **Balance** – a section for managing the merchant’s balances. Here you can top up your balance to use goodPayments services, as well as view the history of top-ups and deductions. * **Invoices** – a section for creating invoices (payment requests) and viewing the full history of payments and transactions. * **AML** – the section for managing AML checks on incoming transactions. The merchant can enable or disable the AML checks feature, configure the risk threshold, and review the results of checks performed. * **API** – a section for managing your API key. It provides information about the active API key, allows you to rotate it, and includes API documentation. * **Settings** – a section where you can configure account preferences: enable 2FA, change your password, set up Telegram notifications, and configure your payout address. * **Language switcher** – allows switching the interface language. At the moment, goodPayments supports two languages: Russian and English. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#dashboard) **Dashboard** The dashboard is the main workspace and provides a high-level overview of the merchant’s account and activity. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#key-dashboard-blocks) Key dashboard blocks #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#forwarding-address) **Forwarding Address** This block contains the merchant’s address used for receiving client payments (TRX and USDT TRC-20). Funds from all paid invoices are automatically forwarded from the generated temporary addresses to the merchant’s configured forwarding address. goodPayments never holds merchant funds and has no access to this address – it is fully controlled by the merchant. Displayed in this block: * The forwarding address itself * A quick «Copy address» button * A «Change address» button for updating the payout address #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#activation-address) **Activation Address** An automatically generated address used by goodPayments to activate temporary invoice addresses when receiving USDT. A detailed explanation of how this address works is available in the [«Address Activation»](https://goodpayments.gitbook.io/docs/user-guide/address-activation) section. Displayed in this block: * The activation address itself * A quick «Copy address» button #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#transactions) **Transactions** Shows the number of incoming transactions received in the last 24 hours. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#balance-usage) **Balance Usage** Displays how much of the merchant’s balance was spent on service fees over the last 24 hours. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#total-invoices) **Total Invoices** This block displays the total number of invoices created by the merchant across all time. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#successful-invoices) **Successful Invoices** The number of successfully processed invoices (payment received and forwarded to the merchant's address). #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#failed-invoices) **Failed Invoices** The number of invoices that completed with an error or were rejected due to a failed AML check, across all time. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#aml-checks) **AML Checks** This block displays the total number of AML checks performed across all time. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#successful-aml) **Successful AML** The total number of AML checks that returned a positive result across all time. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#failed-aml) **Failed AML** The total number of AML checks that returned a negative result across all time. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#recent-invoices) **Recent Invoices** Shows the 10 most recent invoices along with their statuses. For each invoice, the following details are displayed: * ID * Address * Time * Payment Currencies * Status * Amount [PreviousAdding a Payout Walletchevron-left](https://goodpayments.gitbook.io/docs/getting-started/adding-a-payout-wallet) [NextBalance Top-Upchevron-right](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up) Last updated 1 month ago * [Control Panel](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#control-panel) * [Dashboard](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#dashboard) * [Key dashboard blocks](https://goodpayments.gitbook.io/docs/user-guide/user-dashboard-and-control-panel#key-dashboard-blocks) sun-brightdesktopmoon sun-brightdesktopmoon --- # Enabling Telegram Notifications | goodPayments.io You can receive real-time payment notifications directly in your Telegram account. To enable Telegram notifications, go to **«Settings» → «Notifications»** in your dashboard. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FFP2HDdag3LvZxwQC8TsH%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-02%2520%25D0%25B2%252013.54.42.png%3Falt%3Dmedia%26token%3D06504ce1-c9a1-44cc-b723-18c878e774f8&width=768&dpr=3&quality=100&sign=42f24938&sv=2) Turning them on is very straightforward: 1 Click **«Connect Telegram»** – a modal window will appear with setup instructions. 2 Click **«Open in Telegram»** to navigate to the bot. 3 Start the bot with the **/start** command. Once the bot is activated, your Telegram account will automatically receive alerts about: * Balance changes * Account logins * Outgoing transfers * Invoices and incoming payments If you ever want to stop receiving notifications, you can disable them at any time in the same **«Settings» → «Notifications»** section. Simply click **«Disconnect Telegram»** and confirm the action in the modal window. [PreviousPassword Changechevron-left](https://goodpayments.gitbook.io/docs/getting-started/account-settings/password-change) [NextAdding a Payout Walletchevron-right](https://goodpayments.gitbook.io/docs/getting-started/adding-a-payout-wallet) Last updated 4 months ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Password Change | goodPayments.io To change the password for your personal account, go to the **«Settings»** section. Then open the **«Password»** tab, where you can update your current password. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FbVzmzsN8leBWz2biQeGU%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-02%2520%25D0%25B2%252013.47.22.png%3Falt%3Dmedia%26token%3D11d0d5ba-d175-4f15-9f92-634f2016d459&width=768&dpr=3&quality=100&sign=9fc11a99&sv=2) Fill in the **«Current Password»** field, then enter your new password in the **«New Password»** field and repeat it in the **«Confirm New Password»** field. If all fields are entered correctly, the **«Change Password»** button becomes active. ### [hashtag](https://goodpayments.gitbook.io/docs/getting-started/account-settings/password-change#password-requirements) Password requirements Requirement Description **Minimum length** At least 8 characters **Must include** * Lowercase letter (a–z) * Uppercase letter (A–Z) * Digit (0–9) * Special character [Previous2FA Authenticationchevron-left](https://goodpayments.gitbook.io/docs/getting-started/account-settings/2fa-authentication) [NextEnabling Telegram Notificationschevron-right](https://goodpayments.gitbook.io/docs/getting-started/account-settings/enabling-telegram-notifications) Last updated 4 months ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Authentication Process | goodPayments.io All requests to the goodPayments API must be authorized using the merchant’s unique API key. Authorization is performed by including the API key in the HTTP header of every request. **Base URL:** [https://app.goodpayments.io/v1/apiarrow-up-right](https://app.goodpayments.io/v1/api) **Header format:** Copy Authorization: ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/authentication-process#request-example) Request Example Copy curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/merchant' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/authentication-process#error-handling) Error Handling If the header is missing, malformed, IP address is not in the Whitelist or the API key is invalid, the server returns a **403 Forbidden** response. **Error response example:** Copy { "detail": "Invalid API key" } [PreviousGetting an API Keychevron-left](https://goodpayments.gitbook.io/docs/api-reference/getting-an-api-key) [NextAPI Methods Overview (Request/Response Structure)chevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure) Last updated 5 days ago * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/authentication-process#request-example) * [Error Handling](https://goodpayments.gitbook.io/docs/api-reference/authentication-process#error-handling) sun-brightdesktopmoon sun-brightdesktopmoon --- # 2FA Authentication | goodPayments.io Enabling two-factor authentication (2FA) is managed directly in your merchant dashboard. Go to **«Settings»** and open the **«Security»** tab. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FyAzCFeSqFQR4ps2fomgF%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202025-12-02%2520%25D0%25B2%252013.34.12.png%3Falt%3Dmedia%26token%3D654cd11a-6887-4356-b3fc-b46f1be7f92f&width=768&dpr=3&quality=100&sign=13e7f1a3&sv=2) Click **«Enable 2FA»** to begin the setup process. A modal window will appear with step-by-step instructions. To connect your authenticator app, follow these steps: 1 Open your authenticator app (e.g., Google Authenticator). 2 Scan the QR code or manually enter the backup key. 3 Enter the one-time code generated by the app to complete the setup. After clicking **«Get QR Code»**, the system will generate both: * a QR code, * and a backup key for manual entry. Scan the QR code with your authenticator app (e.g., Google Authenticator) or add the backup key manually. Once added, enter the 6-digit one-time code into the input field and click **«Enable 2FA»**. From this moment, your account is protected with an additional layer of security. If needed, you can disable two-factor authentication later. Disabling 2FA is available in the same **«Security»** tab, provided that 2FA was previously enabled. To turn it off, you’ll need to enter a one-time code from your authenticator app. Please note that disabling two-factor authentication will reduce the security level of your account. [PreviousAccount Settingschevron-left](https://goodpayments.gitbook.io/docs/getting-started/account-settings) [NextPassword Changechevron-right](https://goodpayments.gitbook.io/docs/getting-started/account-settings/password-change) Last updated 4 months ago sun-brightdesktopmoon sun-brightdesktopmoon --- # AML Checks | goodPayments.io goodPayments supports AML checks on incoming transactions to assess risk. When AML mode is enabled, every incoming transaction is screened before funds are forwarded to the merchant's address. If the risk score returned by the check exceeds the threshold set by the merchant, the funds are automatically returned to the sender. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/aml-checks#enabling-aml-checks) Enabling AML Checks To enable AML checks, go to the **«AML»** section of your merchant dashboard and activate the **«Enable AML checks»** toggle. Once enabled, the **«Risk threshold»** setting becomes available. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FbDwhH0ylj4oL4twti4pg%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-03-23%2520%25D0%25B2%252014.24.47.png%3Falt%3Dmedia%26token%3D910c9e4c-8019-4a30-8bfd-831ec497299f&width=768&dpr=3&quality=100&sign=368c1278&sv=2) #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/aml-checks#risk-threshold) Risk Threshold The risk threshold defines the maximum acceptable risk level (0-100%) for incoming transactions. If the risk score returned by the check exceeds the configured threshold, the check is considered failed. The threshold is adjusted using a slider, changes are saved immediately when a new value is set. circle-info **Example:** with a risk threshold set to 70%, any transaction that receives a risk score above 70% during the check will be rejected. circle-info **Note:** If AML checks have never been enabled before, the risk threshold slider and the checks history block are not displayed in the section. They appear for the first time when AML is activated. Once at least one check has been performed, the checks history remains visible even when AML is disabled. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/aml-checks#how-aml-checks-work) How AML Checks Work 1. The payer sends USDT TRC-20 to the address specified in the invoice. 2. goodPayments detects the incoming transaction and performs an AML check on it. 3. goodPayments compares the risk score returned by the check against the threshold configured by the merchant in the dashboard. 4. If the check **passes** (the risk score is below the merchant's configured threshold), standard payment processing continues. 5. If the check **fails** (the risk score equals or exceeds the merchant's configured threshold), the invoice is assigned the status **«AML Check Failed»**, and the funds are returned to the sender. The AML check fee and the payment processing fee are still charged from the merchant's forwarding balance, regardless of the check outcome. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/aml-checks#aml-check-fee) AML Check Fee The cost of each AML check is deducted from the merchant's forwarding balance (main balance) in TRX. The fee amount is **$1**, converted to TRX at the current USDT/TRX exchange rate. The fee is charged regardless of the check result – both for passed and failed checks. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/aml-checks#checks-history) Checks History The **«AML»** section displays a table with the history of all checks performed. The table contains the following columns: Column Description **Invoice ID** A clickable link to the detailed invoice page. **Transaction Hash** The hash of the incoming transaction that was checked. **Address** The address that received the funds (the address generated for the invoice). **Result** The risk score and the check status. Color-coded: green – check passed; red – check failed. **PDF Report** Button to download the check report in PDF. **Check Cost** The cost of the check in TRX. **Date / Time** The date and time the check was performed. [PreviousAddress Activationchevron-left](https://goodpayments.gitbook.io/docs/user-guide/address-activation) [NextMass Payoutschevron-right](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts) Last updated 1 month ago * [Enabling AML Checks](https://goodpayments.gitbook.io/docs/user-guide/aml-checks#enabling-aml-checks) * [How AML Checks Work](https://goodpayments.gitbook.io/docs/user-guide/aml-checks#how-aml-checks-work) * [AML Check Fee](https://goodpayments.gitbook.io/docs/user-guide/aml-checks#aml-check-fee) * [Checks History](https://goodpayments.gitbook.io/docs/user-guide/aml-checks#checks-history) sun-brightdesktopmoon sun-brightdesktopmoon --- # Address Activation | goodPayments.io Newly created addresses on the Tron blockchain are not activated by default. To enable outgoing transactions, every new address must be activated first. Address activation on Tron is performed by sending any amount of TRX or TRC-10 tokens from an existing active address to the new one (the minimum amount required is 0.000001 TRX). When this transaction is sent, the sender pays a network activation fee of **1.1 TRX**. Since goodPayments generates a brand-new blockchain address for each invoice, this address must be activated before the service can forward funds from it to the merchant’s payout address. goodPayments accepts payments in **TRX** and **USDT (TRC-20)**, and the activation logic differs depending on which token the payer sends: #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/address-activation#when-the-payer-sends-trx) When the payer sends TRX The Tron network automatically activates the generated invoice address, because the payer covers the activation fee as part of the TRX transfer. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/address-activation#when-the-payer-sends-usdt-trc-20) When the payer sends USDT (TRC-20) Receiving USDT does **not** activate the address. Therefore, the system activates the invoice address using the merchant’s dedicated _activation address_. From this activation address, the system sends a technical transaction of **0.000001 TRX** to the newly created invoice address, enabling further outgoing transfers of the received USDT. Every merchant receives an individual activation address during registration. This address is shown in the dashboard and is used exclusively for activating invoice-generated addresses. To ensure that activations work correctly, the merchant must keep a sufficient TRX balance on their activation address. All technical activation transactions are made from this address. circle-exclamation #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/address-activation#important-notes) Important Notes * Each merchant has a unique activation address. * The activation balance must be topped up by the merchant. * Activations are performed strictly from the merchant’s own activation address. * Activation addresses are not shared between merchants, and the system never activates wallets belonging to other users. [PreviousOverpayment and Underpaymentchevron-left](https://goodpayments.gitbook.io/docs/user-guide/overpayment-and-underpayment) [NextAML Checkschevron-right](https://goodpayments.gitbook.io/docs/user-guide/aml-checks) Last updated 4 months ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Payment Statuses | goodPayments.io **Active** – the invoice has been created and is waiting for payment. **Completed** – the invoice was successfully processed: the payer sent the funds, and goodPayments transferred it to the merchant’s wallet. **Overpaid** – the payer sent an amount exceeding the invoice total. The received funds are forwarded to the merchant's address in full. **Underpaid** – the payer sent an amount less than the invoice total. The received funds are forwarded to the merchant's address in full. **Canceled** – the invoice was manually canceled. **Timeout** – the invoice expired before the payment was completed. **Error** – the invoice could not be processed due to a technical issue or an invalid operation (e.g., blockchain error, transfer failure, or the payer sent a different token than the one specified in the invoice). **AML: illicit funds** – the incoming transaction did not pass the AML check. Once this status is assigned, goodPayments returns the received funds to the sender's address, the invoice is closed, and no further processing takes place. [PreviousPayment Windowchevron-left](https://goodpayments.gitbook.io/docs/user-guide/payment-window) [NextOverpayment and Underpaymentchevron-right](https://goodpayments.gitbook.io/docs/user-guide/overpayment-and-underpayment) Last updated 5 days ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Массовые рассылки | goodPayments.io Раздел **«Массовые рассылки»** предназначен для одновременной отправки выплат в токенах **TRX** или **USDT TRC-20** на несколько адресов. Функционал доступен в личном кабинете мерчанта и позволяет провести массовые выплаты в три шага: ввод данных, предпросмотр и подтверждение с обработкой. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#shag-1.-vvod-dannykh) Шаг 1. Ввод данных На первом шаге мерчанту необходимо выбрать валюту рассылки и указать список получателей (адреса) с суммами выплат каждому получателю. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252F8pEDgMPw6oEgRsPwmGJu%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252015.23.11.png%3Falt%3Dmedia%26token%3D9085440d-373e-49bd-8dd4-932cbe26f06c&width=768&dpr=3&quality=100&sign=2b928cac&sv=2) #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#vybor-valyuty) **Выбор валюты** Для рассылки доступны следующие валюты: * **TRX** * **USDT TRC-20** #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#spisok-poluchatelei) **Список получателей** Получателей можно добавить двумя способами. **Вручную** – для добавления строки необходимо нажать на кнопку **«+ Добавить получателя»,** ввести адрес кошелька и сумму выплаты. Удалить все записи можно с помощью нажатия на кнопку **«Очистить»**. **Загрузка файла** – для загрузки файла со списком получателей необходимо нажать на кнопку **«Загрузить файл»**. circle-info Поддерживаемые форматы файлов: **XLSX**, **CSV**, **TXT**. Максимальный размер файла – **5 МБ**. #### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#trebovaniya-k-formatu-faila) **Требования к формату файла** В каждой строке файла должны быть только два значения: адрес кошелька и сумма. **CSV и TXT** Одна строка соответствует одной выплате. В качестве разделителя используется только запятая: Формат: `адрес,сумма` (без пробелов и лишних столбцов). **XLSX** Используются первые два столбца: * **A** – адрес кошелька * **B** – сумма Первая строка может быть заголовком: `address`. circle-info **Перед загрузкой файла необходимо убедиться, что:** * в адресах нет лишних символов или пробелов; * сумма должна быть больше 0; * для десятичной части используется точка (например, `1.25`); * пустые строки удалены. После заполнения списка получателей необходимо нажать на кнопку **«Продолжить»**. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#shag-2.-predprosmotr) Шаг 2. Предпросмотр На данном шаге отображается сводная информация по предстоящей рассылке: Параметр Описание **Количество транзакций** Общее количество получателей в рассылке **Общая сумма выплат** Суммарный объем средств к отправке **Комиссия goodPayments** Комиссия сервиса в TRX за проведение рассылки **Стоимость активации** Стоимость активации новых адресов в TRX (при необходимости) ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FePCETZFnVz5ING5Bey7b%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252015.22.37.png%3Falt%3Dmedia%26token%3Db22c777b-9134-4e43-9ce5-7fd010daf1e9&width=768&dpr=3&quality=100&sign=f8bf5ec0&sv=2) Для продолжения необходимо нажать на кнопку **«Продолжить»**. Для возврата к редактированию списка получателей – кнопку **«Назад»**. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#shag-3.-podtverzhdenie-i-obrabotka) Шаг 3. Подтверждение и обработка На третьем шаге сервис goodPayments генерирует **временный адрес рассылки**, на который мерчанту необходимо перевести требуемую сумму. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F3032312614-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDKbtgJTFMUDHly9W2DQQ%252Fuploads%252FVjoy6epq8gzI3OM3RIy0%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252015.22.54.png%3Falt%3Dmedia%26token%3D5edc8368-521b-42dd-9f72-8bc38a5c9fc8&width=768&dpr=3&quality=100&sign=11514d9&sv=2) На данном шаге отображается: * **Временный адрес рассылки** – адрес для пополнения с кнопкой копирования и QR-кодом для сканирования; * **Требуемая сумма пополнения** – точная сумма в USDT, которую необходимо отправить на временный адрес; * **Статус** – текущее состояние рассылки; * **Прогресс** – счетчик вида `Отправлено: X, Ошибок: X, Ожидает: X`. Как только средства поступят на временный адрес рассылки, сервис автоматически запустит рассылку по всем указанным адресам. В строке прогресса будет отображаться ход обработки рассылки. circle-exclamation Если на временном адресе рассылки недостаточно средств, сервис отобразит соответствующее уведомление с указанием недостающей суммы. После завершения рассылки для создания новой необходимо нажать на кнопку **«Новая рассылка»**. ### [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#istoriya-rassylok) История рассылок Все проведенные рассылки фиксируются в разделе **«Инвойсы»** – в таблице с историей всех платежей и транзакций. Отфильтровать записи в таблице можно по типу адреса **«Рассылок»** – данное значение отображается в соответствующем столбце таблицы. При нажатии на **ID инвойса** открывается страница с подробной информацией о рассылке: * текущий статус инвойса и сроки его действия; * ожидаемая и фактически полученная сумма; * для просмотра данных по каждой отдельной выплате необходимо нажать на кнопку **«Смотреть транзакции»**. [ПредыдущаяAML-проверкиchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/aml-proverki) [СледующаяРеферальная программаchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/referalnaya-programma) Последнее обновление 5 дней назад * [Шаг 1. Ввод данных](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#shag-1.-vvod-dannykh) * [Шаг 2. Предпросмотр](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#shag-2.-predprosmotr) * [Шаг 3. Подтверждение и обработка](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#shag-3.-podtverzhdenie-i-obrabotka) * [История рассылок](https://goodpayments.gitbook.io/docs/documentation/ru/rukovodstvo-polzovatelya/massovye-rassylki#istoriya-rassylok) sun-brightdesktopmoon Копировать TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,10.5 sun-brightdesktopmoon --- # General Information | goodPayments.io This section explains how to integrate with the goodPayments API and is intended for developers looking to automate the payment acceptance process. goodPayments provides a REST API and uses JSON as the data format. All requests are made via secure HTTPS. The documentation covers all interaction methods in detail – request/response structures, authentication rules, error codes, and recommended integration practices. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/general-information#core-api-capabilities) Core API Capabilities **Request Authentication:** How to obtain and use your API key, authentication rules, and required headers. **User Information:** Retrieve account details and current merchant balance. **Invoice Management:** Create new invoices, fetch details for a specific invoice, retrieve a list of all invoices, and cancel active invoices. **Conversion Rates:** Get up-to-date TRX/USDT exchange rates for payment calculations. [PreviousReferral Programchevron-left](https://goodpayments.gitbook.io/docs/user-guide/referral-program) [NextGetting an API Keychevron-right](https://goodpayments.gitbook.io/docs/api-reference/getting-an-api-key) Last updated 1 month ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Mass Payouts | goodPayments.io The **«Mass Payouts»** section is designed for sending bulk payouts in **TRX** or **USDT TRC-20** to multiple addresses simultaneously. The feature is available in the merchant dashboard and allows mass payouts to be processed in three steps: input data, preview, confirmation and processing. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#step-1.-input-data) Step 1. Input Data In the first step, the merchant must select the payout currency and provide a recipients list with wallet addresses and payout amounts. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FrtGAJk8aPsh0Yb8J1eKr%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252016.50.31.png%3Falt%3Dmedia%26token%3D620829fb-d3ee-4124-b625-aa56d15d85dd&width=768&dpr=3&quality=100&sign=342402de&sv=2) #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#currency) **Currency** The following currencies are available for mass payouts: * **TRX** * **USDT TRC-20** #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#recipients-list) **Recipients List** Recipients can be added in two ways. **Manually** – to add a row, click **«+ Add recipient»**, then enter the recipient wallet address and payout amount. To remove all entries, click **«Clear»**. **File upload** – to upload a file with the recipients list, click **«Upload file»**. circle-info Supported file formats: **XLSX**, **CSV**, **TXT**. Maximum file size – **5 MB**. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#file-format-requirements) **File Format Requirements** Each row in the file must contain only two values: wallet address and amount. **CSV and TXT** One row = one payout. Use comma as delimiter only: Format: `address,amount` (no spaces and no extra columns). **XLSX** Use the first two columns: * **A** – wallet address * **B** – amount The first row can be a header: `address`. circle-info **Check before upload:** * the address has no extra characters or spaces; * the amount must be greater than 0; * use a dot for decimal values (for example, `1.25`); * empty rows are removed. Once the recipients list is complete, click **«Continue»**. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#step-2.-preview) Step 2. Preview This step displays a summary of the upcoming mass payout: Parameter Description **Transactions** Total number of recipients in the payout **Total payout** Total amount of funds to be sent **goodPayments fee** Service fee in TRX for processing the mass payout **Activation cost** Cost of activating new addresses in TRX (if applicable) ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FFEziJes0dxm2w2Hnbn8w%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252016.51.21.png%3Falt%3Dmedia%26token%3D41fd00ea-4fd1-404e-8eff-c490c28e3350&width=768&dpr=3&quality=100&sign=bfdc6595&sv=2) To proceed, click **«Continue»**. To return to editing the recipients list, click **«Back»**. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#step-3.-confirmation-and-processing) Step 3. Confirmation and Processing In the third step, goodPayments generates a **temporary payout address** to which the merchant must transfer the required amount. ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252F3umWSCcm1g4HNQAQtKcu%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252016.51.34.png%3Falt%3Dmedia%26token%3D1c05728c-b252-4ddd-b9d1-e6aea07e2603&width=768&dpr=3&quality=100&sign=42b48132&sv=2) The following information is displayed at this step: * **Temporary payout address** – the address to top up, with a copy button and a QR code for scanning; * **Required top-up** – the exact amount in USDT to be sent to the temporary address; * **Status** – the current state of the mass payout; * **Progress** – a counter in the format `Sent: X, Failed: X, Pending: X`. Once funds are received at the temporary payout address, the service will automatically initiate payouts to all specified addresses. The progress bar will reflect the processing status in real time. circle-exclamation If there are insufficient funds on the payout address, the service will display a corresponding notification indicating the amount still required. Once the payout is complete, click **«New mass payout»** to start a new one. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#payout-history) Payout History All mass payouts are recorded in the **«Invoices»** section – the full history of all payments and transactions. To filter the table by mass payouts only, look for records with the address type **«Mailings»** displayed in the corresponding column. Clicking on an **invoice ID** opens a page with detailed information about the payout: * current invoice status and expiry details; * expected and actually received amounts; * to view data on each individual payout transaction, click **«View transactions»**. [PreviousAML Checkschevron-left](https://goodpayments.gitbook.io/docs/user-guide/aml-checks) [NextReferral Programchevron-right](https://goodpayments.gitbook.io/docs/user-guide/referral-program) Last updated 5 days ago * [Step 1. Input Data](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#step-1.-input-data) * [Step 2. Preview](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#step-2.-preview) * [Step 3. Confirmation and Processing](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#step-3.-confirmation-and-processing) * [Payout History](https://goodpayments.gitbook.io/docs/user-guide/mass-payouts#payout-history) sun-brightdesktopmoon Copy TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,10.5 sun-brightdesktopmoon --- # Invoice Creation | goodPayments.io The **«Invoices»** section of the merchant dashboard is designed for managing payment requests issued to customers. In this section, the merchant can create new invoices and track the full transaction history of all payments. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#creating-an-invoice) **Creating an Invoice** To create an invoice, click the **«New Invoice»** button. A modal window will appear with the invoice creation form. The first step is to select the address type: * **Temporary address** – a one-time address that remains active for a defined period (30 minutes by default). Suitable for one-off payments. * **Static address** – a permanent address that can receive multiple incoming payments and stays active until manually deactivated by the merchant. The set of available fields and the address logic differ depending on the selected address type. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#temporary-address) Temporary address ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FpEHpp1vkunL9hhiCHYyt%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-17%2520%25D0%25B2%252011.19.49.png%3Falt%3Dmedia%26token%3Dbd8694d1-0deb-4ae7-9580-4cc5232f5ae6&width=768&dpr=3&quality=100&sign=92d30983&sv=2) The modal contains the following fields for the merchant to fill out: Field Required Description **Amount USDT** Required The amount to be paid for this invoice (in USD/USDT). **Include fees in the invoice amount** Optional The fee forwarding flag adds the service fee to the invoice amount. If this option is active, the service fee is added to the invoice total and is paid by the buyer. **Allowed Currencies** Required Selector of allowed payment currencies. Options: • TRX • USDT (TRC-20) • TRX and USDT (TRC-20): both tokens are accepted. **Expiry (minutes)** Optional The duration for which the invoice remains active. Default is **30 minutes**. **Order ID** Optional The order identifier in the merchant's system. **Redirect URL** Optional URL to which the payer will be redirected after completing the payment. **Webhook URL** Optional URL where goodPayments will send the payment notification once the payer completes the invoice. **Comment** Optional Order description. May include any specific information related to the payment. After completing all required fields, click **«Create»**. The newly created invoice will appear in the payment history table in the **«Invoices»** section. #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#static-address) Static address ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FliEeJEjahsRwgiUfvNBy%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-03-23%2520%25D0%25B2%252014.50.58.png%3Falt%3Dmedia%26token%3D9ec6c55c-bac5-4dd1-a710-c6e6308d65c0&width=768&dpr=3&quality=100&sign=1f301485&sv=2) A static address is a permanent address for receiving payments that stays active until manually deactivated. Unlike a temporary address, it has no expiration time and can receive an unlimited number of payments. The modal contains the following fields: Field Required Description **Allowed Currencies** Required Selector of allowed payment currencies. Options: • TRX • USDT (TRC-20) • TRX and USDT (TRC-20): both tokens are accepted. **Order ID** Optional The order identifier in the merchant's system. **Webhook URL** Optional URL where goodPayments will send the payment notification once the payer completes the invoice. **Comment** Optional Order description. May include any specific information related to the payment. The **Expiry (minutes)** field is not available for static addresses – invoices of this type have no expiration time. circle-info The payment window link for a static address never expires and does not display a countdown timer. The link becomes inactive only after the merchant deactivates the address. **Deactivating a static address** – to stop accepting payments on a static address, the address must be deactivated. This is done using the **«Cancel»** button located in the **«Actions»** column of the invoices table. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#payment-history) **Payment History** The payment history is displayed as a table containing records of all invoices created by the merchant. The table includes the following columns: * **Invoice ID** – unique identifier of the invoice. Clicking the ID opens the detailed invoice page. * **Payment Link** – link to the payment window of the invoice, with a **«Copy»** button for convenience. * **Payment Transaction** – link to the hash of the incoming transaction associated with this invoice. * **Address** – the address generated for receiving funds from the payer. * **Address Type** – temporary or static. * **Time** – date and time when the invoice was created. * **Payment Currencies** – currencies allowed for payment. * **Network** – the blockchain network used for receiving funds. * **Status** – the current status of the invoice. * **Amount** – the expected payment amount. * **Actions** – button to cancel the invoice. ### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#invoice-details) **Invoice Details** After an invoice is created, the merchant can access a detailed invoice page by clicking the invoice ID in the payment history table. The detailed invoice page contains five main blocks: #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#id-1.-general-information) **1\. General Information** Includes: * Invoice ID * Current status * Date and time of creation * Expiration date and time * Date and time of the last status update * Link to the transaction hash of the temporary address activation * Link to the payment window * Address type * Order ID in the merchant's system * Allowed payment currencies #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#id-2.-amounts) **2\. Amounts** Displays the requested and actual amounts: * Expected payment amount * Amount received * Amount forwarded to the merchant * Invoice comment (if none was provided, displays “No comment”) #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#id-3.-transactions) **3\. Transactions** Contains blockchain data on both receiving and forwarding operations: * Link to the transaction hash of the incoming payment * Link to the transaction hash of the forwarded payment * Receiving addresses – the payer’s address and the temporary address generated for the invoice * Forwarding addresses – the temporary invoice address and the merchant’s payout address For static addresses, transactions are displayed in a modal window accessible by clicking the **«View Transactions»** button. The modal includes additional data: * Amount received per transaction * Payment currency #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#id-4.-redirects-and-webhooks) **4\. Redirects and Webhooks** Includes URLs: * Redirect URL where the payer is sent after completing the payment * Webhook URL where goodPayments sends the payment notification #### [hashtag](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#id-5.-aml-check) **5\. AML Check** When the AML checks feature is enabled, an additional AML block is displayed. Clicking the **«View AML Checks»** button redirects the merchant to the **«AML»** section of the dashboard. [PreviousBalance Top-Upchevron-left](https://goodpayments.gitbook.io/docs/user-guide/balance-top-up) [NextPayment Windowchevron-right](https://goodpayments.gitbook.io/docs/user-guide/payment-window) Last updated 5 days ago * [Creating an Invoice](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#creating-an-invoice) * [Payment History](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#payment-history) * [Invoice Details](https://goodpayments.gitbook.io/docs/user-guide/invoice-creation#invoice-details) sun-brightdesktopmoon sun-brightdesktopmoon --- # Ответы на часто задаваемые вопросы | goodPayments.io chevron-rightЧто такое goodPayments и как он работает?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-takoe-goodpayments-i-kak-on-rabotaet) goodPayments – это сервис, позволяющий вашему бизнесу принимать платежи в криптовалюте. Он генерирует уникальный адрес для оплаты по каждому инвойсу, отслеживает поступление средств и автоматически пересылает их напрямую на кошелек мерчанта без хранения у себя. chevron-rightНужно ли проходить KYC для использования сервиса?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#nuzhno-li-prokhodit-kyc-dlya-ispolzovaniya-servisa) Нет, регистрация и использование сервиса не требуют прохождения KYC. Пользователь заполняет форму, получает доступ в личный кабинет и добавляет собственный адрес для получения платежей. chevron-rightКакие сети и криптовалюты поддерживаются?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#kakie-seti-i-kriptovalyuty-podderzhivayutsya) На текущем этапе сервис поддерживает оплату в блокчейне Tron и токенами TRX и USDT (TRC-20). В дальнейшем планируется расширение списка сетей и токенов. chevron-rightКак создать инвойс?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#kak-sozdat-invois) Инвойс можно создать в личном кабинете или через API. Достаточно указать сумму, разрешенные валюты, срок действия инвойса, комментарий по оплате и при необходимости – URL-адреса для отправки уведомлений (webhook) и перенаправления пользователя после оплаты. После создания инвойса генерируется платежное окно и временный адрес. chevron-rightЧто такое временный адрес и зачем он нужен?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-takoe-vremennyi-adres-i-zachem-on-nuzhen) Временный адрес – одноразовый адрес, автоматически создаваемый под конкретный инвойс. Он используется только на время действия инвойса для приема оплаты от плательщика и не предназначен для хранения средств. chevron-rightЧто такое статичный адрес и чем он отличается от временного?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-takoe-statichnyi-adres-i-chem-on-otlichaetsya-ot-vremennogo) Статичный адрес – это постоянный адрес, который остается активном до момента ручной деактивации мерчантом. В отличие от временного адреса, статичный адрес может принимать неограниченное количество входящих платежей. chevron-rightЧто такое адрес для пересылок и кто его контролирует?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-takoe-adres-dlya-peresylok-i-kto-ego-kontroliruet) Адрес для пересылок – это конечный адрес мерчанта, на который goodPayments автоматически пересылает средства после оплаты. Этот адрес полностью контролируется мерчантом, сервис не имеет к нему доступа. chevron-rightКак производится активация адресов и почему это вообще нужно?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#kak-proizvoditsya-aktivaciya-adresov-i-pochemu-eto-voobshe-nuzhno) Новые адреса в блокчейне Tron неактивны. Чтобы с них можно было отправлять транзакции, требуется активация через отправку минимально возможного количества TRX (0.000001 TRX). Если по инвойсу поступает TRX – адрес активируется автоматически; если поступает USDT – активация происходит через баланс активаций мерчанта. chevron-rightКакие комиссии взимает сервис и в чем отличие?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#kakie-komissii-vzimaet-servis-i-v-chem-otlichie) Комиссия за обработку платежа – 6,5 TRX или 13 TRX, в зависимости от того, какой токен отправляется по инвойсу и есть ли USDT на конечном адресе мерчанта. **6,5 TRX** – оплата по инвойсу совершается в TRX / оплата совершается в USDT и на адресе мерчанта есть USDT; **13 TRX** – оплата по инвойсу совершается в USDT и на адресе мерчанта USDT нет. Комиссия не удерживается из суммы платежа, а списывается с баланса мерчанта. chevron-rightМожно ли включить комиссию сервиса в сумму инвойса?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#mozhno-li-vklyuchit-komissiyu-servisa-v-summu-invoisa) Да. При создании инвойса доступен флаг **«Включить комиссии в сумму инвойса»**. Если он активирован, комиссия сервиса добавляется к сумме к оплате и выставляется плательщику – он платит больше, чем исходная сумма заказа. С баланса мерчанта комиссия при этом списывается в обычном порядке: мерчант возвращает ее за счет средств, включенных в инвойс. chevron-rightЧто будет, если баланс TRX закончится? Обработка платежей остановится?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-budet-esli-balans-trx-zakonchitsya-obrabotka-platezhei-ostanovitsya) Если на балансе мерчанта недостаточно TRX для покрытия комиссии, сервис приостанавливает обработку платежей и пересылку средств до пополнения баланса. Уже созданные инвойсы могут не обработаться. chevron-rightЧто произойдет, если плательщик отправит сумму больше, чем указано в инвойсе?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-proizoidet-esli-platelshik-otpravit-summu-bolshe-chem-ukazano-v-invoise) Сервис обрабатывает весь платеж и переводит всю полученную сумму мерчанту, инвойс получает статус **«Переплачен»**. Возврат или компенсация переплаты решается напрямую между плательщиком и мерчантом, сервис в этом не участвует. chevron-rightЧто будет, если плательщик отправил меньше, чем указано в инвойсе?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-budet-esli-platelshik-otpravil-menshe-chem-ukazano-v-invoise) Сервис обрабатывает поступившую сумму сразу после получения первой транзакции и переводит все полученные средства мерчанту. Инвойс получает статус **«Недоплачен»**. Вопрос компенсации недостающей суммы решается напрямую между плательщиком и мерчантом, сервис в этом не участвует. chevron-rightЧто делать, если плательщик отправил криптовалюту, отличную от указанной в инвойсе? [hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-delat-esli-platelshik-otpravil-kriptovalyutu-otlichnuyu-ot-ukazannoi-v-invoise) Такой платеж не обрабатывается автоматически, инвойс получает статус «Ошибка», так как сервис не может корректно определить и обработать поступивший токен. Для решения ситуации необходимо обратиться в поддержку. chevron-rightМожно ли оплатить инвойс другой криптовалютой, если она поддерживается сервисом?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#mozhno-li-oplatit-invois-drugoi-kriptovalyutoi-esli-ona-podderzhivaetsya-servisom) Нет. Даже если токен поддерживается сервисом, оплата должна производиться только в той валюте, которая указана в инвойсе (TRX, USDT или обе, если разрешено). Использование любого другого токена приведет к ошибке. chevron-rightЧто такое AML проверки и зачем они нужны?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-takoe-aml-proverki-i-zachem-oni-nuzhny) AML (Anti-Money Laundering) – проверка активов (которые поступают в рамках входящих транзакций) на связь с незаконной деятельностью. При включенной функции AML каждый входящий плтаеж анализируется на предмет риска. Управление функцией доступно в личном кабинете мерчанта. chevron-rightЧто такое массовые рассылки и как ими пользоваться?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#chto-takoe-massovye-rassylki-i-kak-imi-polzovatsya) Массовые рассылки – инструмент для одновременной отправки выплат в TRX или USDT TRC-20 на множество адресов. Список получателей и суммы можно загрузить файлом в формате XLSX, CSV или TXT, либо ввести вручную. Процесс состоит из трех шагов: ввод данных → предпросмотр → подтверждение. На третьем шаге сервис генерирует временный адрес рассылки – как только на него поступят средства, рассылка запустится автоматически. История рассылок доступна в разделе **«Инвойсы»** по типу адреса **«Рассылок»**. chevron-rightКак работает реферальная программа?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#kak-rabotaet-referalnaya-programma) Каждому мерчанту доступна персональная реферальная ссылка. При регистрации нового мерчанта по этой ссылке он закрепляется за реферером. С каждого пополнения основного кошелька (баланса пересылок) привлеченного партнера начисляется бонус в размере **5%**. Сумма сразу зачисляется на баланс пересылок реферера и доступна для использования в сервисе. Пополнения кошелька активаций, оплата инвойсов и прочие операции в расчет не входят. chevron-rightКуда обращаться при возникновении технических ошибок?[hashtag](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy#kuda-obrashatsya-pri-vozniknovenii-tekhnicheskikh-oshibok) По всем вопросам, связанным с работой сервиса вы можете обратиться в поддержку через Telegram: [@goodp\_managerarrow-up-right](https://t.me/goodp_manager) . [ПредыдущаяВебхукиchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/vebkhuki) [СледующаяКонтактыchevron-right](https://goodpayments.gitbook.io/docs/documentation/ru/dopolnitelnaya-informaciya/kontakty) Последнее обновление 5 дней назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Contact Us | goodPayments.io You can reach out to us on Telegram with any questions related to using goodPayments. circle-check **Telegram Support:** [@goodp\_managerarrow-up-right](https://t.me/goodp_manager) We’ll get back to you as quickly as possible and help you with any issues or questions you might run into. [PreviousFrequently Asked Questionschevron-left](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions) Last updated 4 months ago sun-brightdesktopmoon sun-brightdesktopmoon --- # API Methods Overview (Request/Response Structure) | goodPayments.io [Get Merchant Account Informationchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information) [Create an Invoicechevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice) [Get Invoice Informationchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information) [Get List of Invoiceschevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices) [Get Transaction Informationchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information) [Get List of Transactionschevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions) [Create a Mass Payoutchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout) [Calculate a Mass Payout Costchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost) [Cancel an Invoicechevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice) [Get Current Conversion Ratechevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate) [PreviousAuthentication Processchevron-left](https://goodpayments.gitbook.io/docs/api-reference/authentication-process) [NextGet Merchant Account Informationchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information) sun-brightdesktopmoon sun-brightdesktopmoon --- # Frequently Asked Questions | goodPayments.io chevron-rightWhat is goodPayments and how does it work?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-is-goodpayments-and-how-does-it-work) goodPayments is a service that enables your business to accept cryptocurrency payments. For each invoice, the system generates a unique payment address, monitors incoming funds in real time, and automatically forwards them directly to the merchant’s wallet – without storing any funds on its side. chevron-rightDo I need to complete KYC to use the service?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#do-i-need-to-complete-kyc-to-use-the-service) No. Registration and use of the service do not require KYC. You simply fill out the registration form, access your dashboard, and add your own payout address. chevron-rightWhich chains and cryptocurrencies are supported?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#which-chains-and-cryptocurrencies-are-supported) At the current stage, goodPayments supports payments on the Tron blockchain using TRX and USDT (TRC-20). Additional networks and tokens will be added over time. chevron-rightHow do I create an invoice?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#how-do-i-create-an-invoice) An invoice can be created either from the merchant dashboard or via API. You specify the amount, allowed payment currencies, invoice expiration time, optional comments, and – if needed – URLs for webhook notifications and post-payment redirects. Once created, the system generates a payment page and a temporary (one-time) address for receiving funds. chevron-rightWhat is a temporary address and why is it needed?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-is-a-temporary-address-and-why-is-it-needed) A temporary address is a one-time blockchain address generated specifically for an invoice. It is active only for the duration of the invoice and is used solely to receive the payment. It is not intended for storing funds. chevron-rightWhat is a static address and how is it different from a temporary one?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-is-a-static-address-and-how-is-it-different-from-a-temporary-one) A static address is a permanent address that stays active until manually deactivated by the merchant. Unlike a temporary address, a static address can receive an unlimited number of incoming payments. chevron-rightWhat is a forwarding address and who controls it?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-is-a-forwarding-address-and-who-controls-it) The forwarding address is the merchant’s own address where goodPayments automatically forwards the received funds. This wallet belongs entirely to the merchant – the service has no access or control over it. chevron-rightHow are addresses activated and why is activation required?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#how-are-addresses-activated-and-why-is-activation-required) New Tron addresses are inactive by default. To send transactions from them, they must be activated by sending the minimum amount of TRX (0.000001 TRX). * If the payer sends **TRX**, the address is activated automatically. * If the payer sends **USDT**, the system activates the address using the merchant’s Activation Balance. chevron-rightWhat fees does the service charge?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-fees-does-the-service-charge) The processing fee is **6.5 TRX** or **13 TRX**, depending on the payment token and whether the merchant’s payout address contains USDT: * **6.5 TRX** – payment made in TRX OR payment made in USDT and the merchant’s payout address already holds USDT * **13 TRX** – payment made in USDT and the merchant’s payout address does not hold USDT The fee is **not deducted from the payment amount** – it is charged from the merchant’s TRX balance. chevron-rightCan the service fee be included in the invoice amount?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#can-the-service-fee-be-included-in-the-invoice-amount) Yes. When creating an invoice, the **«Include fees in the invoice amount»** flag is available. If enabled, the service fee is added to the invoice total and paid by the payer – they pay more than the original order amount. The fee is still debited from the merchant's forwarding balance as usual: the merchant recovers it through the amount included in the invoice. chevron-rightWhat happens if the TRX balance runs out?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-happens-if-the-trx-balance-runs-out) If the merchant does not have enough TRX to cover processing fees, payment handling is paused until the balance is topped up. Existing invoices may fail to process until sufficient balance is restored. chevron-rightWhat happens if the payer sends more than the invoice amount?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-happens-if-the-payer-sends-more-than-the-invoice-amount) The service processes the entire payment and forwards **the full amount** to the merchant. The invoice is marked as **Overpaid**. Refunds or compensation for overpayments must be handled directly between the payer and the merchant – the service does not split or return excess amounts. chevron-rightWhat if the payer sends less than required?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-if-the-payer-sends-less-than-required) The service processes the received amount immediately upon the first incoming transaction and forwards all received funds to the merchant in full. The invoice is marked as **Underpaid**. Any compensation for the shortfall must be handled directly between the payer and the merchant – the service does not participate in this process. chevron-rightWhat if the payer sends a different cryptocurrency than specified in the invoice?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-if-the-payer-sends-a-different-cryptocurrency-than-specified-in-the-invoice) Such payments cannot be processed. The invoice will be marked as **Error**, since the system cannot reliably identify or handle the unexpected token. Support is required to resolve the issue. chevron-rightCan a payer use another supported token to pay the invoice?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#can-a-payer-use-another-supported-token-to-pay-the-invoice) No. Even if the token is supported by the service, the payer must use **only the currencies allowed for that specific invoice** (TRX, USDT, or both). Sending any other token results in an error. chevron-rightWhat are AML checks and why are they needed?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-are-aml-checks-and-why-are-they-needed) AML (Anti-Money Laundering) is a screening of assets received in incoming transactions for links to illegal activity. When the AML feature is enabled, every incoming payment is analyzed for risk. The feature can be managed in the merchant dashboard. chevron-rightWhat are Mass Payouts and how do they work?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#what-are-mass-payouts-and-how-do-they-work) Mass Payouts is a tool for sending bulk payments in TRX or USDT TRC-20 to multiple addresses simultaneously. The recipients list and amounts can be uploaded as an XLSX, CSV, or TXT file, or entered manually. The process consists of three steps: input data → preview → confirmation. On the third step, the service generates a temporary payout address – once funds are received, payouts start automatically. The history of all mass payouts is available in the **«Invoices»** section, filtered by address type **«Mailings»**. chevron-rightHow does the Referral Program work?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#how-does-the-referral-program-work) Every merchant has access to a personal referral link. When a new merchant registers through that link, they are attributed to the referrer. A bonus of **5%** is credited for every top-up of the referred merchant's main (forwarding) wallet. The amount is applied immediately to the referrer's forwarding balance and is available for use in the service. Activation-wallet top-ups, invoice payments, and other operations do not count toward the bonus. chevron-rightWhere can I get help with technical issues?[hashtag](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions#where-can-i-get-help-with-technical-issues) For any questions related to goodPayments, contact our support on Telegram: [**@goodp\_manager**arrow-up-right](https://t.me/goodp_manager) . [PreviousWebhookschevron-left](https://goodpayments.gitbook.io/docs/api-reference/webhooks) [NextContact Uschevron-right](https://goodpayments.gitbook.io/docs/additional-info/contact-us) Last updated 5 days ago sun-brightdesktopmoon sun-brightdesktopmoon --- # Getting an API Key | goodPayments.io To work with the goodPayments API, you need to obtain a unique personal API key. This key is used to identify your merchant account, authorize requests, and protect your integration from unauthorized access. Please note that an API key is available only to users who have successfully registered in the goodPayments platform. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/getting-an-api-key#ip-whitelist) **IP Whitelist** Before accessing the API key, the merchant must add at least one IP address to the whitelist. API access will only be permitted from the specified addresses. To add an IP address, go to the **«API»** section in your Dashboard, enter the IP address in IPv4 format in the corresponding field, and click **«Add»**. circle-info The maximum number of IP addresses in the whitelist is **5**. If only one address remains in the list, it cannot be deleted. circle-exclamation The **«Show Key»** and **«Update Key»** buttons are unavailable until at least one IP address has been added to the whitelist. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/getting-an-api-key#how-to-get-your-api-key) **How to get your API key** 1 Go to the **«API»** section in your Dashboard 2 Add at least one IP address to the whitelist 3 Click **«Show key»** ![](https://goodpayments.gitbook.io/docs/~gitbook/image?url=https%3A%2F%2F1447951587-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FVCQjYw1NLDjPn5X3vSVm%252Fuploads%252FjTyWYBdSbdqyvxgxAya3%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-04-16%2520%25D0%25B2%252017.51.48.png%3Falt%3Dmedia%26token%3Dbf575b0a-6fa0-4442-a01b-087db0cba8ef&width=768&dpr=3&quality=100&sign=a1f855b&sv=2) Your API key will appear in a modal window. We strongly recommend storing it securely and never sharing it with third parties. If needed, you can rotate your API key at any time. To do this, click **«Update key»** – a new API key will be generated after you confirm the action. [PreviousGeneral Informationchevron-left](https://goodpayments.gitbook.io/docs/api-reference/general-information) [NextAuthentication Processchevron-right](https://goodpayments.gitbook.io/docs/api-reference/authentication-process) Last updated 6 days ago * [IP Whitelist](https://goodpayments.gitbook.io/docs/api-reference/getting-an-api-key#ip-whitelist) * [How to get your API key](https://goodpayments.gitbook.io/docs/api-reference/getting-an-api-key#how-to-get-your-api-key) sun-brightdesktopmoon sun-brightdesktopmoon --- # Контакты | goodPayments.io По вопросам интеграции, технической поддержки, сотрудничества и другим запросам вы можете связаться с нами через Telegram: circle-check Telegram Support: [@goodp\_managerarrow-up-right](https://t.me/goodp_manager) Мы оперативно отвечаем на сообщения, помогаем с настройкой API, решением технических вопросов и консультируем по работе сервиса. [ПредыдущаяОтветы на часто задаваемые вопросыchevron-left](https://goodpayments.gitbook.io/docs/documentation/ru/faq/otvety-na-chasto-zadavaemye-voprosy) Последнее обновление 4 месяца назад sun-brightdesktopmoon sun-brightdesktopmoon --- # Get Merchant Account Information | goodPayments.io Request to retrieve merchant account information. GET [https://app.goodpayments.io/v1/api/merchantarrow-up-right](https://app.goodpayments.io/v1/api/merchant) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#request-body) **Request Body** This request does not require a request body. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#request-example) **Request** **Example** Copy curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/merchant' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#response-parameters) Response Parameters Name Type Description Example email string Email address provided during account registration example@gmail.com balance number Merchant balance used to pay service fees (TRX) 771.011200337155 target\_wallet\_address string The wallet address where incoming invoice payments are forwarded TQ7yFpVJh1zdQRVkBmi5EbtoTunkURNwst topup\_wallet\_address string The wallet address used to top up your service-fee balance TEhxXuomfC57nX7ohdiRHVm6DF5Ram6YAr activation\_wallet\_address string The wallet address used to fund address activations TSsixXatTUkAn8LsfRQdjwk3dUDQD2PD2u activation\_balance number Activation wallet balance (TRX) 4524.233396065855 aml\_check boolean AML check enabled true aml\_risk\_limit integer Risk threshold 50.04 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#response-example) Response Example 200 Success 403 Authentication credentials were not provided ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#possible-errors) **Possible Errors** If the request does not contain a valid API key in the header or IP address is not in Whitelist, the server will return a **403** response. [PreviousAPI Methods Overview (Request/Response Structure)chevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure) [NextCreate an Invoicechevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information#possible-errors) sun-brightdesktopmoon Copy { "email": "example@gmail.com", "balance": 771.011200337155, "target_wallet_address": "TQ7yFpVJh1zdQRVkBmi5EbtoTunkURNwst", "topup_wallet_address": "TEhxXuomfC57nX7ohdiRHVm6DF5Ram6YAr", "activation_wallet_address": "TSsixXatTUkAn8LsfRQdjwk3dUDQD2PD2u", "activation_balance": 4524.233396065855, "aml_check": true, "aml_risk_limit": 50.04 } Copy { "detail": "Authentication credentials were not provided." } sun-brightdesktopmoon --- # Get Current Conversion Rate | goodPayments.io Request to retrieve the current conversion rate. You can specify one of the following values: TRX or USDT. To perform the request, the `currency` parameter must be passed directly in the URL endpoint. GET [https://app.goodpayments.io/v1/api/rates?currency=TRXarrow-up-right](https://app.goodpayments.io/v1/api/rates?currency=TRX) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#request-body) **Request Body** This request does not require any parameters in the request body. All necessary parameters are included in the URL endpoint. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#request-example) **Request** **Example** Copy curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/rates?currency=TRX' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#response-parameters) Response Parameters Name Type Description Example currency string Token. Possible values: * `TRX` * `USDT` TRX rate number Up-to-date conversion rate 0.27700958 fee number The service fee charged when topping up the merchant’s balance in USDT 0.06 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#response-example) Response Example 200 Success 403 Authentication credentials were not provided 404 Currency not found ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#possible-errors) **Possible Errors** If the request does not contain a valid API key in the header or IP address is not in Whitelist, the server will return a **403** response. If an invalid token is specified in the request, the server returns a **404** response. [PreviousCancel an Invoicechevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice) [NextWebhookschevron-right](https://goodpayments.gitbook.io/docs/api-reference/webhooks) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate#possible-errors) sun-brightdesktopmoon Copy { "currency": "TRX", "rate": 0.27700958, "fee": 0 } Copy { "detail": "Authentication credentials were not provided." } Copy { "detail": "Currency not found" } sun-brightdesktopmoon --- # Get Invoice Information | goodPayments.io Request to retrieve data for a specific invoice by its invoice ID. The invoice ID is passed in the URL endpoint. GET [https://app.goodpayments.io/v1/api/payment/get/{id}arrow-up-right](https://app.goodpayments.io/v1/api/payment/get/%7Bid%7D) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#request-body) **Request Body** This request does not require any parameters in the request body. All necessary parameters are included in the URL endpoint. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#request-example) **Request** **Example** Copy curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/payment/get/123477361' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#response-parameters) Response Parameters Name Type Description Example id integer Unique invoice ID 123477361 status string Invoice status. Possible values: * `ACTIVE` * `COMPLETED` * `CANCELED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Invoice type. `SINGLE` – temporary address; `MULTIPLE` – static address SINGLE paymentURL string Payment page URL [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Invoice amount in USD 1 currencies string List of accepted tokens. Possible values: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Amount to be paid in each accepted token "TRX": 3.6329 transfer\_amounts string Actual received amount "TRX": 3.6329 cost number Service fee charged for processing the payment 6.5 order\_id string Order identifier in the merchant's system 12345 address string Generated payment address TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Flag that determines who pays the forwarding fee. Only for `SINGLE` invoice type. * true – the fee is charged to the client. The invoice amount is increased by the fee, and the client pays the total amount. * false – the fee is paid by the merchant. true / false webhook\_url string The URL to which goodPayments will send a webhook after the customer completes the payment https://example.com/webhook redirect\_url string The URL where the customer will be redirected after completing the payment https://example.com/thank-you description string Order description: may contain any provided information related to the order Payment for order #123 merchant\_contact string Merchant contact details @username target\_wallets object An object containing a list of addresses and the amount to be sent to each address (for invoices with type `MULTIPLE_TRANSFER`). expired\_at string Invoice expiration timestamp 2025-11-23T14:28:57.786076+00:00 created\_at string Invoice creation timestamp 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#response-example) Response Example 200 Success 404 No Invoice matches the given query ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#possible-errors) **Possible Errors** If an invalid invoice ID is provided in the request, the server returns a **404** response. [PreviousCreate an Invoicechevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice) [NextGet List of Invoiceschevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information#possible-errors) sun-brightdesktopmoon Copy { "id": 336575574, "status": "ACTIVE", "type": "SINGLE", "paymentURL": "https://app.goodpayments.io/payment/336575574", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "currencies_amounts": { "TRX": 33.402357, "USDT": 10 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": null, "client_commission": true, "order_id": null, "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53", "webhook_url": null, "redirect_url": null, "description": "", "merchant_contact": "@username", "target_wallets": {}, "expired_at": "2026-03-17T11:59:07.515594+03:00", "created_at": "2026-03-17T11:29:07.518981+03:00" } Copy { "detail": "No Invoice matches the given query." } sun-brightdesktopmoon --- # Calculate a Mass Payout Cost | goodPayments.io Request to calculate the total cost of mass payout. POST [https://app.goodpayments.io/v1/api/payment/createarrow-up-right](https://app.goodpayments.io/v1/api/payment/create) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#request-body) Request Body Name Type Description Example target\_wallets\* object An object containing a list of addresses and the amount to be sent to each address currency\* string List of accepted tokens. Possible values: * `TRX` * `USDT` USDT ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#request-example) **Request** **Example** Copy curl -X 'POST' \ 'https://app.goodpayments.io/v1/api/payment/multiple_transfer/create' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' \ -H 'Content-Type: application/json' \ -d '{ "target_wallets": [\ {\ "address": "TLpMouAbUvAXTspcXviipKMvijGUczUuGw",\ "amount": 10\ },\ {\ "address": "TXWGCCTgKMYWXpSSfLzutMMfKgeaCgbfbe",\ "amount": 35.5\ }\ ], "currency": "USDT" }' }' ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#response-parameters) Response Parameters Name Type Description Example amount number Amount to be sent as specified in the invoice (in USD) 1 currency string List of accepted tokens. Possible values: * `TRX` * `USDT` USDT target\_wallets object An object containing a list of addresses and the amount to be sent to each address need\_energy integer Amount of energy required to process the mass payout 196000 need\_bandwidth integer Amount of bandwidth required to process the mass payout 740 cost number Total service fee for processing the mass payout 6.5 activation\_cost number Activation cost for the temporary payout address 1.1 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#response-example) Response Example 200 Success 403 Authentication credentials were not provided JSON parse error ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#possible-errors) **Possible Errors** If the request does not contain a valid API key in the header or IP address is not in Whitelist, the server will return a **403** response. If the request body contains invalid data, the server will return an error response indicating which field caused the error. [PreviousCreate a Mass Payoutchevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout) [NextCancel an Invoicechevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost#possible-errors) sun-brightdesktopmoon Copy { "amount": 45.5, "currency": "USDT", "target_wallets": [\ {\ "address": "TLpMouAbUvAXTspcXviipKMvijGUczUuGw",\ "amount": 10\ },\ {\ "address": "TXWGCCTgKMYWXpSSfLzutMMfKgeaCgbfbe",\ "amount": 35.5\ }\ ], "need_energy": 196000, "need_bandwidth": 740, "cost": 19.5, "activation_cost": 1.1 } Copy { "detail": "Authentication credentials were not provided." } Copy { "detail":"JSON parse error - Expecting value: line 2 column 13 (char 14)" } sun-brightdesktopmoon --- # Get List of Invoices | goodPayments.io Request for retrieving the list of merchant invoices with support for filtering, pagination, and sorting. _**Filtering**_ `type` – filter by invoice type (`SINGLE`, `MULTIPLE`, `MULTIPLE_TRANSFER`) `status` – filter by invoice status (`ACTIVE`, `COMPLETED`, `CANCELED`, `TIMEOUT`, `ERROR`, `AML_FAILED`, `OVERPAID`, `UNDERPAID`) `currency` – filter by currency (`"TRX"`, `"USDT"`, `"TRX,USDT"`) `date_from` – return invoices created on or after the specified date (inclusive). Format: `YYYY-MM-DD` `date_to` – return invoices created on or before the specified date (inclusive). Format: `YYYY-MM-DD` _**Sorting**_ Use the `ordering` parameter to sort results by `created_at`, `amount`, or `status`. To sort in descending order, add a `-` prefix, e.g.: `ordering` = `-created_at` _**Pagination**_ Controlled by the `limit` and `offset` parameters. Default `limit`: **10** Maximum allowed `limit`: **300** _**Search**_ Search is available by: `id`, `address`, `description`, `status`, `currencies` GET [https://app.goodpayments.io/v1/api/payment/list?status=TIMEOUT&date\_from=2025-11-21&date\_to=2025-11-24¤cy=TRX&ordering=amount&limit=10arrow-up-right](https://app.goodpayments.io/v1/api/payment/list?status=TIMEOUT&date_from=2025-11-21&date_to=2025-11-24¤cy=TRX&ordering=amount&limit=10) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#request-body) **Request Body** This request does not require any parameters in the request body. All necessary parameters are included in the URL endpoint. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#request-example) **Request** **Example** ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#response-parameters) Response Parameters Name Type Description Example id integer Unique invoice ID 123477361 status string Invoice status. Possible values: * `ACTIVE` * `COMPLETED` * `CANCELED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Invoice type. `SINGLE` – temporary address; `MULTIPLE` – static address SINGLE paymentURL string Payment page URL [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Invoice amount in USD 1 currencies string List of accepted tokens. Possible values: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Amount to be paid in each accepted token "TRX": 3.6329 transfer\_amounts string Actual received amount "TRX": 3.6329 cost number Service fee charged for processing the payment 6.5 order\_id string Order identifier in the merchant's system 12345 address string Generated payment address TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Flag that determines who pays the forwarding fee. Only for `SINGLE` invoice type. * true – the fee is charged to the client. The invoice amount is increased by the fee, and the client pays the total amount. * false – the fee is paid by the merchant. true / false webhook\_url string The URL to which goodPayments will send a webhook after the customer completes the payment https://example.com/webhook redirect\_url string The URL where the customer will be redirected after completing the payment https://example.com/thank-you description string Order description: may contain any provided information related to the order Payment for order #123 merchant\_contact string Merchant contact details @username target\_wallets object An object containing a list of addresses and the amount to be sent to each address (for invoices with type `MULTIPLE_TRANSFER`). expired\_at string Invoice expiration timestamp 2025-11-23T14:28:57.786076+00:00 created\_at string Invoice creation timestamp 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#response-example) Response Example 200 Success 403 Authentication credentials were not provided ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#possible-errors) **Possible Errors** If the request does not contain a valid API key in the header or IP address is not in Whitelist, the server will return a **403** response. [PreviousGet Invoice Informationchevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information) [NextGet Transaction Informationchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices#possible-errors) sun-brightdesktopmoon Copy curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/payment/list?status=TIMEOUT&date_from=2025-11-21&date_to=2025-11-24¤cy=TRX&ordering=amount&limit=10' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' Copy { "count": 1, "next": null, "previous": null, "results": [\ {\ "id": 336575574,\ "status": "ACTIVE",\ "type": "SINGLE",\ "paymentURL": "https://app.goodpayments.io/payment/336575574",\ "amount": 10,\ "currencies": [\ "TRX",\ "USDT"\ ],\ "currencies_amounts": {\ "TRX": 33.402357,\ "USDT": 10\ },\ "transfer_amounts": {\ "input": {\ "TRX": 0,\ "USDT": 0\ },\ "output": {\ "TRX": 0,\ "USDT": 0\ }\ },\ "cost": null,\ "client_commission": true,\ "order_id": null,\ "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53",\ "webhook_url": null,\ "redirect_url": null,\ "description": "",\ "merchant_contact": "@username",\ "target_wallets": {},\ "expired_at": "2026-03-17T11:59:07.515594+03:00",\ "created_at": "2026-03-17T11:29:07.518981+03:00"\ }\ ] } } Copy { "detail": "Authentication credentials were not provided." } sun-brightdesktopmoon --- # Get Transaction Information | goodPayments.io Request to retrieve detailed information about a specific transaction by its hash. If an AML check was performed on the transaction, the response includes an `aml_check` object with the full check results. GET [https://app.goodpayments.io/v1/api/transaction/{trn\_hash}arrow-up-right](https://app.goodpayments.io/v1/api/transaction/%7Btrn_hash%7D) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#request-body) **Request Body** This request does not require any parameters in the request body. All necessary parameters are included in the URL endpoint. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#request-example) **Request** **Example** Copy curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/transaction/896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#response-parameters) Response Parameters Name Type Description Example trn\_hash string Transaction hash 896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b invoice integer Invoice ID 123477361 type string Transaction type. Possible values: `PAYMENT`, `TRANSFER`, `TOPUP`, `ACTIVATION` PAYMENT from\_address string Sender address TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn to\_address string Recipient address TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze amount number Amount sent 1 currency string Token used. Possible values: `TRX`, `USDT` "TRX" aml\_check object AML check result. Present only if a check was performed on this transaction. Object structure described below event\_id string UUID linking the incoming payment and the corresponding outgoing transfer within a single payment event null created\_at string Transaction creation timestamp 2025-11-23T13:58:57.789617+00:00 #### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#aml_check-object) aml\_check Object Name Type Description Example id string AML check identifier status string Check status. Possible values: `SUCCESS`, `FAILED`, `TIMEOUT`, `ERROR` SUCCESS risk\_score number Risk score returned by the check 50 risk\_level string Risk level label: `low`, `medium`, or `high` low exposure object Object with a breakdown of risk exposure report\_url string URL to download the PDF report https://... cost number AML check fee (in TRX) 3.1 completed boolean Whether the AML check has been completed true created\_at string Check creation timestamp 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#response-example) Response Example 200 Success 403 Authentication credentials were not provided 404 Address not found ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#possible-errors) **Possible Errors** If the request does not contain a valid API key in the header or IP address is not in Whitelist, the server will return a **403** response. If the request contains an incorrect invoice ID, the server returns a **404** response. [PreviousGet List of Invoiceschevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-invoices) [NextGet List of Transactionschevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information#possible-errors) sun-brightdesktopmoon Copy { "trn_hash": "896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b", "invoice": 123477361, "type": "PAYMENT", "from_address": "TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn", "to_address": "TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze", "amount": 3.6329, "currency": "TRX", "aml_check": null, "event_id": null, "created_at": "2025-11-23T16:59:30.477619+03:00" } Copy { "detail": "Authentication credentials were not provided." } Copy { "detail": "Address not found." } sun-brightdesktopmoon --- # Get List of Transactions | goodPayments.io Request to retrieve a paginated list of the merchant's transactions with support for filtering, sorting, and search. _**Filtering**_ `type` – filter by transaction type: (`PAYMENT`, `TRANSFER`, `TOPUP`, `ACTIVATION`) `invoice_id` – filter by the ID of the associated invoice `from_address` – filter by sender address `to_address` – filter by recipient address `trn_hash` – filter by transaction hash `has_aml` – filter by AML check presence: (`true`, `false`) `currency` – filter by currency: (`"TRX"`, `"USDT"`) `date_from` – return invoices created on or after the specified date (inclusive). Format: `YYYY-MM-DD` `date_to` – return invoices created on or before the specified date (inclusive). Format: `YYYY-MM-DD` _**Sorting**_ Use the `ordering` parameter to sort results by `created_at`, `amount`, or `status`. To sort in descending order, add a `-` prefix, e.g.: `ordering` = `-created_at` _**Pagination**_ Controlled by the `limit` and `offset` parameters. Default `limit`: **10** _**Search**_ Search is available by: `trn_hash`, `invoice_id`, `type`, `currency`, `from_address`, `to_address` GET [https://app.goodpayments.io/v1/api/transaction/list?date\_from=2025\_10\_25&has\_aml=truearrow-up-right](https://app.goodpayments.io/v1/api/transaction/list?date_from=2025_10_25&has_aml=true) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#request-body) **Request Body** This request does not require any parameters in the request body. All necessary parameters are included in the URL endpoint. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#request-example) **Request** **Example** ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#response-parameters) Response Parameters Name Type Description Example trn\_hash string Transaction hash 896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b invoice integer Invoice ID 123477361 type string Transaction type. Possible values: `PAYMENT`, `TRANSFER`, `TOPUP`, `ACTIVATION` PAYMENT from\_address string Sender address TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn to\_address string Recipient address TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze amount number Amount sent 1 currency string Token used. Possible values: `TRX`, `USDT` "TRX" aml\_check object AML check result. Present only if a check was performed on this transaction. Object structure described below event\_id string UUID linking the incoming payment and the corresponding outgoing transfer within a single payment event null created\_at string Transaction creation timestamp 2025-11-23T13:58:57.789617+00:00 #### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#aml_check-object) aml\_check Object Name Type Description Example id string AML check identifier status string Check status. Possible values: `SUCCESS`, `FAILED`, `TIMEOUT`, `ERROR` SUCCESS risk\_score number Risk score returned by the check 50 risk\_level string Risk level label: `low`, `medium`, or `high` low exposure object Object with a breakdown of risk exposure report\_url string URL to download the PDF report https://... cost number AML check fee (in TRX) 3.1 completed boolean Whether the AML check has been completed true created\_at string Check creation timestamp 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#response-example) Response Example 200 Success 403 Authentication credentials were not provided 404 Address not found ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#possible-errors) **Possible Errors** If the request does not contain a valid API key in the header or IP address is not in Whitelist, the server will return a **403** response. If the request contains an incorrect invoice ID, the server returns a **404** response. [PreviousGet Transaction Informationchevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-transaction-information) [NextCreate a Mass Payoutchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions#possible-errors) sun-brightdesktopmoon Copy curl -X 'GET' \ 'https://app.goodpayments.io/v1/api/transaction/list?date_from=2025_10_25&has_aml=true' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' Copy { "trn_hash": "896ee1728b85a329250a6c23e73ead8491fe7220dc567b4e9912a70dc49c3e8b", "invoice": 123477361, "type": "PAYMENT", "from_address": "TFoGGb1FvETVbZxyrCk33k77jBE2yZZ5mn", "to_address": "TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze", "amount": 3.6329, "currency": "TRX", "aml_check": null, "event_id": null, "created_at": "2025-11-23T16:59:30.477619+03:00" } Copy { "detail": "Authentication credentials were not provided." } Copy { "detail": "Address not found." } sun-brightdesktopmoon --- # Create a Mass Payout | goodPayments.io Request to create a new mass payout (multiple transfer). POST [https://app.goodpayments.io/v1/api/payment/multiple\_transfer/createarrow-up-right](https://app.goodpayments.io/v1/api/payment/multiple_transfer/create) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#request-body) Request Body Name Type Description Example target\_wallets\* object An object containing a list of addresses and the amount to be sent to each address currency\* string List of accepted tokens. Possible values: * `TRX` * `USDT` USDT ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#request-example) **Request** **Example** Copy curl -X 'POST' \ 'https://app.goodpayments.io/v1/api/payment/multiple_transfer/create' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' \ -H 'Content-Type: application/json' \ -d '{ "target_wallets": [\ {\ "address": "TLpMouAbUvAXTspcXviipKMvijGUczUuGw",\ "amount": 10\ },\ {\ "address": "TXWGCCTgKMYWXpSSfLzutMMfKgeaCgbfbe",\ "amount": 35.5\ }\ ], "currency": "USDT" }' ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#response-parameters) Response Parameters Name Type Description Example id integer Unique invoice ID (mass payout) 123477361 status string Invoice status. Possible values: * `ACTIVE` * `COMPLETED` * `CANCELED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Invoice type. `MULTIPLE_TRANSFER` - payout address SINGLE paymentURL string Payment page URL [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Amount to be sent as specified in the invoice (in USD) 1 currency string List of accepted tokens. Possible values: * `TRX` * `USDT` USDT currencies\_amounts string Top-up amount in the accepted currency "TRX": 3.6329 transfer\_amounts string Actually sent amount for the payout "TRX": 3.6329 cost number Total service fee for processing the mass payout 6.5 order\_id string Order identifier in the merchant's system (null for mass payouts) null address string Generated temporary address for top-up TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Flag that determines who pays the forwarding fee. Only for `SINGLE` invoice type (always false for `MULTIPLE_TRANSFER`) false webhook\_url string The URL to which goodPayments will send a webhook after the customer completes the payment (null for mass payouts) null redirect\_url string The URL where the customer will be redirected after completing the payment (null for mass payouts) null description string Order description: may contain any provided information related to the order (null for mass payouts) null merchant\_contact string Merchant contact details @username target\_wallets object An object containing a list of addresses and the amount to be sent to each address expired\_at string Invoice expiration timestamp 2025-11-23T14:28:57.786076+00:00 created\_at string Invoice creation timestamp 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#response-example) Response Example 200 Success 403 Authentication credentials were not provided JSON parse error ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#possible-errors) **Possible Errors** If the request does not contain a valid API key in the header or IP address is not in Whitelist, the server will return a **403** response. If the request body contains invalid data, the server will return an error response indicating which field caused the error. [PreviousGet List of Transactionschevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-list-of-transactions) [NextCalculate a Mass Payout Costchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-a-mass-payout#possible-errors) sun-brightdesktopmoon Copy { "id": 520946038, "status": "ACTIVE", "type": "MULTIPLE_TRANSFER", "paymentURL": "https://app.goodpayments.io/payment/520946038", "amount": 45.5, "currencies": [\ "USDT"\ ], "currencies_amounts": { "USDT": 45.5 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": 19.5, "order_id": null, "address": "TYrUmKqLDYzWR8RQRZEJx5Jph8tMhpi19K", "client_commission": false, "webhook_url": null, "redirect_url": null, "description": null, "merchant_contact": "@username", "target_wallets": [\ {\ "address": "TLpMouAbUvAXTspcXviipKMvijGUczUuGw",\ "amount": 10\ },\ {\ "address": "TXWGCCTgKMYWXpSSfLzutMMfKgeaCgbfbe",\ "amount": 35.5\ }\ ], "expired_at": "2026-04-17T16:10:04.917926+03:00", "created_at": "2026-04-17T13:10:04.921634+03:00" } Copy { "detail": "Authentication credentials were not provided." } Copy { "detail":"JSON parse error - Expecting value: line 2 column 13 (char 14)" } sun-brightdesktopmoon --- # Cancel an Invoice | goodPayments.io Request intended to cancel a previously created invoice by its ID. The invoice ID is specified in the URL endpoint. DELETE [https://app.goodpayments.io/v1/api/payment/{id}/cancelarrow-up-right](https://app.goodpayments.io/v1/api/payment/448255354/cancel) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#request-body) **Request Body** This request does not require any parameters in the request body. All necessary parameters are included in the URL endpoint. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#request-example) **Request** **Example** Copy curl -X 'DELETE' \ 'https://app.goodpayments.io/v1/api/payment/448255354/cancel' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#response-parameters) Response Parameters Name Type Description Example id integer Unique invoice ID 123477361 status string Invoice status. Possible values: * `CANCELED` CANCELLED type string Invoice type. `SINGLE` – temporary address; `MULTIPLE` – static address `MULTIPLE_TRANSFER` – mass payout address SINGLE paymentURL string Payment page URL [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Invoice amount in USD 1 currencies string List of accepted tokens. Possible values: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Amount to be paid in each accepted token "TRX": 3.6329 transfer\_amounts string Actual received amount "TRX": 3.6329 cost number Service fee charged for processing the payment 6.5 order\_id string Order identifier in the merchant's system 12345 address string Generated payment address TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Flag that determines who pays the forwarding fee. Only for `SINGLE` invoice type. * true – the fee is charged to the client. The invoice amount is increased by the fee, and the client pays the total amount. * false – the fee is paid by the merchant. true / false webhook\_url string The URL to which goodPayments will send a webhook after the customer completes the payment https://example.com/webhook redirect\_url string The URL where the customer will be redirected after completing the payment https://example.com/thank-you description string Order description: may contain any provided information related to the order Payment for order #123 merchant\_contact string Merchant contact details @username target\_wallets object An object containing a list of addresses and the amount to be sent to each address (for invoices with type `MULTIPLE_TRANSFER`). expired\_at string Invoice expiration timestamp 2025-11-23T14:28:57.786076+00:00 created\_at string Invoice creation timestamp 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#response-example) Response Example 200 Success 400 Invoice cannot be canceled 403 Authentication credentials were not provided 404 No Invoice matches the given query ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#possible-errors) **Possible Errors** If the invoice cannot be canceled (for example, the specified invoice is already in the `ERROR`, `TIMEOUT`, `COMPLETED`, or `CANCELLED` status), the server returns a **400** response. If the request does not contain a valid API key in the header or IP address is not in Whitelist, the server will return a **403** response. If the request contains an incorrect invoice ID, the server returns a **404** response. [PreviousCalculate a Mass Payout Costchevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/calculate-a-mass-payout-cost) [NextGet Current Conversion Ratechevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/cancel-an-invoice#possible-errors) sun-brightdesktopmoon Copy { "id": 336575574, "status": "CANCELLED", "type": "SINGLE", "paymentURL": "https://app.goodpayments.io/payment/336575574", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "currencies_amounts": { "TRX": 33.402357, "USDT": 10 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": null, "client_commission": true, "order_id": null, "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53", "webhook_url": null, "redirect_url": null, "description": "", "merchant_contact": "@username", "target_wallets": {}, "expired_at": "2026-03-17T11:59:07.515594+03:00", "created_at": "2026-03-17T11:29:07.518981+03:00" } Copy { "detail": "Invoice cannot be canceled" } Copy { "detail": "Authentication credentials were not provided." } Copy { "detail": "No Invoice matches the given query." } sun-brightdesktopmoon --- # Create an Invoice | goodPayments.io Request to create a new invoice (payment request). POST [https://app.goodpayments.io/v1/api/payment/createarrow-up-right](https://app.goodpayments.io/v1/api/payment/create) ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#headers) Headers Name Type Description Example Authorization\* string Unique Merchant API Key 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#request-body) Request Body Name Type Description Example type\* string Invoice type. `SINGLE` – temporary address; `MULTIPLE` – static address SINGLE amount\* number Invoice amount in USD 10 currencies\* string List of accepted tokens. Possible values: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] expiry\_minutes integer Time period during which the invoice remains active (in minutes) 30 client\_comission boolean Flag that determines who pays the forwarding fee. Only for `SINGLE` invoice type. * true – the fee is charged to the client. The invoice amount is increased by the fee, and the client pays the total amount. * false – the fee is paid by the merchant. true / false order\_id string Order identifier in the merchant's system. Maximum 256 characters 12345 webhook\_url string The URL to which goodPayments will send a webhook after the customer completes the payment https://example.com/webhook redirect\_url string The URL where the customer will be redirected after completing the payment https://example.com/thank-you description string Order description: may contain any provided information related to the order Payment for order #123 circle-info For static addresses (`MULTIPLE`), the fields `amount`, `redirect_url`, and `expiry_minutes` are optional and are ignored. ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#request-example) **Request** **Example** Copy curl -X 'POST' \ 'https://app.goodpayments.io/v1/api/payment/create' \ -H 'accept: application/json' \ -H 'Authorization: 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662' \ -H 'Content-Type: application/json' \ -d '{ "type": "SINGLE", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "expiry_minutes": 30 }' ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#response-parameters) Response Parameters Name Type Description Example id integer Unique invoice ID 123477361 status string Invoice status. Possible values: * `ACTIVE` * `COMPLETED` * `CANCELED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Invoice type. `SINGLE` – temporary address; `MULTIPLE` – static address SINGLE paymentURL string Payment page URL [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Invoice amount in USD 1 currencies string List of accepted tokens. Possible values: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Amount to be paid in each accepted token "TRX": 3.6329 transfer\_amounts string Actual received amount "TRX": 3.6329 cost number Service fee charged for processing the payment 6.5 order\_id string Order identifier in the merchant's system 12345 address string Generated payment address TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Flag that determines who pays the forwarding fee. Only for `SINGLE` invoice type. * true – the fee is charged to the client. The invoice amount is increased by the fee, and the client pays the total amount. * false – the fee is paid by the merchant. true / false webhook\_url string The URL to which goodPayments will send a webhook after the customer completes the payment https://example.com/webhook redirect\_url string The URL where the customer will be redirected after completing the payment https://example.com/thank-you description string Order description: may contain any provided information related to the order Payment for order #123 merchant\_contact string Merchant contact details @username target\_wallets object An object containing a list of addresses and the amount to be sent to each address (for invoices with type `MULTIPLE_TRANSFER`). expired\_at string Invoice expiration timestamp 2025-11-23T14:28:57.786076+00:00 created\_at string Invoice creation timestamp 2025-11-23T13:58:57.789617+00:00 ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#response-example) Response Example 200 Success 400 User's target wallet address is not set 403 Authentication credentials were not provided JSON parse error ### [hashtag](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#possible-errors) **Possible Errors** If the merchant account does not have a payout address configured, the server will return a **400** response. If the request does not contain a valid API key in the header or IP address is not in Whitelist, the server will return a **403** response. If the request body contains invalid data, the server will return an error response indicating which field caused the error. [PreviousGet Merchant Account Informationchevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-merchant-account-information) [NextGet Invoice Informationchevron-right](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-invoice-information) Last updated 5 days ago * [Headers](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#headers) * [Request Body](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#request-body) * [Request Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#request-example) * [Response Parameters](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#response-parameters) * [Response Example](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#response-example) * [Possible Errors](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/create-an-invoice#possible-errors) sun-brightdesktopmoon Copy { "id": 336575574, "status": "ACTIVE", "type": "SINGLE", "paymentURL": "https://app.goodpayments.io/payment/336575574", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "currencies_amounts": { "TRX": 33.402357, "USDT": 10 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": null, "client_commission": true, "order_id": null, "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53", "webhook_url": null, "redirect_url": null, "description": "", "merchant_contact": "@username", "target_wallets": {}, "expired_at": "2026-03-17T11:59:07.515594+03:00", "created_at": "2026-03-17T11:29:07.518981+03:00" } Copy { "detail": "User's target wallet address is not set" } Copy { "detail": "Authentication credentials were not provided." } Copy { "detail":"JSON parse error - Expecting value: line 2 column 13 (char 14)" } sun-brightdesktopmoon --- # Webhooks | goodPayments.io Webhooks allow you to automatically receive notifications about invoice status changes without having to constantly poll the API. Notifications are sent to the URL you specify when creating an invoice – either in your Dashboard or via the API. To start receiving webhooks, simply include the `webhook_url` parameter when creating an invoice, for example: Copy "webhook_url": "https://example.com/webhook" Webhooks are triggered whenever the invoice status changes to one of the following: COMPLETED The invoice has been paid and the funds have been forwarded to the merchant. For temporary address invoices only. TIMEOUT The invoice has expired. For temporary address invoices only. AML\_FAILED The payment did not pass the AML check. The funds have been returned to the sender. OVERPAID Invoice has been overpaid and funds have been forwarded to the merchant. Temporary address invoices only. UNDERPAID Invoice has been underpaid and funds have been forwarded to the merchant. Temporary address invoices only. ERROR Invoice was processed with an error. Static address payment A payment on a static address invoice has been received and processed. Sent separately for each payment event. Webhook payload format: Copy { "id": 336575574, "status": "ACTIVE", "type": "SINGLE", "paymentURL": "https://app.goodpayments.io/payment/336575574", "amount": 10, "currencies": [\ "TRX",\ "USDT"\ ], "currencies_amounts": { "TRX": 33.402357, "USDT": 10 }, "transfer_amounts": { "input": { "TRX": 0, "USDT": 0 }, "output": { "TRX": 0, "USDT": 0 } }, "cost": null, "client_commission": true, "order_id": null, "address": "TRWvSiQzhSpLdRAmwDHKtgd7bZb2G2be53", "webhook_url": null, "redirect_url": null, "description": "", "merchant_contact": "@username", "target_wallets": {}, "expired_at": "2026-03-17T11:59:07.515594+03:00", "created_at": "2026-03-17T11:29:07.518981+03:00" } Name Type Description Example id integer Unique invoice ID 123477361 status string Invoice status. Possible values: * `COMPLETED` * `TIMEOUT` * `ERROR` * `AML_FAILED` * `OVERPAID` * `UNDERPAID` COMPLETED type string Invoice type. `SINGLE` – temporary address; `MULTIPLE` – static address SINGLE paymentURL string Payment page URL [https://app.goodpayments.io/payment/123477361arrow-up-right](https://app.goodpayments.io/payment/123477361) amount number Invoice amount in USD 1 currencies string List of accepted tokens. Possible values: * `TRX` * `USDT` * `TRX, USDT` \["USDT", "TRX"\] currencies\_amounts string Amount to be paid in each accepted token "TRX": 3.6329 transfer\_amounts string Actual received amount "TRX": 3.6329 cost number Service fee charged for processing the payment 6.5 order\_id string Order identifier in the merchant's system 12345 address string Generated payment address TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze client\_comission boolean Flag that determines who pays the forwarding fee. Only for `SINGLE` invoice type. * true – the fee is charged to the client. The invoice amount is increased by the fee, and the client pays the total amount. * false – the fee is paid by the merchant. true / false webhook\_url string The URL to which goodPayments will send a webhook after the customer completes the payment https://example.com/webhook redirect\_url string The URL where the customer will be redirected after completing the payment https://example.com/thank-you description string Order description: may contain any provided information related to the order Payment for order #123 merchant\_contact string Merchant contact details @username target\_wallets object An object containing a list of addresses and the amount to be sent to each address (for invoices with type `MULTIPLE_TRANSFER`). expired\_at string Invoice expiration timestamp 2025-11-23T14:28:57.786076+00:00 created\_at string Invoice creation timestamp 2025-11-23T13:58:57.789617+00:00 A webhook is sent only once. If your server does not respond within 10 seconds, the webhook will not be resent. In this case, we recommend checking the invoice status manually via the API whenever needed. [PreviousGet Current Conversion Ratechevron-left](https://goodpayments.gitbook.io/docs/api-reference/api-methods-overview-request-response-structure/get-current-conversion-rate) [NextFrequently Asked Questionschevron-right](https://goodpayments.gitbook.io/docs/faq/frequently-asked-questions) Last updated 4 days ago sun-brightdesktopmoon sun-brightdesktopmoon ---