Archive
SWS VerifyEcommLogin Method
This allows you to verify the login credentials for a customer. A valid return means that the credentials match a profile and returns the profile information. If it doesn’t match, you will receive an error.
Parameters
Name | DataType | Is Required |
---|---|---|
EmailAddress | String | Required |
Description | The email address of the contact. This acts as their username in eStore/eCommerce. | |
OrgID | Long | Required |
Description | The organization’s ID number. | |
Password | String | Required |
Description | The password/eCommerce code of the contact. |
Returned Parameters
Name | DataType |
---|---|
ACTIVE | String |
Description | Indicates if the eStore/eCommerce account is active (“Y”) or not (“N”). |
ECOMM_ID | Long |
Description | The eCommerce ID number for the contacts online access. |
ORG_ID | Long |
Description | The organization’s ID number. |
PASSWORD | String |
Description | No longer returned. |
USER_NAME | String |
Description | The rental contact’s email address. |
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We will assume you have a web reference, let us name it SWS, in your Visual Studio project. At this point we need to define our objects. We will need the standard service object, a Password request object, and a VerifyEcommLogin response object. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.Password_Request request = new SWS.Password_Request();
SWS.VerifyEcommLogin_Response response;
Here is a sample code of the request object:
// VerifyEcommLogin Request
request.OrgID = 123456;
request.EmailAddress = "j.doe@b.c";
request.Password = "TestPass";
Finally we can call the method and pass across the login object and the request object to retrieve our requested information. It’s a good idea to do this in a Try Catch block.
// Call the method that will load the response object
try
{
response = service.VerifyEcommLogin(user_request, request);
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
Note that if something goes wrong the service will respond with an exception. You will want to capture the message in the exception so it can be debugged.
For a full list of methods see SWS Methods.