dwolla_v2 2.0.2 → 2.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0cafca4ba5043293349a816b777be7acc7a9e9ed
-  data.tar.gz: b6a74a586e445103f1fb87416096653f53bc7ddc
+  metadata.gz: e2c5759f8b81eb5d85c8fae2e308062048a9ec09
+  data.tar.gz: f4536f036c14fac66caf7d6c260f67dcfcceb020
 SHA512:
-  metadata.gz: fe9b1d99826e13809b3925470614559e8cbdacba6a3763bc6ac4951e6633e919fdca4c05ac84ca1fb6a7d7cfbb38a30969ed00211cc640f2cf22e393bc4aefe1
-  data.tar.gz: 81d8598e3fc866688bc6b0131072c705f7c03803b54e8656ac034f8e60a145e60598f761b00685b28ac7221657b1b970467eb72dda3871a128b46380cc4ec40b
+  metadata.gz: c0b10cccd12b0f82f6fd615db9e2e1c098d50d37f3caa38cb2b39ce4733245c44cb5880eec8a13de99133cea6baf3e84b499f1c5c48913450b22f4b47af780dc
+  data.tar.gz: 6af8d862bcfabc8cb606f5b5d0c94da711f08a3072faff16f383299b12d794b85114d9cf1fff25baac3247ea0600d0dbe76a1bc57d2a8bfad18bfb70824a3089

data/.travis.yml

@@ -3,8 +3,10 @@ language: ruby
 rvm:
   - 1.9.3
   - 2.0.0
-  - 2.1.7
-  - 2.2.0
+  - 2.1.9
+  - 2.2.9
+  - 2.3.6
+  - 2.4.3
   - ruby-head
   - rbx-2
   - jruby

data/README.md

@@ -2,7 +2,7 @@
 
 ![Build Status](https://travis-ci.org/Dwolla/dwolla-v2-ruby.svg)
 
-Dwolla V2 Ruby client. For the V1 Ruby client see [Dwolla/dwolla-ruby](https://github.com/Dwolla/dwolla-ruby).
+Dwolla V2 Ruby client.
 
 [API Documentation](https://docsv2.dwolla.com)
 
@@ -29,8 +29,8 @@ Or install it yourself as:
 Create a client using your application's consumer key and secret found on the applications page
 ([Sandbox][apsandbox], [Production][approd]).
 
-[apsandbox]: https://sandbox.dwolla.com/applications
-[approd]: https://www.dwolla.com/applications
+[apsandbox]: https://dashboard-sandbox.dwolla.com/applications
+[approd]: https://dashboard.dwolla.com/applications
 
 ```ruby
 # config/initializers/dwolla.rb
@@ -91,17 +91,12 @@ end
 
 ## `DwollaV2::Token`
 
-Tokens can be used to make requests to the Dwolla V2 API. There are two types of tokens:
+Tokens can be used to make requests to the Dwolla V2 API.
 
 ### Application tokens
 
-Application tokens are used to access the API on behalf of a consumer application. API resources that
-belong to an application include: `webhook-subscriptions`, `events`, and `webhooks`. Application
-tokens can be created using the [`client_credentials`][client_credentials] OAuth grant type:
-
-**Note:** If an application has the `ManageCustomers` scope enabled, it can also be used to access
-the API for White Label Customer related endpoints. Keep in mind, the application must belong to
-same Dwolla account that will be used when creating and managing White Label Customers in the API.
+Application access tokens are used to authenticate against the API on behalf of a consumer application. Application tokens can be used to access resources in the API that either belong to the application itself (`webhooks`, `events`, `webhook-subscriptions`) or the partner Account that owns the consumer application (`accounts`, `customers`, `funding-sources`, etc.). Application
+tokens are obtained by using the [`client_credentials`][client_credentials] OAuth grant type:
 
 [client_credentials]: https://tools.ietf.org/html/rfc6749#section-4.4
 
@@ -110,80 +105,17 @@ application_token = $dwolla.auths.client
 # => #<DwollaV2::Token client=#<DwollaV2::Client key="..." secret="..." environment=:sandbox> access_token="..." expires_in=3600 scope="...">
 ```
 
-*Application tokens do not include a `refresh_token`. When an application token expires, generate
-a new one using `$dwolla.auths.client`.*
-
-### Account tokens
-
-Account tokens are used to access the API on behalf of a Dwolla account. API resources that belong
-to an account include `customers`, `funding-sources`, `documents`, `mass-payments`, `mass-payment-items`,
-`transfers`, and `on-demand-authorizations`.
-
-There are two ways to get an account token. One is by generating a token at
-https://sandbox.dwolla.com/applications (Sandbox) or https://www.dwolla.com/applications (Production).
-
-You can instantiate a generated token by doing the following:
-
-```ruby
-account_token = $dwolla.tokens.new access_token: "...", refresh_token: "..."
-# => #<DwollaV2::Token client=#<DwollaV2::Client key="..." secret="..." environment=:sandbox> access_token="..." refresh_token="...">
-```
-
-The other way to get an account token is using the [`authorization_code`][authorization_code]
-OAuth grant type. This flow works by redirecting a user to dwolla.com in order to get authorization
-and sending them back to your website with an authorization code which can be exchanged for a token.
-For example:
-
-[authorization_code]: https://tools.ietf.org/html/rfc6749#section-4.1
-
-```ruby
-class YourAuthController < ApplicationController
-  # redirect the user to dwolla.com for authorization
-  def authorize
-    redirect_to auth.url
-  end
-
-  # https://yoursite.com/callback?code=...&state=...
-  def callback
-    # exchange the code for a token
-    token = auth.callback(params)
-    # => #<DwollaV2::Token client=#<DwollaV2::Client key="..." secret="..." environment=:sandbox> access_token="..." refresh_token="..." expires_in=3600 scope="ManageCustomers|Funding" account_id="...">
-    session[:account_id] = token.account_id
-  end
-
-  private
-
-  def auth
-    $dwolla.auths.new redirect_uri: "https://yoursite.com/callback",
-                      scope: "ManageCustomers|Funding",
-                      state: session[:state] ||= SecureRandom.hex(8), # optional
-                      verified_account: true, # optional
-                      dwolla_landing: "register" # optional
-  end
-end
-```
-
-### Refreshing tokens
-
-Tokens with `refresh_token`s can be refreshed using `$dwolla.auths.refresh`, which takes a
-`DwollaV2::Token` as its first argument and returns a new token.
-
-```ruby
-refreshed_token = $dwolla.auths.refresh(expired_token)
-# => #<DwollaV2::Token client=#<DwollaV2::Client key="..." secret="..." environment=:sandbox> access_token="..." refresh_token="..." expires_in=3600 scope="ManageCustomers|Funding" account_id="...">
-```
+_Application tokens do not include a `refresh_token`. When an application token expires, generate
+a new one using `$dwolla.auths.client`._
 
-### Initializing pre-existing tokens:
+### Initializing a pre-existing access token:
 
 `DwollaV2::Token`s can be initialized with the following attributes:
 
 ```ruby
 $dwolla.tokens.new access_token: "...",
-                   refresh_token: "...",
-                   expires_in: 123,
-                   scope: "...",
-                   account_id: "..."
-#<DwollaV2::Token client=#<DwollaV2::Client key="..." secret="..." environment=:sandbox> access_token="..." refresh_token="..." expires_in=123 scope="..." account_id="...">
+                   expires_in: 123
+#<DwollaV2::Token client=#<DwollaV2::Client key="..." secret="..." environment=:sandbox> access_token="..." expires_in=123>
 ```
 
 ```ruby
@@ -280,34 +212,34 @@ end
 
 ### `DwollaV2::Error` subclasses:
 
-*See https://docsv2.dwolla.com/#errors for more info.*
-
-- `DwollaV2::AccessDeniedError`
-- `DwollaV2::InvalidCredentialsError`
-- `DwollaV2::NotFoundError`
-- `DwollaV2::BadRequestError`
-- `DwollaV2::InvalidGrantError`
-- `DwollaV2::RequestTimeoutError`
-- `DwollaV2::ExpiredAccessTokenError`
-- `DwollaV2::InvalidRequestError`
-- `DwollaV2::ServerError`
-- `DwollaV2::ForbiddenError`
-- `DwollaV2::InvalidResourceStateError`
-- `DwollaV2::TemporarilyUnavailableError`
-- `DwollaV2::InvalidAccessTokenError`
-- `DwollaV2::InvalidScopeError`
-- `DwollaV2::UnauthorizedClientError`
-- `DwollaV2::InvalidAccountStatusError`
-- `DwollaV2::InvalidScopesError`
-- `DwollaV2::UnsupportedGrantTypeError`
-- `DwollaV2::InvalidApplicationStatusError`
-- `DwollaV2::InvalidVersionError`
-- `DwollaV2::UnsupportedResponseTypeError`
-- `DwollaV2::InvalidClientError`
-- `DwollaV2::MethodNotAllowedError`
-- `DwollaV2::ValidationError`
-- `DwollaV2::TooManyRequestsError`
-- `DwollaV2::ConflictError`
+_See https://docsv2.dwolla.com/#errors for more info._
+
+* `DwollaV2::AccessDeniedError`
+* `DwollaV2::InvalidCredentialsError`
+* `DwollaV2::NotFoundError`
+* `DwollaV2::BadRequestError`
+* `DwollaV2::InvalidGrantError`
+* `DwollaV2::RequestTimeoutError`
+* `DwollaV2::ExpiredAccessTokenError`
+* `DwollaV2::InvalidRequestError`
+* `DwollaV2::ServerError`
+* `DwollaV2::ForbiddenError`
+* `DwollaV2::InvalidResourceStateError`
+* `DwollaV2::TemporarilyUnavailableError`
+* `DwollaV2::InvalidAccessTokenError`
+* `DwollaV2::InvalidScopeError`
+* `DwollaV2::UnauthorizedClientError`
+* `DwollaV2::InvalidAccountStatusError`
+* `DwollaV2::InvalidScopesError`
+* `DwollaV2::UnsupportedGrantTypeError`
+* `DwollaV2::InvalidApplicationStatusError`
+* `DwollaV2::InvalidVersionError`
+* `DwollaV2::UnsupportedResponseTypeError`
+* `DwollaV2::InvalidClientError`
+* `DwollaV2::MethodNotAllowedError`
+* `DwollaV2::ValidationError`
+* `DwollaV2::TooManyRequestsError`
+* `DwollaV2::ConflictError`
 
 ## Sample code
 
@@ -334,26 +266,27 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Changelog
 
-- **2.0.2** - Fix bug in [#30](https://github.com/Dwolla/dwolla-v2-ruby/pull/30) (Thanks again @sobrinho!)
-- **2.0.1** - Fix bugs in [#27](https://github.com/Dwolla/dwolla-v2-ruby/pull/27) + [#28](https://github.com/Dwolla/dwolla-v2-ruby/pull/28) (Thanks @sobrinho!)
-- **2.0.0**
-- Rename `DwollaV2::Response` `#status` => `#response_status`, `#headers` => `#response_headers` to prevent
+* **2.0.3** - Add `DuplicateResourceError` [#34](https://github.com/Dwolla/dwolla-v2-ruby/pull/34) (Thanks @javierjulio!)
+* **2.0.2** - Fix bug in [#30](https://github.com/Dwolla/dwolla-v2-ruby/pull/30) (Thanks again @sobrinho!)
+* **2.0.1** - Fix bugs in [#27](https://github.com/Dwolla/dwolla-v2-ruby/pull/27) + [#28](https://github.com/Dwolla/dwolla-v2-ruby/pull/28) (Thanks @sobrinho!)
+* **2.0.0**
+* Rename `DwollaV2::Response` `#status` => `#response_status`, `#headers` => `#response_headers` to prevent
   [conflicts with response body properties][response-conflicts].
-- Remove support for Ruby versions < 2 ([Bump public_suffix dependency version][public-suffix]).
-- **1.2.3** - Implement `#empty?` on `DwollaV2::Token` to allow it to be passed to ActiveRecord constructor.
-- **1.2.2** - Strip domain from URLs provided to `token.*` methods.
-- **1.2.1** - Update sandbox URLs from uat => sandbox.
-- **1.2.0** - Refer to Client :id as :key in docs/public APIs for consistency.
-- **1.1.2** - Add support for `verified_account` and `dwolla_landing` auth flags.
-- **1.1.1** - Add `TooManyRequestsError` and `ConflictError` classes.
-- **1.1.0** - Support setting headers on a per-request basis.
-- **1.0.1** - Set user agent header.
-- **1.0.0** - Refactor `Error` class to be more like response, add ability to access keys using methods.
-- **0.4.0** - Refactor and document how `DwollaV2::Response` works
-- **0.3.1** - better `DwollaV2::Error` error messages
-- **0.3.0** - ISO8601 values in response body are converted to `Time` objects
-- **0.2.0** - Works with `attr_encrypted`
-- **0.1.1** - Handle 500 error with HTML response body when requesting a token
+* Remove support for Ruby versions < 2 ([Bump public_suffix dependency version][public-suffix]).
+* **1.2.3** - Implement `#empty?` on `DwollaV2::Token` to allow it to be passed to ActiveRecord constructor.
+* **1.2.2** - Strip domain from URLs provided to `token.*` methods.
+* **1.2.1** - Update sandbox URLs from uat => sandbox.
+* **1.2.0** - Refer to Client :id as :key in docs/public APIs for consistency.
+* **1.1.2** - Add support for `verified_account` and `dwolla_landing` auth flags.
+* **1.1.1** - Add `TooManyRequestsError` and `ConflictError` classes.
+* **1.1.0** - Support setting headers on a per-request basis.
+* **1.0.1** - Set user agent header.
+* **1.0.0** - Refactor `Error` class to be more like response, add ability to access keys using methods.
+* **0.4.0** - Refactor and document how `DwollaV2::Response` works
+* **0.3.1** - better `DwollaV2::Error` error messages
+* **0.3.0** - ISO8601 values in response body are converted to `Time` objects
+* **0.2.0** - Works with `attr_encrypted`
+* **0.1.1** - Handle 500 error with HTML response body when requesting a token
 
 [response-conflicts]: https://discuss.dwolla.com/t/document-change-or-more-clarifiation/3964
 [public-suffix]: https://github.com/Dwolla/dwolla-v2-ruby/pull/18#discussion_r108028135

data/lib/dwolla_v2.rb

@@ -53,6 +53,7 @@ require "dwolla_v2/errors/invalid_version_error"
 require "dwolla_v2/errors/request_timeout_error"
 require "dwolla_v2/errors/too_many_requests_error"
 require "dwolla_v2/errors/conflict_error"
+require "dwolla_v2/errors/duplicate_resource_error"
 
 module DwollaV2
 end

data/lib/dwolla_v2/errors/duplicate_resource_error.rb

@@ -0,0 +1,4 @@
+module DwollaV2
+  class DuplicateResourceError < Error
+  end
+end

data/lib/dwolla_v2/version.rb

@@ -1,3 +1,3 @@
 module DwollaV2
-  VERSION = "2.0.2"
+  VERSION = "2.0.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dwolla_v2
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.0.3
 platform: ruby
 authors:
 - Stephen Ausman
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-11-06 00:00:00.000000000 Z
+date: 2018-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -132,6 +132,7 @@ files:
 - lib/dwolla_v2/errors/access_denied_error.rb
 - lib/dwolla_v2/errors/bad_request_error.rb
 - lib/dwolla_v2/errors/conflict_error.rb
+- lib/dwolla_v2/errors/duplicate_resource_error.rb
 - lib/dwolla_v2/errors/expired_access_token_error.rb
 - lib/dwolla_v2/errors/forbidden_error.rb
 - lib/dwolla_v2/errors/invalid_access_token_error.rb