Change TSP

*TSP: Transaction Security Password

Authorize/Identity:

• Pre-prod: https://pre-prod-id.idshare.info/ (https://pre-prod-id.idshare.info/swagger/index.html)

• Production: https://id.idshare.info (https://id.idshare.info/swagger/index.html)

Process Flow

Change transaction security password flow

API INTEGRATION

1. Generate OTP code

POST /api/v{version}/user/generate-otp-token

Request Body

Name	Type	Description
type*	Enum

200: OK

{
    // Response
}

400: Bad Request

{
    // Response
}

Http Request

Attribute	Type	Required
type	enum

Example Request

https://pre-prod-id.idshare.info/api/v1/user/generate-otp-token?type=EMAIL

Http Response

Attribute	Type	Required
result	boolean
message	string
code	string
data	any

Example Response

{
  "result": true,
  "message": "Success",
  "code": "00",
  "data": null
}

2. Verify OTP code for change TSP

POST /api/v{version}/user/verify-otp-token

Request Body

Name	Type	Description
otp*	string

200: OK

{
    // Response
}

Http Request

Attribute	Type	Required
otp	string

Http Response

Attribute	Type	Required
result	boolean
message	string
code	string

Example Response

}
  "result": true,
  "message": "string",
  "code": "string"
}

Functional Specification

Field name	Format	Required	Description
Current password	Textbox		Enter your current transaction security password in the field. Can hide/show the password when pressing the show/hide password icon, show the password mask as (•) or (*) – hide the password by default If you leave it blank or enter a space, the message “Please enter your current transaction security password” In case the current security password is entered incorrectly, the message "Incorrect transaction security password" will be displayed.
Password TSP	Textbox		Format: ⦁ At least 6 characters, at most 16 characters ⦁ Display a note on the password field “To ensure security, you should set a password that includes uppercase, lowercase, numeric character(s) and special character(s)” Can hide/show password when pressing icon show/hide password, display cover password as (•) or (*) – hide password by default In case the password is the same as the current transaction security password, the message “Please enter a different password from the current transaction security password.” In case the password is the same as the login password, the message "Please enter a different password with a login password" If you leave it blank or enter a space, the message "Please enter a transaction security password." In case of incorrect/missing format, the message “Please enter the correct format from 6 to 16 characters”
Confirm password TSP	Textbox		Can hide/show password when clicking show/hide password icon, show password mask as (•) or (*) – hide password by default In case you leave it blank or enter a space, the message "Please re-enter transaction security password." In case of re-entering the password that does not match the password field above, the message “The password doesn't match. Please re-enter the password that matches the one entered above.”
Confirm	Button		Press the button to change the password Show message “You have successfully changed your password”

API Description

Step	Factor	Description
1	User	Select change transaction security password
2	Frontend	Display the input frame, there are 3 required fields: ⦁ Current Password ⦁ New Password ⦁ Confirm New Password
3	User	Enter information in the fields Select change password
4	Frontend	Check the information fields in the formats described above: If true -> Step 5 If false, the corresponding message is displayed
5	Backend	Update user's changed password
6	Frontend	Display successful password change message