POS Invoice
Resend POS invoice notification
POST
Base URL
Sandbox Base URL
Strictly for sandbox testing. Never use the sandbox URL in your production environment.
https://merchantapisandbox.hesabe.com
bearerAuthheader
AuthorizationBearer <JWT>Pass access token obtained from login endpoint
accessCode*stringPass the merchant access code issued by Hesabe
Accept*stringapplication/json
Content-Type*stringapplication/json
application/json- body
data*stringConvert 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", "customer_name": "Salman", "customer_email":"", "customer_phone":"", "amount":0.100, "terminal_id":"29708454", "invoice_number":"", "description":"test", "resend":1, // Pass 1 for resend "transaction_id": "297084548417629359279347779043" // Pass Invoice trans ID}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 |
customer_name | Pass the customer name | Yes |
amount | Pass the invoice amount | Yes |
terminal_id | Pass the Terminal ID | Yes |
resend | Pass 1 for resend | Yes |
transaction_id | Pass invoice transaction_id from the response object | Yes |
customer_phone | Pass customer mobile number | Optional |
customer_email | Pass customer email address | Optional |
invoice_number | Pass the invoice number | Optional |
description | Pass invoice description details | Optional |
Step 2: Convert the JSON object into an encrypted string format and post to Hesabe
{ "data": "0e7898bd7464d0c402fe8a949d9cbf9b191a5c36b416dd227c080e9e34889e3789f0a48c2a935932bc2698cfae0745a892b6fffc18bf86638fda8dcebd9e216416e552057bfe18900f0fd3e52c8f2d87ae1a2c74c68ae67b941d1f55e6a1ad3fbbbb043d5be213831c86448d163a473601f52f115944b2fe5f218424c0eaa54aa7af4880acf1ddd6e514617670691a3f6f539422c79992b3d6ea3cb6d1d3ead2dc334251842955c6a2b7d9feff3af3596d6c68e00ed474b6f03f3eeae347f11f62a19cb625d232245ed6be7676393bccd9fadbeacd6ec0e909b56c8d847c72d566f246b20d595cff94df0e5efb7188cd"}Step 3: Receive encrypted response from Hesabe:
{ "response": "60a8f6241932227b840a9f5e36987f4d9bc63e437527339368fb94048810247047e87f2bd5f585e5f7601011b49134d0c8ffaaee0c71aa4d9dc245a646a7263c5a795c446e394b6e9598087aa74de33df87f0af89c7b68276bbd7a5a475c57bdede3765d14788364afbd48bd2915a771536a0f64d8937e58455dd59374cfaec55f2faf213425b173d5e8e2383460753fe53fcdcbfd90145b2c66c844f12fa4d1bcc51de9aa2d76e8bdf7872b0e52a372f1d377ef474a0328f2924f7983e0cb600d405fd01cf8472cd395573a42e2e7bb7a720155b98c748b96cde354baf63c07777e629d3d801379b0ed7934d8823af0dfe5cb68d826d3110036e3eda865b3ea9e6f988d6d3d24339b04873e08794f74387d89aba3900602b44e85ab963505e12c92714362e13693e15ddadfac23b9568d8246f16589c451a02f83503ecd52cc5d4b76ae7fa7deada9319fbbf999fa2d3366e4071c6a031c8caa7be52a39567beecbde0173a502eb2456abcdc66329cdb9ba4785f36c527f200f610e267215934fd7ef8f4c5a4f36e25f877acb9a30d82363934497f2ec60cc6ed2a64538c6aa8859aa94868e6ef356f68a840fd50aa042b2be636bdbb09bd9c29e293a1d756dcb2df913e0d13cc2bd7cfb2a4c712898af6daf45e020f1604aed362abf3b6a1c"}Step 4: Decrypt the API response and view the JSON output
{ "status": true, "message": "POS invoice resent successfully", "response": { "id": 267, "transaction_id": "297084548417629359279347779043", "invoice_number": "", "amount": "0.100", "terminal_id": 29708454, "merchant_id": 84, "merchant_name": "TestHome1", "terminal_name": "A99", "customer_name": "Salman", "customer_email": "", "customer_phone": "", "description": "test", "status": 0, "created_by": 84, "created_by_name": "test", "created_at": "2025-11-12 11:25:27", "updated_at": "2025-11-12 11:25:27" }}Details fetched successfully. Decrypt the server response to view the final result
application/json- response
status?booleanmessage?stringresponse?const body = JSON.stringify({ "data": "0e7898bd7464d0c402fe8a949d9cbf9b191a5c36b416dd227c080e9e34889e3789f0a48c2a935932bc2698cfae0745a892b6fffc18bf86638fda8dcebd9e216416e552057bfe18900f0fd3e52c8f2d87ae1a2c74c68ae67b941d1f55e6a1ad3fbbbb043d5be213831c86448d163a473601f52f115944b2fe5f218424c0eaa54aa7af4880acf1ddd6e514617670691a3f6f539422c79992b3d6ea3cb6d1d3ead2dc334251842955c6a2b7d9feff3af3596d6c68e00ed474b6f03f3eeae347f11f62a19cb625d232245ed6be7676393bccd9fadbeacd6ec0e909b56c8d847c72d566f246b20d595cff94df0e5efb7188cd"})fetch("https://merchantapisandbox.hesabe.com/api/v1/merchant/smartpos-transaction", { method: "POST", headers: { "Content-Type": "application/json", "accessCode": "c333729b-d060-4b74-a49d-7686a8353481", "Accept": "application/json" }, body})Example Response
{ "status": true, "message": "POS invoice resent successfully", "response": { "id": 267, "transaction_id": "297084548417629359279347779043", "invoice_number": "", "amount": "0.100", "terminal_id": 29708454, "merchant_id": 84, "merchant_name": "TestHome1", "terminal_name": "A99", "customer_name": "Salman", "customer_email": "", "customer_phone": "", "description": "test", "status": 0, "created_by": 84, "created_by_name": "test", "created_at": "2025-11-12 11:25:27", "updated_at": "2025-11-12 11:25:27" }}