> 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/ars/sozdanie-ordera-depozit.md).

# Создание ордера (депозит)

Для создания ордера по валюте ARS доступны следующие методы:&#x20;

| Название                     | Метод             | Режим работы  |
| ---------------------------- | ----------------- | ------------- |
| Банковский перевод (CVU/CBU) | PMC\_S2P\_ACCOUNT | H2H, redirect |

{% hint style="info" %}
В ДЕВ (тестовой) среде вы можете опробовать создание ордеров по методу PMC\_S2P\_ACCOUNT.&#x20;

Также вы можете протестировать получение коллбэков для ордеров по статусам CREATED, COMPLETED, CANCELLED, EXPIRED.
{% endhint %}

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

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

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

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

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

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

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

**clientName** (не обязательное поле) - официальное имя вашего клиента;

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

**redirectUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент после успешной оплаты ордера при нажатии кнопки на странице checkout;

**failureUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент в случае сбоя при оплаты ордера при нажатии кнопки на странице checkout;

**cancelUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент в случае отмены ордера при нажатии кнопки на странице checkout.

{% hint style="info" %}
На странице checkout кнопка «Back to store» ведет:

по ссылке из redirectUrl, если ордер успешный;&#x20;

по ссылке  из поля cancelUrl, если ордер отменен самим пользователем или из бэкофиса;&#x20;

по ссылке из поля failureUrl, если возникла ошибка при создании ордера.

На странице checkout кнопка «Exit» всегда ведет по ссылке из redirectUrl.&#x20;

Если поле redirectUrl не указано в запросе, то и кнопок «Back to store» и «Exit» не будет на странице checkout при любом статусе ордера.

Если в теле ордера не указать поле redirectUrl, то и поля cancelUrl и failureUrl не нужно указывать.
{% endhint %}

После успешного создания ордера вы получите ответ на отправленный API запрос со ссылкой на страницу оплаты (ссылка находится в поле checkoutUrl). Вам нужно перенаправить своего клиента на эту страницу для оплаты ордера.

{% hint style="info" %}
Мы передаем реквизиты для оплаты в теле ответа на запрос создания ордера. Вы можете передать их клиенту для совершения платежа, чтобы не перенаправлять его на нашу страницу оплаты.
{% endhint %}

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

{% hint style="info" %}
Для метода ACCOUNT доступна частичная оплата ордера.
{% endhint %}

**Пример запроса на создание ордера по методу PMC\_S2P\_ACCOUNT**

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

{
    "apiKey": "<API_KEY>",
    "amount": {
       "currency": "ARS",
       "minorAmount": 50000
   },
   "paymentMethod": "PMC_S2P_ACCOUNT",
   "clientId": "123456789",
   "externalId": "123456789",
   "redirectUrl": "https://example.com/redirect",
   "callbackUrl": "https://example.com/callback",
   "failureUrl": "https://example.com/failure",
   "cancelUrl": "https://example.com/cancel"
}
```

<details>

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

```json
{
    "order": {
        "id": "69447d93-192e-4b3c-8b76-201441aad961",
        "createdAt": "2026-05-07T11:29:11.701Z",
        "merchant": {
            "id": "8481fd2a-16f3-45cf-8eb0-7de1285d518a",
            "name": "NewNik",
            "picture": null
        },
        "store": {
            "id": "e44a507b-39e0-4630-8e6b-d1763e5a93d1",
            "name": "ARS",
            "country": "AR",
            "picture": null
        },
        "externalId": "123f456789",
        "clientId": "12345f6789",
        "amount": {
            "minorAmount": 50000,
            "currency": "ARS"
        },
        "paymentFlow": "INTERNAL",
        "paymentMethod": {
            "code": "PMC_S2P_ACCOUNT",
            "instructions": [
                "ACCOUNT_NUMBER",
                "LEGAL_NAME"
            ]
        },
        "institution": "OTHER_AR",
        "readyForPaymentAt": null,
        "processingSince": null,
        "reason": null,
        "state": "READY_FOR_PAYMENT",
        "expiringAt": "2026-05-07T11:39:11.701Z",
        "redirectUrl": "https://example.com/redirect",
        "failureUrl": "https://example.com/failure",
        "cancelUrl": "https://example.com/cancel",
        "paymentUrl": null,
        "paymentQr": null,
        "paymentDeepLinks": null,
        "paymentCountry": null,
        "checkoutUrl": "https://checkout.piqpay.codes/69447d93-192e-4b3c-8b76-201441aad961",
        "adjustment": null,
        "clientFlow": "REGULAR",
        "adjustedAt": null,
        "endClient": {
            "name": null,
            "account": null,
            "email": null,
            "phone": null,
            "institution": null,
            "billingAddress": null
        },
        "receiptConfig": null,
        "cashbackAmount": null,
        "cashbackPercentage": null
    },
    "services": null,
    "requisites": [
        {
            "instruction": "LEGAL_NAME",
            "value": "ARGENTINSKY LEV"
        },
        {
            "instruction": "ACCOUNT_NUMBER",
            "value": "0001234500000001234567"
        }
    ]
}
```

</details>


---

# 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/ars/sozdanie-ordera-depozit.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.
