Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
ActiveModel backed Zuora integration
branch: master
Failed to load latest commit information.
gemfiles Remove and Ignore gemfile locks
lib fixing make_client to use savon 2.0 config
spec Fix up integration specs
wsdl Update dependencies - inspired by and heavily lifted from @mdemin914
.gitignore Update license and added CONTRIBUTING
.rspec Refactored Soap in Z:O:Base to use a connector which can be replaced …
.travis.yml Add jruby to the rvm block so it is considered in the build script
Appraisals Test against different versions of active_support and active_model us…
CONTRIBUTING.md
Gemfile Fix up integration specs
Guardfile Refactored Soap in Z:O:Base to use a connector which can be replaced …
LICENSE Update license and added CONTRIBUTING
README.md Update README.md
Rakefile Test against different versions of active_support and active_model us…
zuora.gemspec fixing make_client to use savon 2.0 config

README.md

Zuora Build Status Gemnasium

This library allows you to interact with Zuora billing platform directly using familiar ActiveModel based objects.

Requirements

All additional requirements for development should be referenced in the provided zuora.gemspec and Gemfile.

Installation

git clone git@github.com:zuorasc/zuora.git

Getting Started

$ bundle install
$ bundle exec irb -rzuora
  Zuora.configure(:username => 'USER', :password => 'PASS', sandbox: true, logger: true)

  account = Zuora::Objects::Account.new
   => #<Zuora::Objects::Account:0x00000002cd25b0 @changed_attributes={"auto_pay"=>nil, "currency"=>nil, 
  "batch"=>nil, "bill_cycle_day"=>nil, "status"=>nil, "payment_term"=>nil}, @auto_pay=false, @currency="USD",
  @batch="Batch1", @bill_cycle_day=1, @status="Draft", @payment_term="Due Upon Receipt">

  account.name = "Test"
   => "Test"

  account.create
   => true

  created_account = Zuora::Objects::Account.find(account.id)
   => #<Zuora::Objects::Account:0x00000003caafc8 @changed_attributes={}, @auto_pay=false, @currency="USD", 
  @batch="Batch1", @bill_cycle_day=1, @status="Draft", @payment_term="Due Upon Receipt", 
  @id="2c92c0f83c1de760013c449bc26e555b", @account_number="A00000008", @allow_invoice_edit=false, 
  @balance=#<BigDecimal:3c895f8,'0.0',9(18)>, @bcd_setting_option="ManualSet", 
  @created_by_id="2c92c0f83b02a9dc013b0a7e26a03d00", @created_date=Wed, 16 Jan 2013 10:25:24 -0800, 
  @invoice_delivery_prefs_email=false, @invoice_delivery_prefs_print=false, @name="Test", 
  @updated_by_id="2c92c0f83b02a9dc013b0a7e26a03d00", @updated_date=Wed, 16 Jan 2013 10:25:24 -0800>

Test Suite

This library comes with a full test suite, which can be ran using the standard rake utility.

  $ rake spec

Live Integration Suite

There is also a live suite which you can test against your sandbox account. This can by ran by setting up your credentials and running the integration suite.

Do not run this suite using your production credentials. Doing so may destroy data although every precaution has been made to avoid any destructive behavior.

  $ ZUORA_USER=login ZUORA_PASS=password rake spec:integrations

Support & Maintenance

This library currently supports Zuora's SOAP API version 38.

If you would like to test out the EXPERIMENTAL API version 51 support, see the a51 branch and please file bugs and pull requests against it.

Contributors

Credits

  • Wildfire Ineractive for facilitating the development and maintenance of the project.
  • Zuora for providing us with the opportunity to share this library with the community.

Legal Notice

  Copyright (c) 2013 Zuora, Inc.

  Permission is hereby granted, free of charge, to any person obtaining a copy of 
  this software and associated documentation files (the "Software"), to use copy, 
  modify, merge, publish the Software and to distribute, and sublicense copies of 
  the Software, provided no fee is charged for the Software.  In addition the
  rights specified above are conditioned upon the following:

  The above copyright notice and this permission notice shall be included in all
  copies or substantial portions of the Software.

  Zuora, Inc. or any other trademarks of Zuora, Inc.  may not be used to endorse
  or promote products derived from this Software without specific prior written
  permission from Zuora, Inc.

  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  ZUORA, INC. BE LIABLE FOR ANY DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES
  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
  ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.  

  IN THE EVENT YOU ARE AN EXISTING ZUORA CUSTOMER, USE OF THIS SOFTWARE IS GOVERNED
  BY THIS AGREEMENT AND NOT YOUR MASTER SUBSCRIPTION AGREEMENT WITH ZUORA.
Something went wrong with that request. Please try again.