> For the complete documentation index, see [llms.txt](https://piqpay.gitbook.io/merchant-integration/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://piqpay.gitbook.io/merchant-integration/ru/h2h-host-to-host-integraciya/rub/sozdanie-vyvoda.md).

# Создание вывода

PIQPAY предоставляет два способа совершения вывода по двум методам: PMC\_S2P\_SBP и PMC\_S2P\_CARD.

{% hint style="info" %}
В ДЕВ среде  вы можете протестировать создание вывода по методам PMC\_S2P\_SBP и PMC\_S2P\_CARD. Также вы можете протестировать получение коллбэков для выводов по статусам CREATED, CANCELLED, COMPLETED.
{% endhint %}

Для создания вывода по этим методам вам нужно отправить POST запрос, в теле которого указываются следующие параметры.

**Описание полей запроса**

**apiKey** - API ключ, который вы создали для своего бренда (Secret Key указывается в заголовке запроса), тип: string;

**amount** - сумму ордера, тип: integer и валюта ордера (пример суммы: 1000 RUB = 100000 minorAmount), тип: string;

**paymentMethod** - метод оплаты ордера (список доступных методов вы найдете в разделе "Методы: ордер и вывод"), тип: string;

**clientId** - уникальный идентификатор пользователя в вашей системе, тип: string;

**externalId** - уникальный идентификатор ордера в вашей системе, тип: string;

**callbackUrl** (не обязательное поле) - URL адрес, на который будут приходить коллбэки (оповещения) при создании ордера и изменении его статуса, тип: string;&#x20;

**requisites** - данные получателя (вашего клиента), которые он указал в форме вывода на вашем сайте:

CARD\_NUMBER - номер карты для отправки средств по методу CARD, тип: string,

PHONE - номер телефона для отправки средств по методу SBP, тип: string,

BANK\_NAME - название банка получателя для отправки средств по методу SBP (подробнее в разделе “Справочник банков”), тип: string,

LEGAL\_NAME (не обязательное поле) - имя получателя перевода, тип: string.

**Пример запроса на создания вывода по методу PMC\_S2P\_SBP**

```json
POST https://eha.piqpay.codes/v1/payouts
Authorization: Bearer ${secretKey}

{
    "apiKey": "<API_KEY>",
       "amount": {
           "currency": "RUB",
           "minorAmount": 50000
       },
       "paymentMethod": "PMC_S2P_SBP",
       "clientId": "123456789",
       "externalId": "123456789",
       "callbackUrl": "https://example.com/callback",
       "requisites": [
        {"instruction": "PHONE", "value": "+79206185913"},
        {"instruction":"BANK_NAME","value":"TINKOFFBANK"}]
}
```

**Пример запроса на создания вывода по методу PMC\_S2P\_CARD**

```json
POST https://eha.piqpay.codes/v1/payouts
Authorization: Bearer ${secretKey}

{"apiKey": "<API_KEY>",
   "amount": {
       "currency": "RUB",
       "minorAmount": 50000
   },
   "paymentMethod": "PMC_S2P_CARD",
   "clientId": "123456789",
   "externalId": "123456789",
   "callbackUrl": "https://example.com/callback",
   "requisites": [
    {"instruction": "CARD_NUMBER", "value": "2200700168814616"},
    {"instruction":"LEGAL_NAME","value":"IVAN IVANOV"},
    {"instruction":"BANK_NAME","value":"TINKOFFBANK"}]}
```

После отправки API запроса на создание вывода, вы получите ответ от нашего сервера (пример ниже). Как только ваша заявка на вывод будет оплачена, вы получите коллбэк со статусом COMPLETED (смотрите раздел «Коллбэк»).

Если после отправки API запроса вы получите ошибку, то обратитесь к разделу "[Ошибки](/merchant-integration/ru/dopolnitelnaya-informaciya/oshibki.md)".

<details>

<summary>Пример ответа на запрос создания вывода</summary>

```json
{"id": "8fd11032-11dc-4342-8af0-35b33bf30136",
    "createdAt": "2026-02-06T07:32:55.509Z",
    "merchant": {
        "id": "8481fd2a-16f3-45cf-8eb0-7de1285d518a",
        "name": "NewNik",
        "picture": null
    },
    "store": {
        "id": "d8440d52-25a5-4e8e-907d-3d73dd3763a8",
        "name": "Best",
        "country": "RU",
        "picture": null
    },
    "externalId": "г743b7decd151",
    "clientId": "432eг1d33b109",
    "amount": {
        "minorAmount": 50000,
        "currency": "RUB"
    },
    "exchangedAmount": null,
    "requisites": [
        {
            "instruction": "CARD_NUMBER",
            "value": "2200700168814616"
        },
        {
            "instruction": "LEGAL_NAME",
            "value": "VALERI IVANOV"
        },
        {
            "instruction": "BANK_NAME",
            "value": "TINKOFFBANK"
        }
    ],
    "paymentMethod": {
        "code": "PMC_S2P_CARD",
        "instructions": [
            "CARD_NUMBER",
            "LEGAL_NAME"
        ]
    },
    "readyForPaymentAt": null,
    "processingSince": "2026-02-06T07:32:55.533Z",
    "reason": null,
    "state": "PROCESSING",
    "settledAt": null,
    "assignedAt": null,
    "expiredAt": null,
    "redirectUrl": "https://script.google.com/macros/s/AKfycbyRd-iFvbGmOfe_UGAPKvkXsdIjBpG4tZFgp-f5lNz4XuFvKTz8EFQQ44aVIuZnuQZI/exec",
    "failureUrl": null,
    "cancelUrl": null}
```

</details>

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://piqpay.gitbook.io/merchant-integration/ru/h2h-host-to-host-integraciya/rub/sozdanie-vyvoda.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.
