🔳Dynamic QR generate

The documentation covers an API designed to dynamically generate QR codes.

Take into consideration, there is no test transaction via QR

1. To generate QR image, please send POST request to the following endpoint

POST https://{url}.finipay.kg/gen/qr/dynamic

Accessing the API requires passing credentials using Basic Authentication in the HTTP request header.

Request body:

Name	Type	Description
sum*	int	transaction amount in tyiyn (cents)
requisite	String	phone number, name of the enterprise (branch) shall be indicated
callback_url	String	URL for callbacks is not required

Example:

{
    "sum": 100,
    "requisite": "996555000001",
    "callback_url": "https://example.com"
}

Response:

In the response you will receive an PNG image encoded in base64

File format: PNG

Image dimensions: 400x400 pixels

100

{
    "code": "100",
    "message": "SUCCESS",
    "data": Картинка QR, закодированная в base64
}

104

{
    "code": "104",
    "message": "BAD_REQUEST",
    "data": null
}

105

{
    "code": "105",
    "message": "INTERNAL_ERROR",
    "data": null
}

106

{
    "code": "106",
    "message": "MERCHANT_NOT_FOUND",
    "data": null
}

1. To generate QR data, please send POST request to the following endpoint

POST https://{url}.finipay.kg/gen/qr/dynamic/data

Request Body:

Name	Type	Description
sum	int	transaction amount in tyiyn (cents)
requisite	String	phone number, name of the enterprise (branch) shall be indicated
callback_url	String	URL for callbacks is not required

Example:

{
    "sum": 100,
    "requisite": "996555000001",
    "callback_url": "https://example.com"
}

Response:

You will receive QR data in response

100

{
    "code": "100",
    "message": "SUCCESS",
    "data": qr_data
}

104

{
    "code": "104",
    "message": "BAD_REQUEST",
    "data": null
}

105

{
    "code": "105",
    "message": "INTERNAL_ERROR",
    "data": null
}

106

{
    "code": "106",
    "message": "MERCHANT_NOT_FOUND",
    "data": null
}

Status

To get status, send GET request to the following endpoint

GET https://{urll}.finipay.kg/gen/qr/transaction/status

Request Param:

Key	Value
transaction_id	FNP89a867313cc34613ac8608ec31b1c

Example: https://{url}.finipay.kg/gen/qr/transaction/status?transaction_id=QPF89a867313bb34613ac8608ec31b1c

Response

The date field contains information about the payment statusl.

100

// Промежуточный
{
    "code": "100",
    "message": "Success",
    "data": "СREATED"
}



// Финальный
{
    "code": "100",
    "message": "Success",
    "data": "SUCCESSFUL"
}

104

{
    "code": "104",
    "message": "Bad request",
    "data": null
}