Account
This web service provides methods that allow you to open, manage and report upon accounts and their sub-accounts
The following operations are supported. For a formal definition, please review the Service Description.
-
GetBalance
Returns an account balance.Parameter
Notes
Username: Password: AnyTimeBalance: Provide a decimal data type output parameter. This will be populated with the account's current any time balance. OffPeakBalance: Provide a decimal data type output parameter. This will be populated with the account's current off peak balance. ResultText: E.g. Account balance for your.address@your.company. Code: -
ListSubAccount
Lists a users sub-accounts.Parameter
Notes
Username: Password: ReportCSV: Provide a string data type output parameter. This will be populated with a CSV standard format string of records containing information about all of the account’s sub-accounts. ResultText: E.g. Account your.address@your.company has 2 sub accounts. Code: -
Modify
Modifies an accounts details.Parameter
Notes
Username: Password: NewUsername: Modified user name. This should be a valid email address. If you do not wish to modify this parameter set it to null. NewPassword: Modified password. This must be at least 6 or more alphanumeric characters long and contain at least one digit, one upper case and one lower case character. FirstName: Modified first name. If you do not wish to modify this parameter set it to null. LastName: Modified second name. If you do not wish to modify this parameter set it to null. MobilePhone: Modified mobile device number. If you do not wish to modify this parameter set it to null. Phone: Modified phone number. If you do not wish to modify this parameter set it to null. Company: Modified company name. If you do not wish to modify this parameter set it to null. ResultText: E.g. Account for your.address@your.company was successfully updated. Code: -
Open
Opens a new account. If you supply values for the ParentUsername and ParentPassword parameter you will create a sub-account.Parameter
Notes
ParentUsername: This should only be populated if you are creating a sub-account. ParentPassword: This should only be populated if you are creating a sub-account. Username: Provide a valid email address for the account holder. Password: This must be at least 6 or more alphanumeric characters long and contain at least one digit, one upper case and one lower case character. FirstName: The account holder's first name. LastName: The account holder's second name. MobilePhone: Provide a valid mobile device number for the account holder. Company: The account holder's company name. Phone: Provide a valid phone number for the account holder. ResultText: E.g. Account for main.account@company.com was created successfully. Code: -
SubAccountGiveCredit
Transfers credits to a sub-account.Parameter
Notes
Username: Password: SubAccount: Provide the user name of the sub-account you wish to transfer credits to. AnyTimeBalance: Provide a decimal value that represents the number of any time credits you wish to transfer to the sub-account. e.g. 10, -10. A negative balance indicates the transfer of credits back to the parent account from the sub-account. OffPeakBalance: Provide a decimal value that represents the number of off peak credits you wish to transfer to the sub-account. e.g. 10, -10. A negative balance indicates the transfer of credits back to the parent account from the sub-account. ParentAnyTimeBalance: Provide a decimal output parameter. This will be populated with the current any time balance on the parent account. ParentOffPeakBalance: Provide a decimal output parameter. This will be populated with the current off peak balance on the parent account. SubAnyTimeBalance: Provide a decimal output parameter. This will be populated with the number of any time credits on the selected sub-account. SubOffPeakBalance: Provide a decimal output parameter. This will be populated with the number of off peak credits on the selected sub-account. ResultText: E.g. Credits successfully exchanged between your.address@your.company (master account) and sub.account@company.com (sub account). Code: -
Validate
Validates an account using the validation codes sent after registering.Parameter
Notes
Username: Password: ValidationCode: This is the code sent to you in two sections after you first create an account. The first is sent by email and the second by text message. Simply join the two sections together and enter them into this parameter. ResultText: E.g. Account for your.address@your.company has been validated. Code: -
Verify
Verifies that an account exists.Parameter
Notes
Username: Password: ResultText: E.g. The account for your.address@your.company was successfully verified. Code: