# Создание платежа

URL запроса: <mark style="background-color:blue;">**<https://getpay.io/api/pay>**</mark>

Метод: GET / POST

**Параметры:**

<table><thead><tr><th width="250.33333333333331">Param</th><th>Описание</th></tr></thead><tbody><tr><td>secret</td><td><a href="/pages/DK5VAERXKid3rwzuApJv">Секретный ключ</a></td></tr><tr><td>wallet</td><td>ID Проекта</td></tr><tr><td>sum</td><td>Сумма оплаты (мин. 50 - макс. 5000)</td></tr><tr><td>orderId</td><td><p>Номер заказа внутри вашей системы</p><p><strong>Важно!</strong> Должно быть уникальное значение для каждого проекта, в противном случае вернет статус платежа по этому номеру</p></td></tr><tr><td>clientId</td><td><p>ID пользователя внутри вашей системы </p><p><strong>Важно!</strong> Передавайте уникальное значение ID пользователя, для которого создается платеж</p></td></tr><tr><td>backUrl</td><td>Ссылка куда будет перенаправлен плательщик после оплаты (<a href="#success_payment">успешная оплата</a>)</td></tr><tr><td>comment</td><td>Комментарий платежа (отображается у плательщика)</td></tr><tr><td>method</td><td><p>Тип оплаты: wallet (по-умолчанию)</p><p><a href="#stranica-oplaty">Все доступные методы оплаты</a>.</p></td></tr><tr><td>userIp</td><td>IP адрес плательщика - необязательный параметр</td></tr><tr><td>other</td><td>Дополнительная переменная - необязательный параметр</td></tr></tbody></table>

**Успешный ответ в JSON формате:**

```
{
    "status": "success",
    "success": "Payment success created.",
    "paymentId": "7883",
    "redirectUrl": "https://s-payments.ru/redirect/pay/jd12ik",
    "type": "redirect",
    "orderId": "123"
}
```

|             |                                             |
| ----------- | ------------------------------------------- |
| status      | Статус запроса и его описание               |
| paymentId   | Идентификатор платежа внутри GetPay         |
| redirectUrl | Ссылка на оплату (передайте её плательщику) |
| type        | Тип оплаты: redirect                        |
| orderId     | Номер заказа внутри вашей системы           |

**Ответ с ошибкой:**

```
{
    "status": "error",
    "error": "The wallet is not active!"
}
```

**Пример PHP:**

```
<?php
    $url = "https://getpay.io/api/pay";
    $dataFields = array(
        "secret" => "ВАШ СЕКРЕТНЫЙ КЛЮЧ",
        "wallet" => "3",
        "sum" => "100.99",
        "order" => "123",
        "resultUrl" => "https://yoursite.com/pay/result.php",
        "backUrl" => "https://yoursite.com",
        "comment" => "Пополнение баланса аккаунта #123 на сайте yoursite.com"
    );

    // Request GET
    $result = json_decode(file_get_contents($url . "?" . http_build_query($dataFields)));

    // Error validate
    if($result->status == 'error') {
        die($result->error);
    }

    // Redirect
    header('Location: ' . $result->redirectUrl);
?>
```

### Страница оплаты

![Плательщик видит это окно после редиректа](/files/huaeROge8ddOwJBE8wGc)

Если вы хотите выбрать метод оплаты вместо пользователя со своей стороны, минуя страницу с выбором оплаты, используйте GET-параметр **type** при редиректе, например: *<mark style="background-color:blue;"><https://s-payments.ru/redirect/pay/jd12ik></mark><mark style="background-color:blue;">**?type=mts**</mark>*

**Доступные методы type:**

| Значение    | Описание                           |
| ----------- | ---------------------------------- |
| card        | Процессинг Visa / MasterCard / МИР |
| sbp         | СБП (оплата по QR коду)            |
| sber        | Сбербанк Мобильный Банк            |
| tinkoff     | Тинькофф Мобильный Банк            |
| ym          | ЮMoney                             |
| wm          | WebMoney (WMZ)                     |
| beeline     | Билайн RU                          |
| mts         | МТС RU                             |
| tele2       | Теле2 RU                           |
| megafon     | Мегафон RU                         |
| yota        | Yota RU                            |
| mtsby       | MTS BY                             |
| lifeby      | Life:) BY                          |
| kcellkz     | Kcell KZ                           |
| tele2kz     | TELE2 KZ                           |
| altelkz     | Altel KZ                           |
| trx         | TRX                                |
| usdt\_trc20 | USDT TRC20                         |
| ton         | TON COIN                           |

### Успешная оплата <a href="#success_payment" id="success_payment"></a>

После удачной оплаты пользователя перенаправит по ссылке, которую вы указали при создании платежа в параметре backUrl с дополнительными GET-параметрами:

|       |                                        |
| ----- | -------------------------------------- |
| order | Номер заказа внутри вашей системы      |
| error | Равно 1, если платеж окончился ошибкой |
|       |                                        |


---

# 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://help.getpay.io/payments/sozdanie-platezha.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.