# Создание массовой рассылки

Запрос на создание массовой рассылки.

<mark style="color:green;">POST</mark> [<mark style="color:$primary;">https://app.goodpayments.io/v1/api/payment/multiple\_transfer/create</mark>](https://app.goodpayments.io/v1/api/payment/multiple_transfer/create)

### Заголовки&#x20;

| Имя             | Тип    | Описание                     | Пример                                                           |
| --------------- | ------ | ---------------------------- | ---------------------------------------------------------------- |
| Authorization\* | string | Уникальный API-ключ мерчанта | 94a48138b1f41b9cdb3e12c2ff0c7cbe1c7a5f50a311a5054b903cad84215662 |

### Тело запроса

<table><thead><tr><th>Имя</th><th width="103.805419921875">Тип</th><th>Описание</th><th>Пример</th></tr></thead><tbody><tr><td>target_wallets*</td><td>object</td><td>Объект, содержащий список адресов и сумму к отправке по адресу</td><td></td></tr><tr><td>currency*</td><td>string</td><td><p>Список принимаемых валют. Возможные значения: </p><ul><li><code>TRX</code></li><li><code>USDT</code></li></ul></td><td>USDT</td></tr></tbody></table>

### Пример запроса

```yaml
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"
}'
```

### Ответ

<table><thead><tr><th>Имя</th><th width="121.319580078125">Тип</th><th width="148">Описание</th><th>Пример</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>Уникальный идентификатор инвойса (массовой рассылки)</td><td>123477361</td></tr><tr><td>status</td><td>string</td><td><p>Статус инвойса. Возможные значения:</p><ul><li><code>ACTIVE</code></li><li><code>COMPLETED</code></li><li><code>CANCELED</code></li><li><code>TIMEOUT</code></li><li><code>ERROR</code></li><li><code>AML_FAILED</code></li><li><code>OVERPAID</code></li><li><code>UNDERPAID</code></li></ul></td><td>COMPLETED</td></tr><tr><td>type</td><td>string</td><td>Тип инвойса. <br><code>MULTIPLE_TRANSFER</code> - адрес рассылок</td><td><code>MULTIPLE_TRANSFER</code></td></tr><tr><td>paymentURL</td><td>string</td><td>Ссылка на платежное окно</td><td><a href="https://app.goodpayments.io/payment/123477361">https://app.goodpayments.io/payment/123477361</a> </td></tr><tr><td>amount</td><td>number</td><td>Сумма к отправке, указанная в инвойсе (в USD)</td><td>1</td></tr><tr><td>currency</td><td>string</td><td><p>Валюта к отправке. Возможные значения: </p><ul><li><code>TRX</code></li><li><code>USDT</code></li></ul></td><td>USDT</td></tr><tr><td>currencies_amounts</td><td>string</td><td>Сумма к пополнению в принимаемой валюте</td><td>"TRX": 3.6329</td></tr><tr><td>transfer_amounts</td><td>string</td><td>Фактически отправленная сумма по рассылке</td><td>"TRX": 3.6329</td></tr><tr><td>cost</td><td>number</td><td>Общая сумма комиссии сервиса за обработку рассылки</td><td>6.5</td></tr><tr><td>order_id</td><td>string</td><td>Идентификатор заказа в системе мерчанта. Макс. 256 символов (пустое для массовых рассылок)</td><td>null</td></tr><tr><td>address</td><td>string</td><td>Сгенерированный временный адрес для пополнения</td><td>TBi3zPSQ8JszpkkgwZL4kZWDjXEZsi9Fze</td></tr><tr><td>client_comission</td><td>boolean</td><td>Флаг, определяющий, кто оплачивает комиссию за пересылку. Только для инвойса с типом <code>SINGLE</code>. (для <code>MULTIPLE_TRANSFER</code> всегда false)</td><td>false</td></tr><tr><td>webhook_url</td><td>string</td><td>Адрес, на который сервис goodPayments будет отправлять уведомление (webhook) после выполнения массовой рассылки (пустое для массовых рассылок)</td><td>null</td></tr><tr><td>redirect_url</td><td>string</td><td>Адрес страницы, на которую будет перенаправлен плательщик после совершения оплаты на временный адрес рассылок (пустое для массовых рассылок)</td><td>null</td></tr><tr><td>description</td><td>string</td><td>Описание заказа, может содержать в себе какую-либо информацию мерчанта по оплачиваемому заказу (пустое для массовых рассылок)</td><td>null</td></tr><tr><td>merchant_contact</td><td>string</td><td>Контактные данные мерчанта</td><td>@username</td></tr><tr><td>target_wallets</td><td>object</td><td>Объект, содержащий список адресов и сумму к отправке </td><td></td></tr><tr><td>expired_at</td><td>string</td><td>Дата и время истечения срока действия инвойса</td><td>2025-11-23T14:28:57.786076+00:00</td></tr><tr><td>created_at</td><td>string</td><td>Дата и время создания инвойса</td><td>2025-11-23T13:58:57.789617+00:00</td></tr></tbody></table>

### Пример ответа

{% tabs %}
{% tab title="201 Success" %}

```json
{
  "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"
}
```

{% endtab %}

{% tab title="403 Authentication credentials were not provided" %}

```json
{
  "detail": "Authentication credentials were not provided."
}
```

{% endtab %}

{% tab title="JSON parse error" %}

```json
{
  "detail":"JSON parse error - Expecting value: line 2 column 13 (char 14)"
}
```

{% endtab %}
{% endtabs %}

### Возможные ошибки

Если заголовок с корректным API-ключом отсутствует, ключ недействителен или IP-адрес не в белом списке, сервер возвращает ответ с кодом **403**.

Если в теле запроса были переданы некорректные данные, сервер возвращает ответ с указанием строки, где была совершена ошибка.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://goodpayments.gitbook.io/docs/documentation/ru/api-dokumentaciya/opisanie-metodov-vzaimodeistviya-struktura-zaprosa-otveta/sozdanie-massovoi-rassylki.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.