Add new SmartCA digital signature

Updated date: 17/03/2025
Updated by: VNPT eContract's team

---

Purpose

Add a new SmartCA digital signature for the user. You can add all digital certificates of a user or add a specific certificate based on a given serial number.

• Request URL: /api/users/smart-ca/add
• HTTP method: POST
• HTTP content-type: application/json
• Authorize: Bearer token
• Parameter:

Key	Type	Description
userId	int	[Required] Id of user
username	string	[Required] CCCD/HC/MST of SmartCA account
serialNumber	string	Serial of digital signature

Sample request

{
    "userId": 1234,
    "userName": "08009000000",
    "serialNumber": "540101014e4653549c5a6fdcb9c89999"
}

Sample response body

{
    "data": {
        "id": 1234,
        "createdDate": "2021-01-06T17:06:07.2893325",
        "comId": 16,
        "code": "USER01",
        "username": "your_username",
        "name": "Nguyen Van A",
        "phone": "0919XXXXXX",
        "email": "email_address",
        "validFrom": "2021-12-07T09:15:00",
        "validTo": "2022-12-07T09:15:00",
        "isValid": true,
        "signConfirmationEnabled": false,
        "isAccountLocked": false,
        "accountId": "c59125a9-5fee-44e2-b0ff-b229634bf0b2",
        "signatureText": "Sign by: {{SubjectDN.CN}} / {{SubjectDN.O}} / {{SubjectDN.OU}} / {{SubjectDN.UID}}\r\nPosition: {{SubjectDN.T}}\r\nSign date: {{SignTime}}",
        "roles": [
            {
                "id": "29e1138e-833e-4b3a-897a-08da9c3dd633",
                "code": "Admin",
                "name": "Admin manages the company",
                "description": "Admin account manages the company"
            }
        ],
        "signMethod": {
            "value": 2,
            "description": "VNPT SmartCA"
        },
        "status": {
            "value": 1,
            "description": "Enabled"
        },
        "receiveOtpMethod": {
            "value": 1,
            "description": "Email"
        },
        "receiveNotificationMethod": {
            "value": 0,
            "description": "Email"
        },
        "personalCertificateId": 22105,
        "smartCaId": 19843,
        "extraValues": [
        ],
        "usedMemory": 0,
        "defaultSmartCa": {
            "id": 37666,
            "name": "Nguyen Van A 2026",
            "commonName": "Nguyễn Văn A",
            "uid": "08009000000",
            "validFrom": "2025-03-07T08:56:16Z",
            "validTo": "2026-03-07T08:56:16Z",
            "serialNumber": "540101014e4653549c5a6fdcb9c89999",
            "subjectDN": "UID=CCCD:08009000000,CN=Nguyễn Văn A,L=Quận 3,ST=Hồ Chí Minh,C=VN",
            "status": {
                "value": 1,
                "description": "Active"
            },
            "smartCaServiceName": "TEST_CÁ NHÂN ĐỐI TÁC",
            "smartCaSignMethod": {
                "value": 1,
                "description": "Normal"
            },
            "smartCaAccountType": {
                "value": 1,
                "description": "Personal"
            },
            "smartCaUsername": "08009000000",
            "isValid": true,
            "provider": {
                "value": 1,
                "description": "VNPT SmartCA"
            },
            "createdDate": "2025-03-17T08:56:42.4886305+07:00",
            "isBusinessSmartCaAccount": false,
            "ownerId": 6,
            "createdByUserId": 6
        },
        "userCertificates": [
            {
                "id": 37666,
                "name": "Nguyen Van A 2026",
                "commonName": "Nguyễn Văn A",
                "uid": "08009000000",
                "validFrom": "2025-03-07T08:56:16Z",
                "validTo": "2026-03-07T08:56:16Z",
                "serialNumber": "540101014e4653549c5a6fdcb9c89999",
                "subjectDN": "UID=CCCD:08009000000,CN=Nguyễn Văn A,L=Quận 3,ST=Hồ Chí Minh,C=VN",
                "status": {
                    "value": 1,
                    "description": "Active"
                },
                "smartCaServiceName": "TEST_CÁ NHÂN ĐỐI TÁC",
                "smartCaSignMethod": {
                    "value": 1,
                    "description": "Normal"
                },
                "smartCaAccountType": {
                    "value": 1,
                    "description": "Personal"
                },
                "smartCaUsername": "08009000000",
                "isValid": true,
                "provider": {
                    "value": 1,
                    "description": "VNPT SmartCA"
                },
                "createdDate": "2025-03-17T08:56:42.4886305+07:00",
                "isBusinessSmartCaAccount": false,
                "ownerId": 6,
                "createdByUserId": 6
            }
        ],
        "smartCaGroups": [
        ]
    },
    "success": true,
    "code": 0,
    "messages": [
        "Add SmartCA certificate successfully"
    ]
}