Authentication API: Change Password | Developer's Help Desk

This API allows a member new to the credit union to create a new password for their account.

API Endpoint

POSThttps://api.itsme247.com/v1/authentication/password

HTTP Headers

Status	Key	Value
Required	CU*Answers-AppKey	GUID
Required	Accept	application/json
Required	Content-Type	application/json
Optional	CU*Answers-CUID	3 digit Credit Union ID

Request


{
  "Password": "string"
}

Parameter	Type	Description
Password	string	The password the member would like to create for their account. The username must follow the rules below: If the API provides the flag to have complex passwords turned on, the rules of such complex passwords must be displayed as provided by the API Documentation. Logic for complex passwords must be adhered to in the UI. Complex Passwords must contain 3 of 4 of the following rules One or more uppercase characters One or more lowercase characters One or more numeric characters Must contain one or more of the following special characters: `~!@#$%&()_+}{\|:;’?/<.>,- Password Length is determined by the Credit Union and can be no longer than 10 characters long. Passwords are case sensitive. These items are required to comply with CUA’s current security requirements, and the settings that the CU has enabled.

Parameter

Type

Description

Password

string

The password the member would like to create for their account. The username must follow the rules below:

If the API provides the flag to have complex passwords turned on, the rules of such complex passwords must be displayed as provided by the API Documentation.
Logic for complex passwords must be adhered to in the UI.
Complex Passwords must contain 3 of 4 of the following rules
- One or more uppercase characters
- One or more lowercase characters
- One or more numeric characters
- Must contain one or more of the following special characters: `~!@#$%&*()_+}{|:;’?/<.>,-
Password Length is determined by the Credit Union and can be no longer than 10 characters long.
Passwords are case sensitive.
These items are required to comply with CU*A’s current security requirements, and the settings that the CU has enabled.

Response


{
  "NextStepCode": "string"
}

Parameter	Type	Description
NextStepCode	string	This parameter will tell you what to call next in the Authentication Process. There are multiple steps that could come up that are required to be processed before a member can continue. Check below for the listing.

Response Error

Check the error table below for information on the error codes that could be returned


{
  "ErrorCode": "string",
  "DisplayMessage": "string",
  "TechnicalMessage": "string",
  "Timestamp": "datetime""
}

Parameter	Type	Description
ErrorCode	string	The ErrorCode is a custom code we use to identify specific areas where something might have not worked right. Write it down and contact us if you continue to have issues.
DisplayMessage	string	This is generally something you can show to members when an error shows up. Though we encourage you to create your own message table based on the ErrorCode field above. We use these display messages for Online Banking, so you might see something tailored to a different application.
TechnicalMessage	string	This is a more detailed, developer-type message that migth help you in determining more of what’s going on. This should never be displayed to the member.
Timestamp	datetime	The date and time of the error. This is useful information to provide CU*Answers, should you need to contact us.

Error Codes

Code	HTTP Code	Description
OT12345763	500	Invalid characters were found within the Password. [ , ^, ]
NO12345672	500	Password too short based on CU requirements.
NF12345704	500	Application keys not found. Contact CU*Answers.
NA12345746	500	Online banking is not active for this Credit Union.
9999999999	500	Requested data not found.
8888888888	403	Requested data not found.
API2000	403	Forbidden: You are not authorized to use this resource.
API2010	403	Forbidden: You are not authorized to use this resource.
API2011	403	Forbidden: You are not authorized to use this resource. Whitelist Issue.
API2012	403	Forbidden: You are not authorized to use this resource.
API2013	403	Forbidden: You are not authorized to use the Accounts API.
API2014	403	Forbidden: You are not authorized to use the Members API.
API2015	403	Forbidden: You are not authorized to use the CreditUnions API.
API2016	403	Forbidden: You are not authorized to use the Transfers API.
API4000	403	Forbidden: You are not authorized to use this resource.
HTTP404	404	The location requested could not be found.
HTTP415	400	The media type requested is not supported. Please use application/json.
OB110	400	The AppKey is missing.
OB111	400	The session token is missing.
OB112	400	The user token is missing.
OB113	403	The id is missing.
OB201	403	The AppKey provided could not be verified.
OB202	403	The AppKey provided could not be verified against the credit union id.
OB203	403	Mismatch between AppKey and credit union id.
OB204	400	Credit union id could not be found. Please validate HttpHeader parameters are valid.
OB310	403	Data received is incomplete. Please validate the data being sent in and try again.
OB500	503	Online access is currently disabled, please try again later or contact the Credit Union for assistance.
OB503	500	[This message changes based on CU Configuration for maintenance]
OB510	500	Data could not be retrieved for this request, please try again or contact the Credit Union for assistance.
OB511	500	Data could not be retrieved for this request, please try again.
NO12345690	500	There was a problem processing your request. Please try again or contact CU*Answers.
NF12345703	500	There was a problem processing your request. Please try again or contact CU*Answers.
NO12345678	500	There was a problem processing your request. Please try again or contact CU*Answers.
NO12345732	500	There was a problem processing your request. Please try again or contact CU*Answers.
NO12345679	500	There was a problem processing your request. Please try again or contact CU*Answers.
NF12345727	500	There was a problem processing your request. Please try again or contact CU*Answers.
NO12345699	500	There was a problem processing your request. Please try again or contact CU*Answers.
NO12345708	500	There was a problem processing your request. Please try again or contact CU*Answers.
NO12345707	500	There was a problem processing your request. Please try again or contact CU*Answers.
NO12345725	500	There was a problem processing your request. Please try again or contact CU*Answers.
NO12345726	500	There was a problem processing your request. Please try again or contact CU*Answers.
BT12345681	500	There was a problem processing your request. Please try again or contact CU*Answers.
BT12345682	500	There was a problem processing your request. Please try again or contact CU*Answers.
SC12345684	500	There was a problem processing your request. Please try again or contact CU*Answers.
SC12345683	500	There was a problem processing your request. Please try again or contact CU*Answers.
SC12345692	500	There was a problem processing your request. Please try again or contact CU*Answers.
SC12345693	500	There was a problem processing your request. Please try again or contact CU*Answers.
SC12345698	500	There was a problem processing your request. Please try again or contact CU*Answers.
SC12345735	500	There was a problem processing your request. Please try again or contact CU*Answers.
NF12345703	500	There was a problem processing your request. Please try again or contact CU*Answers.