Иштеп чыгуучуларга
xPay API QR төлөмдөрүн интеграциялоо үчүн ыңгайлуу жана ишенимдүү мүмкүнчүлүктөрдү берет. Система ийкемдүү жөндөөлөрдү жана сырттан интеграцияны колдойт.
XPAY API артыкчылыктары
Бизнес жана UX үчүн ыңгайлуу төлөм сценарийлери.
Кыргызстандагы каалаган банк колдонмосу аркылуу төлөм
Колдонуучу өзүнө ыңгайлуу тиркемени тандап, QR аркылуу оңой төлөй алат.
Банк баскычтары бар төлөм барагы
QR жана банктын төлөм баскычтары бар даяр pay‑баракча.
Динамикалык жана статикалык QR
Ар бир төлөм үчүн QR түзүңүз же белгиленген сумма менен статикалык QR колдонуңуз.
Идентификация үчүн ийкемдүү параметрлер
Плательщик, кызмат жана комментарийлердин id параметрлерин бериңиз.
Төлөм статусу боюнча автоматтык билдирүү
Webhook аркылуу төлөмдү дароо иштетип, кошумча сурамдарсыз кабыл ала аласыз.
Төлөмдөн кийин редирект
Төлөмдөн соң кардарды керектүү бетке кайтарыңыз.
APIни сиздин тапшырмага акысыз ыңгайлаштыруу
Эгер стандарттан тыш сценарий керек болсо, биз интеграцияны макулдашып ишке ашырабыз.
XPAY API 3 күндө туташтырылат
API түшүнүктүү жана жөнөкөй — системага интеграция минималдуу убакытты алат.
Төмөндө QR‑төлөм алуу үчүн 3 негизги кадам берилген.
Авторизация
Авторизация маалыматтарын жиберип, токен алыңыз. Андан кийин жооптогу Bearer токенди колдонуңуз.
Сурамдын денеси
POST{
"client_id": "<YOUR_CLIENT_ID>",
"client_secret": "<YOUR_CLIENT_SECRET>"
}Тест үчүн биз сураныч боюнча авторизация маалыматтарын беребиз. Өндүрүш үчүн жеке ключторду колдонуңуз. Алар XPAY кабинетиндеги Профиль бөлүмүндө бар.
QR түзүү
Токен менен керектүү параметрлерди берип, QR түзүү үчүн сурам жөнөтүңүз.
Милдеттүү талаалар: uuid жана amount.
Башталычтар
POST{
"Authorization": "Bearer <YOUR_ACCESS_TOKEN>",
"Accept": "application/json"
}Сурамдын денеси
POST{
"uuid": "985b0981-8e71-41bf-97fd-4e8769e8cd9f", // соода пунктунун id
"type": "dynamic", // qr-коддун түрү
"payer_id": "10000000000005", // төлөөчүнүн id
"service_id": "1", // кызмат id
"service_name": "MyService", // кызматтын аталышы
"comments": "Төлөм комментарийи", // qr үчүн комментарий
"callback_url": "http://webhook.url", // вебхук кабыл алуу дареги
"return_url": "http://redirect.url", // төлөмдөн кийин кайтаруу дареги
"check_url": "http://confirmation.url", // qr ачылар алдында тастыктоо дареги
"amount_change": false, // сумманы өзгөртүүгө болот
"amount": 1000 // сумма
}Жооп
200 OK{
"status": "Success",
"message": "Generate QR Code",
"data": {
"qr_transaction_id": "2843595907tv78Stf2coPEXvu",
"qr_code": "https://pay.xpay.kg#00020101021132450012ab2b.xpay.kg01011101400407202310247120211332900251745226190sa6vxjr52p62ui25204599953034175909Telemedia63044e70",
"identificator": "29435071778cycy252qj7u29y",
"type": "dynamic",
"payer_id": "10000000000005",
"service_id": "1",
"service_name": "MyService",
"comments": "Төлөм комментарийи",
"callback_url": "http://webhook.url",
"return_url": "http://redirect.url",
"amount_change": false,
"request_amount": 1000,
"amount": 1000,
"payable": 992
}
}QR төлөмү
Ар бир QR pay.xpay.kg шилтемеси болуп түзүлөт. Аны браузерден ачып, банк колдонмосуна өтүп же 1 баскычта төлөөгө болот.
Мобилдик жана веб сервистер үчүн QRга айлантуунун ордуна pay.xpay.kg шилтемесин берүү сунушталат.
QR статусы
Транзакция идентификаторун берип, webhook аркылуу же өзүнчө сурам менен төлөм статусун алыңыз.
Жооп
GET{
"status": "Success",
"message": "Status QR Code",
"data": {
"qr_transaction_id": "1734439544EjZ25uVX16UDKxX",
"pay_status": "COMPLETED",
"transaction_uuid": "9dc11610-0651-40ee-8459-cabe889fec3x",
"trx": "467de507-5a4d-4a26-bb95-9bdf7258f300",
"request_amount": "240.00000000",
"amount": "235.00000000",
"payable": "233.12000000",
"created_at": "2024-11-05T05:20:51.000000Z",
"executed_time": "2024-12-18 18:50:44"
}
}Төлөм статустары
Толук документация керекпи?
Өтүнмө калтырыңыз — документация жана тесттик мүмкүнчүлүктөрдү беребиз.
Өтүнмө жөнөтүлдү
Жакын арада байланышабыз.