💰Payment

Page description

To initiate a payment, please send a POST request to the following endpoint: https://{url}.finipay.kg/api/v1.1.0/mega/pay.

POST https://{url}.finipay.kg/api/v1.1.0/mega/pay

Request Body

Name	Type	Description
orderNumber*	String	Unique payment ID
user*	String	User's phone number Megapay Test number - 996555002108
account*	String	Requisite. To facilitate the development , the following requisites were created: 1 – the answer is always SUCCESS, 3 – the answer is always ERROR
amount*	BigDecimal	Sum
pinCode*	String	Pin code – transmitted via SMS Test pin - 1548
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😀漢字💥 ❌

120: CONFIRMED

{
    "code": "120",
    "message": "CONFIRMED",
    "data": {
        "transaction_id": "001125",
        "amount": 5.00
    }
}

1: ERROR

{
    "code": "1",
    "message": "Внутренняя ошибка",
    "data": null
}

140 INCORRECT_NUMBER_FORMAT

{
    "code": "140",
    "message": "Неправильный формат телефона",
    "data": null
}

152: PINCODE_INCORRECT

{
    "code": "152",
    "message": "PINCODE_INCORRECT",
    "data": null
}

404: USER_NOT_FOUND

{
    "code": "404",
    "message": "Пользователь не найден",
    "data": null
}

135: SERVICE_ERROR

{
    "code": "135",
    "message": "Ошибка сервиса",
    "data": null
}