POST /api/v2/esign/nafath/sign — Hash Sign V2
Enhanced Nafath signing endpoint (v2) with additional biometric verification options, improved error handling, and support for Nafath API v3 authentication flows.
Authentication
ClientCert
Request Headers
- Content-Type (required)
- application/json
Request Body
Content-Type: application/json
- requestId (GUID, required)
- Signature request identifier.
- signatureAppearance (object, optional)
- Signature appearance configuration.
- file (object, required)
- File to be signed (BaseFile).
- config (object, optional)
- Signature configuration options.
- signres (array, optional)
- An array of objects representing the customer information for signing.
{
"requestId": "9af7cb57-436f-40e9-b05c-75d05732db1c",
"signatureAppearance": {
"isVisible": true,
"pageNumber": 1,
"rect": {
"x1": 100,
"y1": 100,
"width": 200,
"height": 80
},
"appearanceImageBase64": "iVBORw0KGgoAAAANSUhEUgAAAAUA...",
"extraText": "Digitally signed via Nafath"
},
"signres": [
{
"firstNameArabic": "xxxxx",
"firstNameEnglish": "xxx",
"secondNameArabic": "",
"secondNameEnglish": "",
"familyNameArabic": "xxxx",
"familyNameEnglish": "xxx",
"nationalId": "9551058000",
"mobileNumber": "079999999",
"emailAddress": "A.A@Gmail.com"
}
],
"file": {
"file": "JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9BUDw8...",
"fileName": "contract.pdf",
"password": null
},
"config": {
"showAccountName": true,
"showRequestId": true,
"showSignDate": true,
"showPageNumber": false
}
}Responses
HTTP 200 — Nafath v2 signing completed
{
"data": "JVBERi0xLjQKJeLj.......",
"errorCode": 0,
"message": null,
"returnUrl": "/dashboard",
"stateValidationErrors": null,
"signature": ""
}