CreateAccount

Creates the Account and Contact for this account.
It also by default sets the BillTo and SoldTo to the accounts contact.

Authentication Methods


  1. With a username and password
  2. Using Kerberos
  3. With AMS username and password
Input Parameter Type Description
BillCycleDay Integer Represents the billing cycle day (BCD) for the account, and when billing runs generate invoices for this account. Usually set based to the same day the account was created to avoid any proration charges on first invoice. Set the value to 31 to indicate "end of month."

Set the value to 0 to set the value to use the auto-set functionality. This allows the account BCD to be set to the same day as the triggering date of the first recurring charge on the account. This only applies to recurring charges, and not to one-time or usage charges. See Customer Accounts: Bill Cycle Day for more information.

Allowable Values: Any of the system-defined bill cycle days (1–30) that have been activated within Z-Billing administration. Specify 0 to set the billing cycle day to Auto-set. Specify 31 to set it to end of month.

Once the BillCycleDay has been set manually, it can not go back to AutoSet and you must enter a day between 1 -> 30
Country String Country name
State see description Required if Country is 'United States' or 'Canada'. Click here for list
RedirectURL URL Optional RedirectURL that is filled in for the Gateway(MPM) link

*=required

Notes

Currency cannot be changed once the account has been created.
If it is needed to change the currency, follow the information on the Zuora Knowledge base.

http://knowledgecenter.zuora.com/kb/How_do_I_change_the_currency_in_a_customer_account%3F?highlight=change+currency

CURL EXAMPLE
curl -v ' https://secure.nomadesk.com/nomadesk-billing/Api/?Task=CreateAccount&Firstname=John&Lastname=Smith&country=Belgium&Currency=USD&Token=qa3d0fn1sio5ejlsbklut9k4c3&billcycleday=10'
RESPONSE
<Response>
<Header>
    <Status>1</Status>
    <Message></Message>
    <CreationDstamp>1328627318</CreationDstamp>
</Header>
<Body>
    <PaymentGatewayURL>
        https://nomadesk.stagestore.zuora.com/ManagePaymentMethod.aspx?Token=hx2gpPusBrhERsQLx%2F%2BUG%2BwprnNRmlqcv6uBqsgH%2FpHEzOCiWKZwX3ncjSaJT6Xu7jiecp6MDeebcSrJX9MY3%2BrQkAHF%2FMOQVd4P4WEzIQpsegbBxroAustpGx2MqBwwOEeZtwxF%2BssjK1b6GdfR4g%3D%3D&RedirectFrame=parent
    </PaymentGatewayURL>
</Body>
</Response>