Get Device List
Get complete list of registered POS terminals and device details
AuthorizationBearer <token>
Pass access token obtained from login endpoint
In: header
Query Parameters
datastring
Convert payload JSON object to encrypted string and send it to the server
Sample Encryption and Decryption Process:
The following steps demonstrate how to integrate with this API using sandbox credentials.
Step 1: Create JSON Object
{
"merchantCode": "842217"
}Payload Details:
Contains the list of parameters and their corresponding values required to make the API request.
| Field Name | Description | Required |
|---|---|---|
merchantCode | Pass the merchant code provided by Hesabe | Yes |
Step 2: Convert the JSON object into an encrypted string format and post to Hesabe
{
"data": "0e7898bd7464d0c402fe8a949d9cbf9b826ccb9b83b56fa003373275f1947a65"
}Step 3: Receive encrypted response from Hesabe:
{
"response": "60a8f6241932227b840a9f5e36987f4dfdffeadec1af9f33595fe475ab48cbcc1117eaf1b024082cb73c764d398be4e67f753ea11be62e98492b76fcce98afcc4c9d1e79bb390517bed07ce29135d1535f33d692969d3517cb201a719ada3b2e6250f60161934b7150e64126fdd550cfff4f4e8a096659bad3ad9833412c7968c51048bf521f67ff1af8cb4eb8568ae39a9118b5c2ab34218474584f19c6cf79d8478ecdcf9482e32bc174134baaa1f2bcfc987d34c58081fe47c4605165166e62f66ee9d875b26545cbfef18f72648432efae633d4543a4c17b76f64b157ed9e24f37ef7455abd09c6213dc9166b704c2613b80039559e2b0562f3889260342e8e167c2316645851d42c5b69d3f9518ec74b9853075bd992ed6543317d4029b8b94431e909bae585d77de5acbb43b68b83b84980d9965be9186bc65b9131378c270a4b6700e3f7b3c4ad846f5193d466f152d518038cb49dedd57c3f75fa0e714f977bbe99c3f9a2c813b7b1c00414df788c18c775b8e386eb24225e61e01d6fd73b39886183d9fef1d5c82e72068a05d8670f9feaf1437defd59c6d011687a6ab85e759a5efe4eac2cc71ca544ab94fee2336bbfd391f5a8a151df788a67640d475d91e4e92a6f7f69608d90e178d7a2fa71a27bf6932c98db752838a4c1ec391f71f6b3683c0c690af20a395ee5a484319e82c350026c2bc67bf79f7d792b889b1c2586d9b86d6437a562cf531198202110488573c1d354eeaac7e995e52bf8f74fba64f947a5399bc179ce58ab47034f9a5b2c3bd36f364029f0d560927d9c40c8aee4df56ea86328b0c04c40b0c0b638305bcdd800253f12dbc174cf6ed3b62d0004b94a60a53de9a971d64949e8f9152e4388a971904e8cf693243fa003585a2816e591ac452a338e2792ae03903b6412f659b01331935a0bf5bfa52da0f10af8407cae14d7edda61ad31e19cdcc44ea2c7873b363f1f77af12ad5673c81ce1e95632359fbf5abcb5039682415d662850f69eba559d597d59e2d565638797cf36535b875d71bb1fb8a303e72f90e00da8b0fbaef7dcf799c1d8bd0419dce79025998975fa5cdfbc39f8e8ca6e0afafc1ac7904eba05c3650d14973df39d05426db0f173a728a5e85bb1f766ae7f162b559f8c62d9b6f05c320a5b1ee4ff7f64d9e43be5855075013635d9bfa789dbd4b6c40987f527423114044e0073763c864388de99dfa3ed39aee67c16493c84a2f40d4770865cb6a0c9b16cc7bfae30721de06135d5462fa29c76996329db3ce51af88f7d6d310893d18731f577a772c04ec3e5d2c2194a220aa8ceb9022202b5faafc2e00d36a96b07a87f7442d63608889ea7d8199eaf5c9d194af3787dd6bcdd7cd964faf813045be1107ce320373f61ef26eb718464b14c19d95a83750bba66bbbfc184b818b5d99701a180d6ffbccb4cf39df4b56d2f1ce0c2c992950638db5af3574cc6e1b299053cc2046872ec56ac8d669945aa623ad8cee6885572c06cb46f65cfbc686b0fda04ba60b44d3e6a0fcd32d4963354727c2b0501f70152c5254b84f71725f6fa8979de6227449f52896349ffe8413ecc71d450a2d0a7d1275698caf6efe999c68312933c1ca13c03fc060583e933af1ba05d24a5b28476dd24cb5284775b0850039f29a4229f5ab04bf464c2d413ac082fa5f9dfc33533026e8b4c4ca27d225b0e87c9339137ad8aa3bc8288b8d6aa4a091bc89560069878a575bea9ce58ebf200c28dfafad02bb2b954497581635bb624e4ab6a21ae70ee7c89dee2a552cf98aa4ae9c0ea588d3f8d49bdc4b1833ca2e8fd64a56978e87376f63f2807716b878d4b80945e9e674e2d6b7673025123987a3bff7c5c041d0bf0c1e07c56487e738e80f155f1bd166cd515d5773ce4b1a1f3eaa2d8f0816aad1a562853a0614333eaf1f6963e30cbd6def4ff4ef52c1fc1bc719b46f759acebd9ab5f2ce3654035b6d881da13a1b01068f94d25049d8e88a349a7164f8ea88ced6e20c7b420454b07966e5cd612973b8af278e189c2baa16fdd8ec8a7b1dcd541aebc6dd710c136cf3a3ae3f2a75a6941aa3144cea95337e4db7f3278d00269fa9750a0dd54a980eda1569fe6ca2d8d8ed124ab140ba944ff35d5039d323e0cc410df6bc2b8aac852b957d9dbe883fe504286a6bc00d9ad84cce05e6d96782a1406de35b41bc99b3f1de98dd0df268c812f7b4cc6a874055643dd31d34c03244cd647e6ee0f8be89c19a933a85d601a24079491095bdb8dd89bc311d5dad80fefce77f1431c277391ad83cb9067badbc4d2cd1b7ad95e5029cd314e78d57f420d532752d3f931fbd953afabafd954fc8156697409a5d85e92a8bf0b8db95e913eb35be5b141c1bc5169bea5b4208700868ec28028691c5785845bf5b0d9743761fad0a3699dbfe58de2bd2e319007a82898d35acb4e9889fe897f3eb45fe3bf2d4534c07c6b94cdce58a5e71d3b9f6cf91cefbe1aca27d4d6c4927b9fb54b28bd8148ad3af588ed6169396b4c349fd566eb1447332355ba50ebabfbc205273757d309073f0d04324760a72173ebcac3a094cc35f4a20c354637c18f1fe057b954c9ea9c012ab06e74c4e92b0e10cb4c0b93bc82b77f7d24abe97bbe21770609b8c524a3532e7f12a676f91fc0ace8f3c4c23d150351f7e7405ffa5cd68df5a1152dcb1834679e20d8b3211239e0453771841e70f8951bb6d363382e39c5491f6941c2b6687160349887cee651c6a3348923dc6eb63f810867e96f83b10d6811dc2de19b90009f55b2f95c22c1372bbddbbdb3119fcb958d8ae706a179e20fbc93bd78318bf7bed994d1017bf47e94f215fc5e0a9d7c156560958240a4a9e98424065ec603e2d4c5e45b6cb2d2298790675acc11bdb0b8c29e4ac66392b862626466302f2ed9970f8471f60423df1684cbf63217de2f47d00234ed12ab9adf596606a7769d045e621bfb7f106f4afec28df163357a86b2e051b4bf6ffcb24834e12bb4312fdd532c5afc5f5c0cc28d3813be087de4915bd8a543c92265ab02c082f0490c9b7b69a17e47ec78462b48c17d3c4fee2faae34ccfebe621d4f7baf1d5d15ffd18533197c2976b00df5afd6d51960d7dc182db2e460386d4f053e540b123933beb0a8b74263b6f27fbbd4f6eb833476ee2552a161909999594a75f3fc3fdba0876b367e3c54ab3b68c95f099c9bfd5b3b39aa0890f15a7632d34851970245ecd0673096c22615db2550314491245728280c28f93c804732473e8134ec2c40aaeb5c8fb9e1eab6f11105007c7161e59bb3a650ea817f01367c92a058b45a1134eb29309d266d09033af5ff101c58e9bdcf42f1048328ba6d13b9bb34dd41c4db436c5873a7903a8b15a3b8e6423885710415200c072be4eea16390da0631a9ee5b49791892cb23848929b5588aaf477c3d2565698dbee383f1aa11d1148cf9bc75cc9f74da9c0b3b21b4198ebba58cf2e8ed1768d8abb46ece520ad96cf0863f02865aada3516d88a9153b1787298b566d23f7874ffb5b6e79f9876714507271591f498275030e002fe73fc08f84c0ae779b660f0467add2fab2d5ae4e9153caac6a22c0f4e96695983cb1b716be7e3a7655201f4248e5444477d4256e63e7ef76c978b995059924fb3cc088c3269416b88b5ad65b2038b78869469ebb1959f142796271d17037a633c49b0cba387fafdb16f8616287a27700dba238dd4813ea881b40d6a2c20ac3c59d71449187312de35cdeb9a34c1d5f9b2626553779b5f06618a1b4d0443dd92966ef1ac2f9a1e1354a0f30513a40ab8fd069888f0d0233c3230f9649c7d8ed2fd9c183ac3a49303305d242e8a63ba0ef6ba46125c22f2efb93ec53b5bf811644c0fc0a96be32a74b6aadb836bf239ebeacdfdc36af24daf373cf763bfbcb9c226a7ce15c74a3453aa772fe80f7ad05cad723eff74278f593e36374593663dbf0a45554aaf2a90e3c22ec71417590925acd3743d8953f64761f1ee713b922ad376e6cf9ab5ca2beedf0da8324b1af55121f0435402a21fb8d02cb3668a7bf546143f11fb7e45a87527aa078a3dd8de7ea7acd4ad207b252c45f4eb7a469e4b3cc236ce10705f40f2093b21d32fd4bc5069172fdfce534706f8bb494214acdfd7d4276e3801aec560e48552bccdef6474c442d07137496b89b8cf0081c07aac3cc6cff83b2a915ff2111de8993dc0818d59f2e5e54fd3fd903a35d80290bc1926043cd41a9285a98a0a4b4926d5f7ae4589a93c0e0e5c598c71985e3ad7178788a2091d77d646a20538893e5a7ddd2595b9fff07293d2a133f4caf78cd75650c8e9cf38458881f5c31ab706f130ed25ac3fe384f0d546d6aa164b65240eeb78c8f99dd8c968a799d4aac1189b510ea4ebdabd3bb819dca5b5a4d9c3670ea76e59012f1c419713f09d87c8878954bba72a4b4f253a3f660d9cc02acf22c44c40ac089345e9918b627b929fb43c5c3df13f957ea6bc15ef87c0a05b32f6d893882ba31fd73c3690cf94993f65ef1c2084707919010b1a448b0b896b897f1b3ef303fbeb50960474d61d2fb8dc33972467c53eda8a2ac3ddcf8fc3b5d5add278b197f1c7447419b8d0df128dbd805589f1157e7af89b3fbdf6164f87cfd31887e463c51c401d6a931b2a17d11b57b3527646db908911d636fccfc38727190825d1cd1dfabff6b389ddd41b3aecba360443c6bd4ec589fc76b180b3c8a1dbb83a76442"
}Step 4: Decrypt the api response and view the JSON output
{
"status": true,
"message": "Terminal List",
"response": [
{
"id": 272,
"Terminal_ID": 178,
"TerminalID": "48515",
"TerminalName": "ytfrdfg",
"TerminalType": 0,
"PosType": 1,
"MerchantId": 84,
"MerchantName": "TestHome1",
"Merchant_Seq_Id": 111856,
"MerchantCompanyName": "TestHome1",
"MerchantCode": "842217",
"category_sqId": "MV-0013-0000-NA",
"Remark1": "",
"Remark2": "",
"KnetType": 1,
"KnetValue": "0.300",
"KnetMinValue": "0.010",
"MpgsType": 1,
"MpgsValue": "2.500",
"MpgsMinValue": "0.010",
"GccType": 1,
"GccValue": "2.500",
"GccMinValue": "0.010",
"MonthlySubscribtionCharge": 25,
"InitialCharge": 12,
"Status": 1,
"StartDate": "2025-10-09 00:00:00",
"EndDate": "2026-10-01 00:00:00",
"created_at": "2025-10-09 14:29:33",
"updated_at": "2025-10-09 14:30:23"
},
{
"id": 273,
"Terminal_ID": 180,
"TerminalID": "yutre34567",
"TerminalName": "ijuhygtfrg",
"TerminalType": 0,
"PosType": 1,
"MerchantId": 84,
"MerchantName": "TestHome1",
"Merchant_Seq_Id": 111856,
"MerchantCompanyName": "TestHome1",
"MerchantCode": "842217",
"category_sqId": "MV-0013-0000-NA",
"Remark1": "",
"Remark2": "",
"KnetType": 1,
"KnetValue": "0.320",
"KnetMinValue": "0.010",
"MpgsType": 1,
"MpgsValue": "2.500",
"MpgsMinValue": "0.010",
"GccType": 1,
"GccValue": "2.500",
"GccMinValue": "0.010",
"MonthlySubscribtionCharge": 15,
"InitialCharge": 12,
"Status": 1,
"StartDate": "2025-10-09 00:00:00",
"EndDate": "2026-01-31 00:00:00",
"created_at": "2025-10-09 14:32:31",
"updated_at": "2025-10-09 14:32:57"
},
{
"id": 274,
"Terminal_ID": 182,
"TerminalID": "2011687",
"TerminalName": "terminal1323",
"TerminalType": 0,
"PosType": 1,
"MerchantId": 84,
"MerchantName": "TestHome1",
"Merchant_Seq_Id": 111856,
"MerchantCompanyName": "TestHome1",
"MerchantCode": "842217",
"category_sqId": "MV-0013-0000-NA",
"Remark1": "",
"Remark2": "",
"KnetType": 1,
"KnetValue": "0.300",
"KnetMinValue": "0.010",
"MpgsType": 1,
"MpgsValue": "2.500",
"MpgsMinValue": "0.010",
"GccType": 1,
"GccValue": "2.500",
"GccMinValue": "0.010",
"MonthlySubscribtionCharge": 25,
"InitialCharge": 12,
"Status": 1,
"StartDate": "2025-10-12 00:00:00",
"EndDate": "2026-10-01 00:00:00",
"created_at": "2025-10-12 11:34:08",
"updated_at": "2025-10-12 11:34:32"
},
{
"id": 277,
"Terminal_ID": 185,
"TerminalID": "29706431",
"TerminalName": "terminal122",
"TerminalType": 0,
"PosType": 1,
"MerchantId": 84,
"MerchantName": "TestHome1",
"Merchant_Seq_Id": 111856,
"MerchantCompanyName": "TestHome1",
"MerchantCode": "842217",
"category_sqId": "MV-0013-0000-NA",
"Remark1": "Remark One",
"Remark2": "Remark Two",
"KnetType": 1,
"KnetValue": "0.300",
"KnetMinValue": "0.010",
"MpgsType": 1,
"MpgsValue": "2.500",
"MpgsMinValue": "0.010",
"GccType": 1,
"GccValue": "2.500",
"GccMinValue": "0.010",
"MonthlySubscribtionCharge": 15,
"InitialCharge": 12,
"Status": 0,
"StartDate": "2025-10-16 00:00:00",
"EndDate": "2025-11-30 00:00:00",
"created_at": "2025-10-16 11:46:00",
"updated_at": "2025-11-05 11:26:47"
},
{
"id": 279,
"Terminal_ID": 187,
"TerminalID": "29708454",
"TerminalName": "A99",
"TerminalType": 0,
"PosType": 1,
"MerchantId": 84,
"MerchantName": "TestHome1",
"Merchant_Seq_Id": 111856,
"MerchantCompanyName": "TestHome1",
"MerchantCode": "842217",
"category_sqId": "MV-0013-0000-NA",
"Remark1": "",
"Remark2": "",
"KnetType": 1,
"KnetValue": "0.100",
"KnetMinValue": "0.010",
"MpgsType": 1,
"MpgsValue": "2.500",
"MpgsMinValue": "0.010",
"GccType": 1,
"GccValue": "2.500",
"GccMinValue": "0.010",
"MonthlySubscribtionCharge": 15,
"InitialCharge": 12,
"Status": 0,
"StartDate": "2025-11-10 00:00:00",
"EndDate": "2026-01-31 00:00:00",
"created_at": "2025-11-10 10:56:47",
"updated_at": "2025-11-10 13:17:48"
}
]
}Header Parameters
accessCodestring
Pass the merchant access code issued by Hesabe
Acceptstring
application/json
Content-Typestring
application/json
Response Body
application/json
application/json
application/json
application/json
fetch("https://merchantapisandbox.hesabe.com/api/v1/merchant/smartpos-terminals?data=0e7898bd7464d0c402fe8a949d9cbf9b826ccb9b83b56fa003373275f1947a65", { method: "GET", headers: { "accessCode": "c333729b-d060-4b74-a49d-7686a8353481", "Accept": "application/json", "Content-Type": "application/json" }}){
"status": true,
"message": "Terminal List",
"response": [
{
"id": 272,
"Terminal_ID": 178,
"TerminalID": "48515",
"TerminalName": "ytfrdfg",
"TerminalType": 0,
"PosType": 1,
"MerchantId": 84,
"MerchantName": "TestHome1",
"Merchant_Seq_Id": 111856,
"MerchantCompanyName": "TestHome1",
"MerchantCode": "842217",
"category_sqId": "MV-0013-0000-NA",
"Remark1": "",
"Remark2": "",
"KnetType": 1,
"KnetValue": "0.300",
"KnetMinValue": "0.010",
"MpgsType": 1,
"MpgsValue": "2.500",
"MpgsMinValue": "0.010",
"GccType": 1,
"GccValue": "2.500",
"GccMinValue": "0.010",
"MonthlySubscribtionCharge": 25,
"InitialCharge": 12,
"Status": 1,
"StartDate": "2025-10-09 00:00:00",
"EndDate": "2026-10-01 00:00:00",
"created_at": "2025-10-09 14:29:33",
"updated_at": "2025-10-09 14:30:23"
}
]
}{
"status": false,
"message": "Request not found, Please verify the request data",
"response": null
}{
"message": "Internal server error occurred"
}{
"status": false,
"code": 506,
"message": "Invalid Request Data",
"response": null
}