POST access_tokens/verify
- Former user (Deleted)
- Joseph Ioannou (Unlicensed)
- p_demou (Deactivated)
This method verifies access tokens which are in Pending Verification life cycle state. A single access token can be verified by each call.
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
| access_token_identifier (mandatory) | Access Token identifier | The identifier of the access token that should be verified. The allowed access token identifier fields are the following:
| ||||||||||||
verification_code (mandatory) | String | The verification code which is needed in order to verify the access token | ||||||||||||
pass_code (optional) | String | The pass code of the access token that will be provided during verification Available from CRM.COM R14.0.0 | ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
|---|---|---|
id | String | The ID of the retrieved access token |
| number | String | The number of the retrieved access token |
| life_cycle_state | String | The state of the retrieved access token which can be one of the following: EFFECTIVE, NOT_EFFECTIVE, PENDING_VERIFICATION |
authentication_code | String | The authentication code of the retrieved access token |
| identifier | String | The identifier of the retrieved access token |
| card_masked_number | String | The masked number of the card as provided
Available from CRM.COM R16.2.0 |
| card_last_4_digits | String | The last 4 digits of the card as provided.
Available from CRM.COM R15.0.0 Deprecated from CRM.COM R16.2.0 |
| verification_code | String | The verification code of the retrieved access token |
| verified_date | Date | The date that the access token was verified |
udf_string_1 | String | User Defined Field of type String |
udf_string_2 | String | User Defined Field of type String |
udf_string_3 | String | User Defined Field of type String |
udf_string_4 | String | User Defined Field of type String |
udf_string_5 | String | User Defined Field of type String |
udf_string_6 | String | User Defined Field of type String |
udf_string_7 | String | User Defined Field of type String |
udf_string_8 | String | User Defined Field of type String |
udf_float_1 | Float | User Defined Field of type Float |
udf_float_2 | Float | User Defined Field of type Float |
udf_float_3 | Float | User Defined Field of type Float |
udf_float_4 | Float | User Defined Field of type Float |
udf_date_1 | Date | User Defined Field of type Date |
udf_date_2 | Date | User Defined Field of type Date |
udf_date_3 | Date | User Defined Field of type Date |
udf_date_4 | Date | User Defined Field of type Date |
| verified_by_user | User Object | The user that verified the access token |
| rewards_participant | Rewards Participant Object | The rewards participant associated with the access token |
| accounts_receivable | Accounts Receivable Object | The accounts receivable associated with the access token |
| classification | Access Token Classification Object | The classification of the access token |
Log Information Object | The log information related with the retrieved access token |
Referred Objects Response Data
Examples
HTTP Method: POST
Request:
Body:
{
"token":"B394F93D967845AFBC884420592EAA0B",
"access_token_identifier":{"authentication_code":"7"},
"verification_code":"273562"
}
Response:
{
"status":
{
"message": "",
"description": "",
"code": "OK"
},
"data":
{
"log_information":
{
"updated_date": "2015-11-27T16:08:56",
"created_date": "2015-11-26T19:26:43",
"created_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"updated_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
},
"updated_by_user":
{
"person_name": "Marios Lannister",
"username": "MPAdministrator",
"id": "1"
}
},
"verification_code": "273562",
"reward_participant": null,
"authentication_code": "7",
"accounts_receivable":
{
"account_owner":
{
"last_name": "Papapavlou",
"middle_name": null,
"life_cycle_state": "FINANCIAL",
"company_profile": null,
"title": "Miss",
"first_name": "Loukia",
"type": "PERSON",
"id": "37072CF6ED884737B6592A7CBB6D5342",
"name": "Papapavlou Loukia",
"company_name": null,
"demographics":
{
"gender": "FEMALE",
"passport_issued_by_country": null,
"social_security_number": null,
"passport_number": null,
"industry_sector": null,
"country_of_residence":
{
"three_character_code": "CYP",
"two_character_code": "CY",
"id": "181",
"name": "CYPRUS",
"alternative_code": null
},
"name_day":
{
"month": null,
"day": null
},
"date_of_birth":
{
"month": null,
"day": null,
"year": null
},
"id_number": "LP1234",
"industry": null,
"id_issued_by_country": null
}
},
"life_cycle_state": "ACTIVE",
"number": "ACR000852",
"id": "A86D415E729945C6933177D83319FBE6",
"name": "ACR000852"
},
"verified_date": "Fri Nov 27 16:08:55 EET 2015",
"life_cycle_state": "EFFECTIVE",
"identifier": "lpapap@gmail.com",
"number": "ACT0000000177",
"id": "E8D62A98078A44F79646E4CB4C7DAB19",
"verified_by_user":
{
"person_name": "Marios Lannister",
"username": "MPAdministrator",
"id": "1"
}
}
}