💰Payment

Page description

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

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

Take into consideration

Minimal amount for paymemts via Cards/Mbank - 1 KGS

Minimal amount for Megapay - 5 KGS

Request Body

Name	Type	Description
orderNumber*	String	Unique payment ID
phone*	String	Payment details. For test environment: 996772140014
amount*	Integer	The amount of the request for funds
comment*	String	Payment description
callbackUrl	String	URL for callbacks is not required

{
    "orderNumber": "order_1747200104390",
    "phone": "996772140014",
    "amount": 1,
    "comment": "test",
    "callbackUrl":"test"
}

⚠️ 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😀漢字💥 ❌

110: CREATED

{
    "code": "110",
    "message": "CREATED",
    "data": {
        "amount": 1,
        "quid": "FP20240319165056648",
        "dateTime": "2024-03-19T16:50:58"
    }
}

1: ERROR

{
    "code": "1",
    "message": "ERROR",
    "data": null
}

126: INCORRECT_ORDER_ID

{
    "code": "126",
    "message": "INCORRECT_ORDER_ID",
    "data": null
}

220 TRANSACTION_LIMIT_EXCEEDED

{
    "code": "220",
    "message": "TRANSACTION_LIMIT_EXCEEDED",
    "data": null
}

404: USER_NOT_FOUND

{
    "code": "404",
    "message": "USER_NOT_FOUND",
    "data": null
}

171: INCORRECT_SUM

{
    "code": "171",
    "message": "INCORRECT_SUM",
    "data": null
}

112: DUPLICATED_ORDER_ID

{
    "code": "112",
    "message": "DUPLICATED_ORDER_ID",
    "data": null
}

140: INCORRECT_NUMBER_FORMAT

{
    "code": "140",
    "message": "INCORRECT_NUMBER_FORMAT",
    "data": null
}

135: SERVICE_ERROR

{
    "code": "135",
    "message": "SERVICE_ERROR",
    "data": null
}

Confirm

after initializing the payment, you need to do confirm. As a result of the response to create, when the payment is successfully created, you get a quid that you need to drive into confirm

To do confirm, please send a POST request to the following endpoint: https://{url}.finipay.kg/api/v1.1.0/mbank/confirm.

POST https://{url}.finipay.kg/api/v1.1.0/mbank/confirm

Request Body

Name	Type	Description
orderNumber*	String	Unique payment ID
otp*	String	a one-time password that you will receive to the specified phone number when initializing the payment. Test otp (0000)

120: CONFIRMED

{
    "code": "120",
    "message": "CONFIRMED",
    "data": {
        "quid": "FP20240319165056648",
        "dateTime": "2024-03-19T16:53:05"
    }
}

1: ERROR

{
    "code": "1",
    "message": "ERROR",
    "data": null
}

404: PAYMENT_NOT_FOUND

{
    "code": "400",
    "message": "PAYMENT_NOT_FOUND",
    "data": null
}

126: INCORRECT_ORDER_ID

{
    "code": "126",
    "message": "INCORRECT_ORDER_ID",
    "data": null
}

122: TRANSACTION_ALREADY_CONFIRMED

{
    "code": "122",
    "message": "TRANSACTION_ALREADY_CONFIRMED",
    "data": null
}

123: CONFIRMATION_TIMEOUT

{
    "code": "123",
    "message": "CONFIRMATION_TIMEOUT",
    "data": null
}

128: INSUFFICIENT_FUNDS

{
    "code": "128",
    "message": "INSUFFICIENT_FUNDS",
    "data": null
}

135: SERVICE_ERROR

{
    "code": "135",
    "message": "SERVICE_ERROR",
    "data": null
}