GetBalance


Definition

Get account balances.

Usage

Use this command to return the current balance on an account.

Availability

All resellers have access to this command.

Implementation on eNom.com

Log on to resellertest.enom.com with Login ID resellid, password resellpw.

https://resellertest.enom.com/resellers/SubAccount.asp

The Access link calls the GetBalance command.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.

Input parameters

Build the query string using this syntax:

https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid&pw=yourpassword
&paramname=paramvalue&nextparamname=nextparamvalue

 

Parameter Status Description Max Size
UID Required Account login ID 20
PW Required Account password 20
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
Reseller Returns 1 if this is a reseller account, 0 otherwise
Balance Current account balance
AvailableBalance Current available balance
Price Default price for names
COMPrice Price for .com
NETPrice Price for .net
ORGPrice Price for .org
CCPrice Price for .cc
TVPrice Price for .tv
DomainCount Current count of domains in the account
Command Name of command executed
ErrCount The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrX Error messages explaining the failure. These can be presented as is back to the client.
Done True indicates this entire response has reached you successfully.

 

Notes

  • The default response format is plain text. To receive the response in HTML or XML format, sendResponseType=HTML or ResponseType=XML in your request.
  • Check the return parameter ErrCount. If greater than 0 the transaction failed. The parameter Err(ErrCount) can be presented to the client. Otherwise process the returned parameters as defined above.
  • This command only returns the price for original purchase of domains, not tranfers or renewals. For acomplete list of prices, use PE_GetRetailPricing or PE_GetResellerPrice.

Example