maxio-advanced-billing-sdk 1.0.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56965407fbc91505e38726fbc62e7c8179afbcf71e51fb1993386ce182c45fe4
-  data.tar.gz: 72fbecf77997471c4b644c71a2dbf661fadd897a5acbce5602036a79c56187e2
+  metadata.gz: 56ad6bf7a546dec06d225320086160fc7268eabaa8494758580cb136cd957526
+  data.tar.gz: 5c251518ad00a555d27146b7c2f317ac169474ecf303e4de1216b44e84189f4d
 SHA512:
-  metadata.gz: b3a9b49bc84316ee76362c2fd2d07e12300b14fb8cd39250cca01aed6c118bea1d2d6fe7923a0234ab353aa525b3e6f96495bd4f76d4493dec82f623b6a12062
-  data.tar.gz: b0a0199d82d5ca95f05182546c3b123d81acdc2389d4b59bcbf518495d0808b75cb04864851d87961b38bbd1ff7198c866c4c0b0efef4ef26bc4a04395fb3342
+  metadata.gz: 348d9a2c09c3f1557ce3340cd3623765e50da283354f322fa0cfd55d4f898f53cc54983a3b15d64e44bf54b39b5bcc3d78b457b07846c8ce68f6d501f8f56f22
+  data.tar.gz: 412763f3a4e11e72088bbca0fcd1fb6377fee9b5b1b35eb8cddaeb0a7126be72b656efa206211648d785a8a471f2d7bd46d6b4121e0fce9c0edb87d5e0710f36

data/README.md

@@ -3,288 +3,47 @@
 
 ## Introduction
 
-### Introduction
+Maxio Advanced Billing (formerly Chargify) provides an HTTP-based API that conforms to the principles of REST.
+One of the many reasons to use Advanced Billing is the immense feature set and surrounding community [client libraries](page:development-tools/client-libraries).
+The Maxio API returns JSON responses as the primary and recommended format, but XML is also provided as a backwards compatible option for Merchants who require it.
 
-#### API Integration
+### Steps to make your first Maxio Advanced Billing API call
 
-Maxio Advanced Billing (formerly Chargify API) can be integrated with many environments and programming languages via our REST API. Some of our users have contributed their API wrappers in various programming languages. Check out the [API Code Overview](https://developers.chargify.com/docs/developer-docs/ZG9jOjE0NjAzNDI2-api-code-samples) doc for an introduction to the wrappers and available code samples.
+1. [Sign-up](https://app.chargify.com/signup/maxio-billing-sandbox) or [log-in](https://app.chargify.com/login.html) to your [test site](https://maxio-chargify.zendesk.com/hc/en-us/articles/5405553861773-Testing-Intro) account.
+2. [Setup and configure authentication](https://maxio-chargify.zendesk.com/hc/en-us/articles/5405281550477-API-Keys#api) credentials.
+3. Submit your API request and try it out.
+4. Verify results through response.
+5. Test our integrations.
 
-#### Testing Guide
+We strongly suggest exploring the developer portal, our [integrations](https://www.maxio.com/integrations) and the API guide, as well as the entire set of application-based documentation to aid in your discovery of the product.
 
-Maxio Advanced Billing has compiled a [testing guide](https://chargify.zendesk.com/hc/en-us/articles/4407904658587) that covers a list of important factors to consider while in the testing phase. Here's a high-level overiew of what's covered in our testing guide:
+#### Example
 
-+ Test credit card basics
-+ Test site limits
-+ Live mode versus test mode
-
-We strongly suggest reading over the testing guide, as well as the entire set of application-based documentation to aid in your discovery of the product.
-
-#### Engage Support
-
-We always enjoy (and appreciate) hearing about larger integrations ahead of time. If you’re planning on importing a large amount of data into Maxio via our API, we suggest sending a “heads up” to “support@chargify.com” so we can coordinate with you to ensure your import process goes smoothly.
-
-Our API, while considered stable, is continually being improved and polished. Please feel free to contact support if you experience issues when integrating with the Maxio Advanced Billing API.
-
-If you have any additional questions regarding our documentation please don't hesitate in reaching out.
-
-#### Support Access
-
-Access to our Technical Specialist team for API support is currently limited to purchasers of our larger Maxio support plans.
-
-But don’t worry! There are quite a few options to help you get the answers you need:
-
-- [Read our documentation for developers](https://developers.chargify.com/docs/developer-docs/ZG9jOjM0NjA3MQ-overview)
-- Explore the endpoints of our API Documentation
-- [Watch our videos and tutorials](https://chargify.com/tutorials)
-- [Check out the Chargify tag on Stack Overflow](http://stackoverflow.com/questions/tagged/chargify)
-
-### API Overview
-
-The Chargify API allows you to interact with our system programmatically from your own application. Using the API you interact with Resources such as:
-
-- Products
-- Subscriptions
-- Customers
-- etc.
-
-The API attempts to conform to the [RESTful](http://en.wikipedia.org/wiki/Representational_State_Transfer) design principles.
-You interact with the resources exposed via the API by accessing resource collection and element URIs using the HTTP verbs (GET, POST, PUT, and DELETE).
-Chargify accepts and returns both JSON and XML data via the API.
-
-You’ll likely need access to a web developer or programmer (if you’re not one) to get the most use out of the API.
-
-#### Available Formats: JSON and XML
-
-JSON is the primary and recommended format for use with the Chargify API.  XML is also provided as a backwards compatible option for Merchants who require it.
-
-#### Authentication
-
-Authentication is implemented as HTTP Basic Authentication over TLS >= 1.2 (HTTPS), as described in [API Authentication](https://developers.chargify.com/docs/developer-docs/ZG9jOjE1NTUxNQ-authentication)
-
-#### URL
-
-The URL for API requests includes the subdomain of the Site you are working with:
-
-`https://<subdomain>.chargify.com/<resource URI>`
-
-#### Response Data
-
-Response data is sent as either XML or JSON, depending on the type of data requested (`HTTP Content-Type` header) or the type specified as being accepted (HTTP `Accept` header).
-
-GETs for individual statements & invoices may also be requested as PDF using `application/pdf` or appending `.pdf` to the resource URI.
-
-Response codes are sent via the normal HTTP Response Code, and are documented separately for each resource.
-
-For boolean fields, please note that a value of `null` may be considered as false. However, this is not true across all cases. Please excercise good judgement here, or contact support with any questions.
-
-For example:
-
-+ `null` can define that there's no data available for that attribute
-
-#### Pagination
-
-When an endpoint returns a list of items, it will be paginated.  Usually, 20 items will be returned by default, and you may request up to a maximum of 200 at a time.  Pagination is done with query string parameters, for example: `?page=5&per_page=200`
-
-#### Response Time Zones
-
-API responses from Chargify are sent with the timezone of current Chargify site.
-
-Alternately, webhooks sent from Chargify globally utilize EST as the timezone for all content in the body of the payload.
-
-#### Request Data
-
-POST and PUT request data may be formatted as either XML (`application/xml`) or JSON (`application/json`). For best results, you should set your HTTP `Content-Type` request header accordingly, although you may also specify your format by appending `.xml` or `.json` extensions on to the resource URI.
-
-Note that Chargify does not accept PUT or POST data sent as query params or form encoded data – data must be sent as either XML or JSON. If you fail to set your `Content-Type` to either `application/xml` or `application/json`, your request may fail due to triggering of forgery protection mechanisms.
-
-##### About Decimal Numbers
-
-In order to prevent losing precision, we serialize decimal numbers as strings instead of as JSON numbers.
-
-We recommend parsing these strings into their decimal equivalent using a decimal number library in your programming language (i.e. `BigDecimal` in Ruby) instead of relying on floating point values or arithmetic.
-
-##### About Amount Fields
-
-Fields holding amount values are given as a string representing a decimal whole currency amount.
-
-For example, `"1.23"` in currency `"USD"` would equate to `$1.23`.
-
-Not all fields will be rounded to the smallest currency denomination.  Intermediate results, such as those that derive from line-level tax calculations, may hold precision up to 8 decimal places.  However, the top-level totals we provide (e.g. `total_amount`) will be rounded to the smallest currency denomination.
-
-It is up to API consumers to parse the string into a decimal number representation and do any rounding necessary for your application.
-
-#### Debugging
-
-If you’re having difficulty executing a request via our API, try the simplest thing and attempt your request via the curl command-line tool, as shown in the below example. Add the `--verbose` flag to your request to receive even more debugging information.
-
-Another handy tool is [Beeceptor](https://beeceptor.com/). You can use this to intercept your request to see exactly what is being sent.
-
-If you are unable to connect at all, check that you are using TLS 1.2 or better.
-
-If you see a "Could not resolve host" error, double check that the url is correct, including your subdomain. For example: `mysite.chargify.com`.  This error means your DNS server could not find an IP address for the domain you are trying to connect to.
-
-#### Backwards Compatibility
-
-We consider the following changes to be backwards compatible and may make them without advance notice:
-
-+ Adding new API endpoints, or adding new attributes in the responses of existing endpoints
-+ Adding new optional parameters to be sent to existing API endpoints
-+ Adding new fields to exported data
-+ Changing the type or length of any of the ID attributes
-  + For example, most IDs are currently integers, but you should not assume that this will always be the case.
-
-In addition, you should not depend on the order of attributes within the API response as this may change.
-
-Chargify does not provide notifications for additions that are clearly defined as backwards compatible.
-
-#### Examples
-
-The following examples use the curl command-line tool to execute API requests.
-
-##### Subscription Listing
+The following example uses the curl command-line tool to execute API requests.
 
 **Request**
 
 curl -u <api_key>:x -H Accept:application/json -H Content-Type:application/json https://acme.chargify.com/subscriptions.json
 
-### API Access Limitations
-
-There are a few scenarios that may end up in causing an API request to be blocked even with correct credentials.
-**Please note:** All relevant API requests will be blocked if any of the below conditions are true. These limitations also apply to [Chargify Direct](https://developers.chargify.com/docs/developer-docs/ZG9jOjE0NjAzNDE3-introduction).
-
-Those scenarios are as follows:
-
-- Your Chargify subscription is canceled.
-- Your Chargify trial has reached an end.
-- The site you're making a request for is in the process of ["clearing site data"](https://maxio-chargify.zendesk.com/hc/en-us/articles/5405428327309)
-  - _Note: any API request for another site that is in a good state will NOT be blocked_
-- The site you're making a request for has been deleted.
-  - _Note: any API request for another site that is in a good state will NOT be blocked_
-
-Read more about your Chargify subscription [here](https://maxio-chargify.zendesk.com/hc/en-us/articles/5405430043149-Advanced-Billing-Subscription#advanced-billing-subscription-0-0)
-
-#### What happens when an API request is blocked
-
-The request will fail with a `422` http status code. The response will also include a message explaining the reason for the request being blocked. For example:
-
-- If your Chargify subscription is canceled:
-
-```json
-{
-  "errors" => [
-    [0] "Your Chargify account has been canceled. Please contact support@chargify.com to reactivate."
-  ]
-}
-```
-
-- If your Chargify trial has reached and end and you attempted to make an API request, the response body will look like:
-
-```json
-{
-  "errors" => [
-    [0] "Your trial has ended, please contact sales."
-  ]
-}
-```
-
-- If the site you're making a request for is in the process of ["clearing site data"](https://maxio-chargify.zendesk.com/hc/en-us/articles/5405428327309):
-
-```json
-{
-  "errors" => [
-    [0] "Site data clearing is in progress. Please try later."
-  ]
-}
-```
-
-- If the site you're making a request for has been deleted:
-
-```json
-{
-  "errors" => [
-    [0] "This site has been deleted."
-  ]
-}
-```
-
-### Secure Applications
-
-Please note that it is NOT possible to make API requests directly from the customer's browser or device.  Doing so would expose your API key on the client side, and anyone who has that key has full access to all of your Chargify data.
-
-Instead you will need to take care to tokenize sensitive information by using [Chargify.js](https://developers.chargify.com/docs/developer-docs/ZG9jOjE0NjAzNDI0-overview) or a similar JavaScript library provided by your gateway, and then post the token and other information to your own server, from which you can make the API call to Chargify.
-
-#### Troubleshooting
-
-If you attempt to make a Chargify API request directly from the customer's browser, you may see an error such as:
-
-```
-Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource.
-```
-
-or
-
-```
-Origin 'https://example.com' is therefore not allowed access.` `The response had HTTP status code 404.
-```
-
-This is an error message indicating that Cross-Origin Resource Sharing (CORS) is not enabled on the Chargify server.
-
-### Relationship Invoicing
-
-#### API Compatibility for Relationship Invoicing
-
-This section describes the API for the new, [Relationship Invoicing](https://maxio-chargify.zendesk.com/hc/en-us/articles/5405078794253) style of invoices introduced in January 2018.
-
-If you are an existing customer from prior to January 2018 or have not otherwise explicitly opted into this new style of invoices, you are probably looking for the legacy "Invoices" section that describes [invoice-billing legacy-style invoices](./b3A6MTQxMDgzNjQ-read-invoice).
-
-These new invoices provide a single representation of all of your Chargify billing, whether you collect automatically or via remittance.
-
-#### About Decimal Numbers
-
-In order to prevent losing precision, we serialize decimal numbers as strings instead of as JSON numbers.
-
-We recommend parsing these strings into their decimal equivalent using a decimal number library in your programming language (i.e. `BigDecimal` in Ruby) instead of relying on floating point values or arithmetic.
-
-#### About Amount Fields
-
-Fields holding amount values are given as a string representing a decimal whole currency amount.
-
-For example, `"1.23"` in currency `"USD"` would equate to `$1.23`.
-
-Not all fields will be rounded to the smallest currency denomination. Intermediate results, such as those that derive from line-level tax calculations, may hold precision up to 8 decimal places.  However, the top-level totals we provide (e.g. `total_amount`) will be rounded to the smallest currency denomination.
-
-It is up to API consumers to parse the string into a decimal number representation and do any rounding necessary for your application.
-
-##### Relationship Invoicing Summary
-
-+ If your site **is** using relationship invoicing, you may only use the methods described in this section for working with invoices.
-
-+ If your site is **not** using relationship invoicing, please use the legacy invoice methods:
-  
-  + [Invoices](./b3A6MTQxMTA0MTA-read-invoice)
-  + [Invoices: Payments](./b3A6MTQxMTA0MTI-create-invoice-payment)
-  + [Invoices: Charges](./b3A6MTQxMTA0MTM-create-charge)
-  + [Invoices: Credits](./b3A6MTQxMTA0MTQ-create-invoice-credit)
-
 ## Install the Package
 
 Install the gem from the command line:
 
 ```ruby
-gem install maxio-advanced-billing-sdk -v 1.0.0
+gem install maxio-advanced-billing-sdk -v 2.0.0
 ```
 
 Or add the gem to your Gemfile and run `bundle`:
 
 ```ruby
-gem 'maxio-advanced-billing-sdk', '1.0.0'
+gem 'maxio-advanced-billing-sdk', '2.0.0'
 ```
 
-For additional gem details, see the [RubyGems page for the maxio-advanced-billing-sdk gem](https://rubygems.org/gems/maxio-advanced-billing-sdk/versions/1.0.0).
+For additional gem details, see the [RubyGems page for the maxio-advanced-billing-sdk gem](https://rubygems.org/gems/maxio-advanced-billing-sdk/versions/2.0.0).
 
 ## Initialize the API Client
 
-**_Note:_** Documentation for the client can be found [here.](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/client.md)
+**_Note:_** Documentation for the client can be found [here.](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/client.md)
 
 The following parameters are configurable for the API Client:
 
@@ -292,7 +51,7 @@ The following parameters are configurable for the API Client:
 |  --- | --- | --- |
 | `subdomain` | `String` | The subdomain for your Chargify site.<br>*Default*: `'subdomain'` |
 | `domain` | `String` | The Chargify server domain.<br>*Default*: `'chargify.com'` |
-| `environment` | Environment | The API environment. <br> **Default: `Environment.PRODUCTION`** |
+| `environment` | `Environment` | The API environment. <br> **Default: `Environment.PRODUCTION`** |
 | `connection` | `Faraday::Connection` | The Faraday connection object passed by the SDK user for making requests |
 | `adapter` | `Faraday::Adapter` | The Faraday adapter object passed by the SDK user for performing http requests |
 | `timeout` | `Float` | The value to use for connection timeout. <br> **Default: 30** |
@@ -302,15 +61,16 @@ The following parameters are configurable for the API Client:
 | `retry_statuses` | `Array` | A list of HTTP statuses to retry. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |
 | `retry_methods` | `Array` | A list of HTTP methods to retry. <br> **Default: %i[get put]** |
 | `http_callback` | `HttpCallBack` | The Http CallBack allows defining callables for pre and post API calls. |
-| `basic_auth_user_name` | `String` | The username to use with basic authentication |
-| `basic_auth_password` | `String` | The password to use with basic authentication |
+| `basic_auth_credentials` | [`BasicAuthCredentials`](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/$a/https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/basic-authentication.md) | The credential object for Basic Authentication |
 
 The API client can be initialized as follows:
 
 ```ruby
 client = AdvancedBilling::Client.new(
-  basic_auth_user_name: 'BasicAuthUserName',
-  basic_auth_password: 'BasicAuthPassword',
+  basic_auth_credentials: BasicAuthCredentials.new(
+    username: 'BasicAuthUserName',
+    password: 'BasicAuthPassword'
+  ),
   environment: Environment::PRODUCTION,
   subdomain: 'subdomain',
   domain: 'chargify.com'
@@ -330,45 +90,47 @@ The SDK can be configured to use a different environment for making API calls. A
 
 ## Authorization
 
-This API uses `Basic Authentication`.
+This API uses the following authentication schemes.
+
+* [`BasicAuth (Basic Authentication)`](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/$a/https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/basic-authentication.md)
 
 ## List of APIs
 
-* [API Exports](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/api-exports.md)
-* [Advance Invoice](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/advance-invoice.md)
-* [Billing Portal](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/billing-portal.md)
-* [Custom Fields](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/custom-fields.md)
-* [Events-Based Billing Segments](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/events-based-billing-segments.md)
-* [Payment Profiles](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/payment-profiles.md)
-* [Product Families](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/product-families.md)
-* [Product Price Points](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/product-price-points.md)
-* [Proforma Invoices](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/proforma-invoices.md)
-* [Reason Codes](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/reason-codes.md)
-* [Referral Codes](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/referral-codes.md)
-* [Sales Commissions](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/sales-commissions.md)
-* [Subscription Components](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/subscription-components.md)
-* [Subscription Groups](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/subscription-groups.md)
-* [Subscription Group Invoice Account](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/subscription-group-invoice-account.md)
-* [Subscription Group Status](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/subscription-group-status.md)
-* [Subscription Invoice Account](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/subscription-invoice-account.md)
-* [Subscription Notes](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/subscription-notes.md)
-* [Subscription Products](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/subscription-products.md)
-* [Subscription Status](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/subscription-status.md)
-* [Coupons](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/coupons.md)
-* [Components](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/components.md)
-* [Customers](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/customers.md)
-* [Events](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/events.md)
-* [Insights](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/insights.md)
-* [Invoices](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/invoices.md)
-* [Offers](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/offers.md)
-* [Products](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/products.md)
-* [Sites](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/sites.md)
-* [Subscriptions](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/subscriptions.md)
-* [Webhooks](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/controllers/webhooks.md)
+* [API Exports](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/api-exports.md)
+* [Advance Invoice](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/advance-invoice.md)
+* [Billing Portal](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/billing-portal.md)
+* [Custom Fields](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/custom-fields.md)
+* [Events-Based Billing Segments](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/events-based-billing-segments.md)
+* [Payment Profiles](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/payment-profiles.md)
+* [Product Families](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/product-families.md)
+* [Product Price Points](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/product-price-points.md)
+* [Proforma Invoices](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/proforma-invoices.md)
+* [Reason Codes](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/reason-codes.md)
+* [Referral Codes](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/referral-codes.md)
+* [Sales Commissions](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/sales-commissions.md)
+* [Subscription Components](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/subscription-components.md)
+* [Subscription Groups](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/subscription-groups.md)
+* [Subscription Group Invoice Account](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/subscription-group-invoice-account.md)
+* [Subscription Group Status](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/subscription-group-status.md)
+* [Subscription Invoice Account](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/subscription-invoice-account.md)
+* [Subscription Notes](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/subscription-notes.md)
+* [Subscription Products](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/subscription-products.md)
+* [Subscription Status](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/subscription-status.md)
+* [Coupons](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/coupons.md)
+* [Components](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/components.md)
+* [Customers](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/customers.md)
+* [Events](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/events.md)
+* [Insights](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/insights.md)
+* [Invoices](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/invoices.md)
+* [Offers](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/offers.md)
+* [Products](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/products.md)
+* [Sites](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/sites.md)
+* [Subscriptions](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/subscriptions.md)
+* [Webhooks](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/controllers/webhooks.md)
 
 ## Classes Documentation
 
-* [Utility Classes](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/utility-classes.md)
-* [HttpResponse](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/http-response.md)
-* [HttpRequest](https://www.github.com/maxio-com/ab-ruby-sdk/tree/1.0.0/doc/http-request.md)
+* [Utility Classes](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/utility-classes.md)
+* [HttpResponse](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/http-response.md)
+* [HttpRequest](https://www.github.com/maxio-com/ab-ruby-sdk/tree/2.0.0/doc/http-request.md)
 

data/lib/advanced_billing/client.rb

@@ -6,6 +6,7 @@
 module AdvancedBilling
   #  advanced_billing client class.
   class Client
+    include CoreLibrary
     attr_reader :config, :auth_managers
 
     # Access to api_exports controller.
@@ -194,26 +195,25 @@ module AdvancedBilling
       @webhooks ||= WebhooksController.new @global_configuration
     end
 
-    def initialize(connection: nil, adapter: :net_http_persistent, timeout: 30,
-                   max_retries: 0, retry_interval: 1, backoff_factor: 2,
-                   retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
-                   retry_methods: %i[get put], http_callback: nil,
-                   environment: Environment::PRODUCTION, subdomain: 'subdomain',
-                   domain: 'chargify.com',
-                   basic_auth_user_name: 'TODO: Replace',
-                   basic_auth_password: 'TODO: Replace', config: nil)
+    def initialize(
+      connection: nil, adapter: :net_http_persistent, timeout: 30,
+      max_retries: 0, retry_interval: 1, backoff_factor: 2,
+      retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
+      retry_methods: %i[get put], http_callback: nil,
+      environment: Environment::PRODUCTION, subdomain: 'subdomain',
+      domain: 'chargify.com', basic_auth_credentials: nil, config: nil
+    )
       @config = if config.nil?
-                  Configuration.new(connection: connection, adapter: adapter,
-                                    timeout: timeout, max_retries: max_retries,
-                                    retry_interval: retry_interval,
-                                    backoff_factor: backoff_factor,
-                                    retry_statuses: retry_statuses,
-                                    retry_methods: retry_methods,
-                                    http_callback: http_callback,
-                                    environment: environment,
-                                    subdomain: subdomain, domain: domain,
-                                    basic_auth_user_name: basic_auth_user_name,
-                                    basic_auth_password: basic_auth_password)
+                  Configuration.new(
+                    connection: connection, adapter: adapter, timeout: timeout,
+                    max_retries: max_retries, retry_interval: retry_interval,
+                    backoff_factor: backoff_factor,
+                    retry_statuses: retry_statuses,
+                    retry_methods: retry_methods, http_callback: http_callback,
+                    environment: environment, subdomain: subdomain,
+                    domain: domain,
+                    basic_auth_credentials: basic_auth_credentials
+                  )
                 else
                   config
                 end
@@ -234,9 +234,8 @@ module AdvancedBilling
     def initialize_auth_managers(global_config)
       @auth_managers = {}
       http_client_config = global_config.client_configuration
-      ['global'].each { |auth| @auth_managers[auth] = nil }
-      @auth_managers['global'] = BasicAuth.new(http_client_config.basic_auth_user_name,
-                                               http_client_config.basic_auth_password)
+      %w[BasicAuth].each { |auth| @auth_managers[auth] = nil }
+      @auth_managers['BasicAuth'] = BasicAuth.new(http_client_config.basic_auth_credentials)
     end
   end
 end

data/lib/advanced_billing/configuration.rb

@@ -25,20 +25,20 @@ module AdvancedBilling
   # are configured in this class.
   class Configuration < CoreLibrary::HttpClientConfiguration
     # The attribute readers for properties.
-    attr_reader :environment, :subdomain, :domain, :basic_auth_user_name, :basic_auth_password
+    attr_reader :environment, :subdomain, :domain, :basic_auth_credentials
 
     class << self
       attr_reader :environments
     end
 
-    def initialize(connection: nil, adapter: :net_http_persistent, timeout: 30,
-                   max_retries: 0, retry_interval: 1, backoff_factor: 2,
-                   retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
-                   retry_methods: %i[get put], http_callback: nil,
-                   environment: Environment::PRODUCTION, subdomain: 'subdomain',
-                   domain: 'chargify.com',
-                   basic_auth_user_name: 'TODO: Replace',
-                   basic_auth_password: 'TODO: Replace')
+    def initialize(
+      connection: nil, adapter: :net_http_persistent, timeout: 30,
+      max_retries: 0, retry_interval: 1, backoff_factor: 2,
+      retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
+      retry_methods: %i[get put], http_callback: nil,
+      environment: Environment::PRODUCTION, subdomain: 'subdomain',
+      domain: 'chargify.com', basic_auth_credentials: nil
+    )
 
       super connection: connection, adapter: adapter, timeout: timeout,
             max_retries: max_retries, retry_interval: retry_interval,
@@ -54,11 +54,11 @@ module AdvancedBilling
       # The Chargify server domain.
       @domain = domain
 
-      # The username to use with basic authentication
-      @basic_auth_user_name = basic_auth_user_name
+      # The object holding Basic Authentication credentials
+      @basic_auth_credentials = basic_auth_credentials
 
-      # The password to use with basic authentication
-      @basic_auth_password = basic_auth_password
+      # Initializing Basic Authentication credentials with the provided auth parameters
+     @basic_auth_credentials = basic_auth_credentials
 
       # The Http Client to use for making requests.
       set_http_client CoreLibrary::FaradayClient.new(self)
@@ -68,7 +68,7 @@ module AdvancedBilling
                    max_retries: nil, retry_interval: nil, backoff_factor: nil,
                    retry_statuses: nil, retry_methods: nil, http_callback: nil,
                    environment: nil, subdomain: nil, domain: nil,
-                   basic_auth_user_name: nil, basic_auth_password: nil)
+                   basic_auth_credentials: nil)
       connection ||= self.connection
       adapter ||= self.adapter
       timeout ||= self.timeout
@@ -81,8 +81,7 @@ module AdvancedBilling
       environment ||= self.environment
       subdomain ||= self.subdomain
       domain ||= self.domain
-      basic_auth_user_name ||= self.basic_auth_user_name
-      basic_auth_password ||= self.basic_auth_password
+      basic_auth_credentials ||= basic_auth_credentials
 
       Configuration.new(connection: connection, adapter: adapter,
                         timeout: timeout, max_retries: max_retries,
@@ -92,10 +91,10 @@ module AdvancedBilling
                         retry_methods: retry_methods,
                         http_callback: http_callback, environment: environment,
                         subdomain: subdomain, domain: domain,
-                        basic_auth_user_name: basic_auth_user_name,
-                        basic_auth_password: basic_auth_password)
+                        basic_auth_credentials: basic_auth_credentials)
     end
 
+
     # All the environments the SDK can run in.
     ENVIRONMENTS = {
       Environment::PRODUCTION => {

data/lib/advanced_billing/controllers/advance_invoice_controller.rb

@@ -7,11 +7,10 @@ module AdvancedBilling
   # AdvanceInvoiceController
   class AdvanceInvoiceController < BaseController
     # Generate an invoice in advance for a subscription's next renewal date.
-    # [Please see our
-    # docs](reference/Chargify-API.v1.yaml/components/schemas/Invoice) for more
-    # information on advance invoices, including eligibility on generating one;
-    # for the most part, they function like any other invoice, except they are
-    # issued early and have special behavior upon being voided.
+    # [Please see our docs]($m/Invoice) for more information on advance
+    # invoices, including eligibility on generating one; for the most part, they
+    # function like any other invoice, except they are issued early and have
+    # special behavior upon being voided.
     # A subscription may only have one advance invoice per billing period.
     # Attempting to issue an advance invoice when one already exists will return
     # an error.
@@ -39,7 +38,7 @@ module AdvancedBilling
                    .body_param(new_parameter(body))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
-                   .auth(Single.new('global')))
+                   .auth(Single.new('BasicAuth')))
         .response(new_response_handler
                    .deserializer(APIHelper.method(:custom_type_deserializer))
                    .deserialize_into(Invoice.method(:from_hash))
@@ -68,7 +67,7 @@ module AdvancedBilling
                                     .is_required(true)
                                     .should_encode(true))
                    .header_param(new_parameter('application/json', key: 'accept'))
-                   .auth(Single.new('global')))
+                   .auth(Single.new('BasicAuth')))
         .response(new_response_handler
                    .deserializer(APIHelper.method(:custom_type_deserializer))
                    .deserialize_into(Invoice.method(:from_hash))
@@ -83,8 +82,7 @@ module AdvancedBilling
     # A `reason` is required in order to void, and the invoice must have an open
     # status. Voiding will cause any prepayments and credits that were applied
     # to the invoice to be returned to the subscription. For a full overview of
-    # the impact of voiding, please [see our help
-    # docs](reference/Chargify-API.v1.yaml/components/schemas/Invoice).
+    # the impact of voiding, please [see our help docs]($m/Invoice).
     # @param [Integer] subscription_id Required parameter: The Chargify id of
     # the subscription
     # @param [VoidInvoiceRequest] body Optional parameter: Example:
@@ -102,7 +100,7 @@ module AdvancedBilling
                    .body_param(new_parameter(body))
                    .header_param(new_parameter('application/json', key: 'accept'))
                    .body_serializer(proc do |param| param.to_json unless param.nil? end)
-                   .auth(Single.new('global')))
+                   .auth(Single.new('BasicAuth')))
         .response(new_response_handler
                    .deserializer(APIHelper.method(:custom_type_deserializer))
                    .deserialize_into(Invoice.method(:from_hash))