---
description: Page description
---

# Payment

To initiate a payment, please send a <mark style="color:green;">POST</mark> request to the following endpoint: `https://{url}.finipay.kg/api/v1.1.0/mega/pay`.



<mark style="color:green;">`POST`</mark> `https://{url}.finipay.kg/api/v1.1.0/mega/pay`

#### Request Body

| Name                                          | Type       | Description                                                                                                                                                     |
| --------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| orderNumber<mark style="color:red;">\*</mark> | String     | Unique payment ID                                                                                                                                               |
| user<mark style="color:red;">\*</mark>        | String     | <p>User's phone number Megapay</p><p>Test number - 996555002108</p>                                                                                             |
| account<mark style="color:red;">\*</mark>     | String     | <p>Requisite.</p><p>To facilitate the development , the following requisites were created: 1 – the answer is always SUCCESS, 3 – the answer is always ERROR</p> |
| amount<mark style="color:red;">\*</mark>      | BigDecimal | Sum                                                                                                                                                             |
| pinCode<mark style="color:red;">\*</mark>     | String     | <p>Pin code – transmitted via SMS</p><p>Test pin - 1548</p>                                                                                                     |
| callbackUrl                                   | String     | URL for callbacks is not required                                                                                                                               |

```
⚠️ Recommendations for Order Number generation

To avoid failures in data transmission, storage and encryption, it is strongly recommended to exclude special characters from the order number.

Unacceptable characters for the order number:

! @ # $ % ^ & * ( ) _ + { } [ ] | \ : ; “ ' < > , . ? / ~ \n \t 😀 漢字 💥

Note: Only:

 - Latin letters (A-Z, a-z),
 - numerals (0-9),
 - hyphen - and underscore _ (if necessary and if supported by the system).

Examples of valid order numbers:
 - ORDER-123456
 - user_789_order

Examples of invalid numbers:
 - ORDER#123! ❌
 - order😀漢字💥 ❌
```

{% tabs %}
{% tab title="120:  CONFIRMED" %}
```json
{
    "code": "120",
    "message": "CONFIRMED",
    "data": {
        "transaction_id": "001125",
        "amount": 5.00
    }
}

```
{% endtab %}

{% tab title="1: ERROR" %}
```json
{
    "code": "1",
    "message": "Внутренняя ошибка",
    "data": null
}
```
{% endtab %}

{% tab title="140 INCORRECT_NUMBER_FORMAT" %}
```json
{
    "code": "140",
    "message": "Неправильный формат телефона",
    "data": null
}
```
{% endtab %}

{% tab title="152: PINCODE_INCORRECT" %}
```json
{
    "code": "152",
    "message": "PINCODE_INCORRECT",
    "data": null
}
```
{% endtab %}

{% tab title="404: USER_NOT_FOUND" %}
```json
{
    "code": "404",
    "message": "Пользователь не найден",
    "data": null
}
```
{% endtab %}

{% tab title="135: SERVICE_ERROR" %}
```json
{
    "code": "135",
    "message": "Ошибка сервиса",
    "data": null
}
```
{% endtab %}
{% endtabs %}
