Create a signing method

How to create signing methods for your users.

Signing methods are like passwords that grant user access to their wallets. Each user has their own signing method. The user can perform transactions, sign messages, and recover their PIN by providing their signing method. Users can have three types of signing methods: PIN, Emergency code, and Biometric.

📘

The first signing method for a user must always be a PIN which should be six digits. (You dont need to pass a signing method header when creating the first signing method)

If you're creating an additional signing method, then you need to pass a valid signing method in the header request as explained in the table below.

Parameter	Param Type	Value	Description	Example Value
`Signing-Method`	Header	`id:value`	`id`: This is the ID of the signing method `value`: This is the value of the signing method	`756ae7a7-3713-43ee-9936-0dff50306488:123456`

📘
Learn more about signing methods.

Request Endpoint: reference

POST /api/users/{userId}/signing-methods

Parameter	Param Type	Description	Data Type	Mandatory
`{userId}`	Path	The ID of the user for whom to create the signing method for	String	✅
`type`	Body	The type of signing method to create for this user. Allowed values: `PIN, BIOMETRIC, EMERGENCY_CODE`	String	✅
`value`	Body	The value of the signing method. For `PIN`, the value should be 6 digits. For `EMERGENCY_CODE`, the value should be 25 characters, or you can leave it blank to autogenerate the code with the correct entropy.	String	❌
`physicalDeviceId`	Body	A unique authentication ID, such as FaceID, TouchID, etc. This is to be set with the type: `BIOMETRIC`.	String	❌

Request Body:

{
  "type": "PIN",
  "value": "123456"
}

Response Body:

Param	Description
result.`id`	This is the ID of the signing method.

{
    "success": true,
    "result": {
        "id": "f3371883-2024-469b-a122-ca22f58ba6b9",
        "type": "PIN",
        "incorrectAttempts": 0,
        "remainingAttempts": 10,
        "hasMasterSecret": true
    }
}

Updated about 2 months ago