RefillAccount


Definition

Add funds to your account using a credit card.

Usage

To add funds to your account, set parameter Debit=True and include the credit card parameters.

To remove your credit card information from our database, set parameter Debit=True and omit the credit card parameters.

To retrieve your account balance without adding funds, and to retrieve the current credit card information for the account, set parameter Debit=False.

When you pass credit card information with this command, you must use the secure HTTPS protocol.

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/myaccount/RefillAccount.asp

At the bottom of the Credit Card section, the submit button calls the RefillAccount command.

Constraints

The query must meet the following requirements:

  • The login ID and password must be valid.
  • The account must be a reseller account.

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
Debit Required Debit the credit card; options are True or False. Debit=True uses the credit card in this query string for this transaction, and replaces the credit card information for the account record with the values in this query string. Debit=False retrieves your account balance without changing it, and without charging your credit card; it also retrieves the current credit card information for the account. When you pass credit card information with this command, you must use the secure HTTPS protocol. 1
EndUserIP Required to add funds to this account End user’s IP address. This is used in fraud checking, as part of our order processing service. Use format NNN.NNN.NNN.NNN. 15
CCAmount Required to add funds to this account Amount to charge to credit card, in DD.cc format. We charge a 3% convenience fee which is deducted immediately from the CCAmount. Min $100 ?
CCType Required to add funds to this account Credit card type. Options are AmEx, Discover, MasterCard, Visa. 10
CCName Required to add funds to this account Credit card holder’s name as imprinted on the credit card 60
CCNumber Required to add funds to this account 16-digit credit card number 16
CCMonth Required to add funds to this account Month in which credit card expires, in MM format 2
CCYear Required to add funds to this account Year in which credit card expires, in YYYY format 4
CVV2 Required to add funds to this account Credit card security verification code, 3- or 4- digit number from the back of the credit card 4
CCAddress Required to add funds to this account Optional Street address as shown on credit card bill 60
CCCity Required to add funds to this account Optional City as shown on credit card bill 60
CCStateProvince Required to add funds to this account State or province as shown on credit card bill 60
CCZip Required to add funds to this account Zip code or postal code as shown on credit card bill 16
CCCountry Required to add funds to this account Country of credit card billing address, expressed as 2-character country code 2
CCPhone Required to add funds to this account Phone number as shown on credit card bill. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URL-encoded as a plus sign (%2B). 20
SendMail Optional; default is 1 Send email confirmation to the billing contact for this account. 0 or No turns off the email; any other value or omitting this parameter sends the email. 2
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
Reseller 1 indicates that this is a reseller account
CCTRANSRESULT Result of the credit card transaction
ResellerRefill Success status of the account refill
CreditCardStatus Success status of the credit card transaction
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, send ResponseType=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.

Example