Previous Topic: Fetching User Details Using AccountsNext Topic: Setting the Personal Assurance Message


Deleting User Accounts

You must use the deleteUserAccount operation to delete accounts for users. This section walks you through the following steps for deleting user accounts:

Preparing the Request Message

The following table lists the elements of the deleteUserAccountRequest message.

Element

Mandatory

Description

accountType

Yes

The attribute that qualifies the account ID and provides additional context about the usage of the account ID.

clientTxId

No

The unique transaction identifier that your calling application can include. This identifier helps in tracking the related transactions.

Invoking the Web Service

To delete user accounts:

  1. (Optional) Include the authentication and authorization details in the header of the deleteUserAccount operation. See "Managing Web Services Security" for more information on the header elements.
  2. Use the deleteUserAccountRequest elements to collect the user details, as listed in the table.
  3. Use the deleteUserAccountRequest message and construct the input message by using the details specified in the preceding step.
  4. Invoke the deleteUserAccount operation of the ArcorUserRegistrySvc service to delete accounts for the user.

    This operation returns the deleteUserAccountResponse message that includes the transaction identifier, authentication token, and user account details. See the following section for more information on the response message.

Interpreting the Response Message

The response message, deleteUserAccountResponse, returns the transaction identifier and the authentication token in the SOAP envelope header. These elements are explained in the following table. The SOAP body returns a success message if the operation was performed successfully. If there are any errors, then the Fault response is returned. See appendix, "Exceptions and Error Codes" for more information on the SOAP error messages.

Element

Description

udsTransactionID

The unique identifier of the transaction performed by using UDS.

authToken

The authentication token that is returned if the credential verification to access the Web service was successful. This token eliminates the need for you to present the authentication credential for successive access to the Web service.

By default, the authentication token is valid for one day, after which you need to authenticate again.