# Создание платежного поручения

<mark style="color:green;">`POST`</mark> `https://prapi.tarlanpayments.kz/payorder/api/v1/order`

#### Headers

| Name                                            | Type   | Description                                                                                                                    |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer  Авторотационный хэш (см [Формирование подписи](https://docs.tarlanpayments.kz/platezhnyi-shlyuz/formirovanie-podpisi)) |

#### Request Body

| Name                                                               | Type    | Description                                                                                                                               |
| ------------------------------------------------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| payment\_order\_id<mark style="color:red;">\*</mark>               | String  | Идентификатор поручение на стороне мерчанта                                                                                               |
| payment\_order\_date<mark style="color:red;">\*</mark>             | Date    | <p>Дата  платежного поручение </p><p>в формате 2025-06-30</p>                                                                             |
| merchant\_id<mark style="color:red;">\*</mark>                     | String  | Идентификатор мерчанта                                                                                                                    |
| project\_id<mark style="color:red;">\*</mark>                      | Integer | Идентификатор проекта                                                                                                                     |
| transfers <mark style="color:red;">\*</mark>                       | Array   | Cписок трансферов                                                                                                                         |
| transfers.name                                                     | String  | Наименование субмерчанта                                                                                                                  |
| transfers.bin<mark style="color:red;">\*</mark>                    | String  | BIN субмерчанта                                                                                                                           |
| transfers.transfer\_id<mark style="color:red;">\*</mark>           | String  | Идентификатор трансфера на стороне мерчанта                                                                                               |
| transfers.description                                              | String  | Описание трансфера                                                                                                                        |
| transfers.amount<mark style="color:red;">\*</mark>                 | Float   | Сумма трансфера                                                                                                                           |
| transfers.beneficiary\_code<mark style="color:red;">\*</mark>      | String  | КБЕ                                                                                                                                       |
| transfers.payment\_purpose\_code<mark style="color:red;">\*</mark> | String  | Код назначения платежа                                                                                                                    |
| transfers.recipient\_account<mark style="color:red;">\*</mark>     | String  | Счет получателя                                                                                                                           |
| transfers.is\_legal<mark style="color:red;">\*</mark>              | Boolean | <p>Флаг, указывающий, является ли субъект юридическим лицом</p><p><br>Значения:<br>true — юридическое лицо<br>false — физическое лицо</p> |

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "status": true,
    "message": "Success",
    "result": "success"
}
```

{% endtab %}

{% tab title="500: Internal Server Error " %}

```json
{
    "status": false,
    "status_code": 5406,
    "message": "invalid project secret",
    "result": {}
}
```

{% endtab %}
{% endtabs %}

{% code fullWidth="true" %}

```bash
curl --location 'https://prapi.tarlanpayments.kz/payorder/api/v1/order' \
--header 'Authorization: Bearer 123' \
--header 'Content-Type: application/json' \
--data '{
  "project_id": 99,
  "transfers": [
    {
      "name": "string",
      "bin": "11011000999",
      "transfer_id": "transfer_id",
      "description": "string",
      "amount": 150,
      "beneficiary_code": "13",
      "payment_purpose_code": "123",
      "recipient_account": "KZ111011111000011111",
      "is_legal": true
    }
  ],
  "merchant_id": 1,
  "payment_order_date": "2025-06-30",
  "payment_order_id": "payment_order_id"
}'
```

{% endcode %}