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

#### Пример запроса (GET):

```json
GET https://unitpay.ru/api

method              = initPayment
params[paymentType] = card
params[projectId]   = 123456
params[secretKey]   = 1234567890abc1234567890abcd12345
params[sum]         = 10
params[account]     = example
params[desc]        = description
```

**Обязательные параметры:**

<table data-header-hidden><thead><tr><th width="197.77777099609375">name</th><th width="125.55562337239581">type</th><th>description</th></tr></thead><tbody><tr><td><strong>paymentType</strong></td><td>строка</td><td><a href="https://help.unitpay.ru/book-of-reference/payment-system-codes">Код платежной системы</a>, через которую будет идти оплата</td></tr><tr><td><strong>projectId</strong></td><td>число</td><td>ID вашего проекта в системе UnitPay</td></tr><tr><td><strong>secretKey</strong></td><td>строка</td><td>Секретный ключ</td></tr><tr><td><strong>sum</strong></td><td>число</td><td>Сумма платежа в рублях (например, 100)</td></tr><tr><td><strong>account</strong> </td><td>строка</td><td>Идентификатор абонента в системе партнера (например, логин или email абонента)</td></tr><tr><td><strong>desc</strong></td><td>строка</td><td>Описание заказа</td></tr></tbody></table>

Значение project Id и SECRET KEY проекта можно найти на странице **Настройки** проекта

<figure><img src="https://552539910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9Y_k8Gr-WxeECFRelw-1508421016%2Fuploads%2FQ4PKKTQDnF2F0WneQoyB%2Fimage.png?alt=media&#x26;token=df48d3a2-1da8-4cb0-a38c-954638faca61" alt=""><figcaption></figcaption></figure>

**Дополнительные параметры оплаты:**

<table data-header-hidden><thead><tr><th width="174.55731201171875">name</th><th width="149.66145833333331">type</th><th>description</th></tr></thead><tbody><tr><td><strong>currency</strong></td><td>строка</td><td><p>Валюта заказа по стандарту ISO 4217 (RUB, UAH, BYN, EUR, USD итд. <a href="https://help.unitpay.ru/book-of-reference/currency-codes">Полный список валют</a>). </p><p></p><p>Если платежная система не поддерживает требуемую валюту, то сумма будет сконвертирована в валюту системы оплаты</p></td></tr><tr><td><strong>locale</strong></td><td>строка</td><td>Принудительное указание языка платежной формы, допустимые значения: ru, en. По умолчанию язык формы определяется исходя из страны, к которой относится IP адрес пользователя</td></tr><tr><td><strong>backUrl</strong></td><td>строка</td><td>Адрес возврата пользователя с платежной формы без совершения покупки, по умолчанию используется адрес проекта. В адресе обязательно должен использоваться домен проекта. <br><br>Примеры: <br><code>https://redirect.&#x3C;домен проекта>/?someParams", "https://&#x3C;домен проекта>/redirect/</code></td></tr><tr><td><strong>resultUrl</strong></td><td>строка</td><td>Полный URL адрес перехода пользователя после оплаты (например, <a href="http://unitpay.ru/">http://вашсайт.ru</a>), принудительно отправляет плательщика по этому адресу после оплаты.<br><br><strong>Важно:</strong> домен не должен отличаться от домена проекта. Если параметр не задан, то будет использован адрес страницы чека платежа.</td></tr><tr><td><strong>hideOtherMethods</strong></td><td>строка</td><td><code>true</code> или <kbd>false</kbd><br>Скрывает окно выбора других способов оплаты<br></td></tr></tbody></table>

{% hint style="warning" %}
Запрос можно выполнить в тестовом режиме. [Узнать подробнее](https://help.unitpay.ru/other/test-api#vvedenie)
{% endhint %}

{% hint style="info" %}
По мере выполнения платежа мы уведомляем платформу магазина о статусе оплаты, последовательно [отправляя GET запросы на URL обработчика](https://help.unitpay.ru/payments/payment-handler).
{% endhint %}

#### Пример успешного ответа:

{% tabs %}
{% tab title="Redirect" %}

```json
{
    "result": {
        "type": "redirect",
        "paymentId": 1231231234,
        "message": "Счет успешно выставлен, ожидается оплата",
        "receiptUrl": "https://unitpay.ru/pay/receipt/1231231234-12d1fae123",
        "statusUrl": "https://unitpay.ru/pay/receipt/1231231234-12d1fae123",
        "redirectUrl": "https://unitpay.ru/pay/123456-1fc2f/card?account=test_unitpay&sum=10.00&currency=RUB&signature=d85e744643bbae4dadf49e845a14f5728eaf13b7c533e7cd5277c0531d91cb2c&desc=test_unitpay&hideOtherMethods=true&locale=ru&paymentId=1231231234&hideMenu=true"
    }
}
```

{% endtab %}
{% endtabs %}

<table data-header-hidden><thead><tr><th width="178.88887532552081">name</th><th width="150.111083984375">type</th><th>description</th></tr></thead><tbody><tr><td><strong>message</strong></td><td>string</td><td>Информация о результате формирования платежа</td></tr><tr><td><strong>paymentId</strong></td><td>integer</td><td>Номер платежа в системе UnitPay</td></tr><tr><td><strong>type</strong> </td><td>string</td><td><p><strong>Тип ответа:</strong></p><p><strong>redirect</strong> — необходимо перенаправить пользователя на адрес, указанные в <em>redirectUrl</em></p><p><strong>response</strong> - необходимо показать пользователю информацию, указанную в <em>response</em> <br><strong>invoice</strong> — счет создан автоматически и направлен плательщику. Дополнительных действий не требуется</p></td></tr><tr><td><strong>redirectUrl</strong></td><td>string</td><td>URL для переадресации пользователя на шлюз платежной платформы</td></tr><tr><td><strong>response</strong></td><td>string</td><td><p>html код формы</p><p></p><p>html - необходимо отобразить на странице </p></td></tr></tbody></table>

#### Ошибочный ответ

```json
{
    "error": {
        "message": "Не переданы обязательные параметры: account",
        "code": -32602
    }
}
```

<table data-header-hidden><thead><tr><th width="182.55560302734375">name</th><th width="141.33333333333331">type</th><th>description</th></tr></thead><tbody><tr><td><strong>message</strong></td><td>string</td><td>Информация с описанием ошибки формирования платежа</td></tr><tr><td><strong>code</strong></td><td>number</td><td>Код ошибки</td></tr></tbody></table>

**Описание возможных ошибок:**

<table data-header-hidden><thead><tr><th width="196.22216796875">name</th><th>description</th></tr></thead><tbody><tr><td><strong>-32000</strong></td><td>Неверные параметры авторизации (например, login)</td></tr><tr><td><strong>-32602</strong></td><td>Ошибочные параметры запроса (запрос написан с ошибкой)</td></tr><tr><td><strong>-32603</strong></td><td>Внутренняя техническая ошибка</td></tr></tbody></table>