gocardless_pro 2.27.0 → 2.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36f326b7d949867117fd93ecbe9074fcdb54ee3b690f046c2e48e16ce92281dc
-  data.tar.gz: dba0ba60c85f16a5d3c87f311ea6b4b73d93a438441a2ff96c962669c56f7630
+  metadata.gz: 1591576f071daabb20a04e9e91a7e802be0efed1b3e71910e33c35335589cdf4
+  data.tar.gz: 763c87329cc80eba691ae417c58b3344abbc7ffc48fe554be85fedcc24c1e80d
 SHA512:
-  metadata.gz: 5e5939895e083285066011907aad6a992fbb1f65b86392482964a4c856f64bf2834d9a63bb20faf2e7d3c00d5fa27e32ec0c2a9c4770f805ef2db2ba2983c79f
-  data.tar.gz: da519896309a48029ff7d5fb47f2747234b119fb7b539a8701892fe19ea2c921d3606cd66dc9ed4ce70f891a408a979176de5806881a44ce6a82b600aa8cb91b
+  metadata.gz: 7b8552085fb1ec811f6398ed9f52990853a48c4836e8f6092273366dcd0a9e1f27e4399cc8489322a726e94153dd221e1a4cd20b68f72a0c371d4b62984ac0bb
+  data.tar.gz: ec4ab730899aad19e7a670b5da2378e651db3bb1e88734e9794967ef33ac764e973b70e7c2a61613065a8284a1cf8afbf6879e8c7eaa13cda53a3176527be200

data/.circleci/config.yml

@@ -13,7 +13,19 @@ jobs:
     steps:
       - checkout
       - run: bundle install && bundle exec rspec
-
+  publish: &publish
+    docker:
+      - image: ruby:2.6
+    steps:
+      - checkout
+      - run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:rubygems_api_key: $RUBYGEM_PUBLISH_API_KEY\n" > $HOME/.gem/credentials
+          gem build *.gemspec
+          gem push *.gem
+          
 workflows:
   version: 2
   tests:
@@ -30,3 +42,10 @@ workflows:
                 ruby-version: "2.2"
               - faraday-version: "0.9.2"
                 ruby-version: "3.0"
+      - publish:
+          filters:
+            branches:
+              only:
+                - master      
+          requires:
+            - test

data/lib/gocardless_pro/api_service.rb

@@ -34,6 +34,10 @@ module GoCardlessPro
       @headers = options[:default_headers] || {}
       @headers['Authorization'] = "Bearer #{token}"
       @on_idempotency_conflict = options[:on_idempotency_conflict] || :fetch
+
+      unless %i[fetch raise].include?(@on_idempotency_conflict)
+        raise ArgumentError, 'Unknown mode for :on_idempotency_conflict'
+      end
     end
 
     # Make a request to the API

data/lib/gocardless_pro/client.rb

@@ -23,6 +23,16 @@ module GoCardlessPro
       @billing_request_flows ||= Services::BillingRequestFlowsService.new(@api_service)
     end
 
+    # Access to the service for billing_request_template to make API calls
+    def billing_request_templates
+      @billing_request_templates ||= Services::BillingRequestTemplatesService.new(@api_service)
+    end
+
+    # Access to the service for block to make API calls
+    def blocks
+      @blocks ||= Services::BlocksService.new(@api_service)
+    end
+
     # Access to the service for creditor to make API calls
     def creditors
       @creditors ||= Services::CreditorsService.new(@api_service)
@@ -188,7 +198,7 @@ module GoCardlessPro
           'User-Agent' => user_agent.to_s,
           'Content-Type' => 'application/json',
           'GoCardless-Client-Library' => 'gocardless-pro-ruby',
-          'GoCardless-Client-Version' => '2.27.0',
+          'GoCardless-Client-Version' => '2.30.0',
         },
       }
     end

data/lib/gocardless_pro/error/authentication_error.rb

@@ -0,0 +1,4 @@
+module GoCardlessPro
+  class AuthenticationError < InvalidApiUsageError
+  end
+end

data/lib/gocardless_pro/error/permission_error.rb

@@ -0,0 +1,4 @@
+module GoCardlessPro
+  class PermissionError < InvalidApiUsageError
+  end
+end

data/lib/gocardless_pro/error/rate_limit_error.rb

@@ -0,0 +1,4 @@
+module GoCardlessPro
+  class RateLimitError < InvalidApiUsageError
+  end
+end

data/lib/gocardless_pro/middlewares/raise_gocardless_errors.rb

@@ -12,12 +12,23 @@ module GoCardlessPro
         if CLIENT_ERROR_STATUSES.include?(env.status)
           json_body ||= JSON.parse(env.body) unless env.body.empty?
           error_type = json_body['error']['type']
-          raise(error_class_for_type(error_type), json_body['error'])
+
+          error_class = error_class_for_status(env.status) || error_class_for_type(error_type)
+
+          raise(error_class, json_body['error'])
         end
       end
 
       private
 
+      def error_class_for_status(code)
+        {
+          401 => GoCardlessPro::AuthenticationError,
+          403 => GoCardlessPro::PermissionError,
+          429 => GoCardlessPro::RateLimitError,
+        }.fetch(code, nil)
+      end
+
       def error_class_for_type(type)
         {
           validation_failed: GoCardlessPro::ValidationError,

data/lib/gocardless_pro/resources/bank_authorisation.rb

@@ -21,17 +21,15 @@ module GoCardlessPro
     # Creation of Bank Authorisations is only permitted from GoCardless hosted
     # UIs
     # (see Billing Request Flows) to ensure we meet regulatory requirements for
-    # checkout flows. The exceptions are integrators with the custom payment
-    # pages
-    # upgrade, who have been audited to check their flows meet requirements.
+    # checkout flows.
     class BankAuthorisation
       attr_reader :authorisation_type
+      attr_reader :authorised_at
       attr_reader :created_at
       attr_reader :expires_at
       attr_reader :id
       attr_reader :last_visited_at
       attr_reader :redirect_uri
-      attr_reader :short_url
       attr_reader :url
 
       # Initialize a bank_authorisation resource instance
@@ -40,13 +38,13 @@ module GoCardlessPro
         @object = object
 
         @authorisation_type = object['authorisation_type']
+        @authorised_at = object['authorised_at']
         @created_at = object['created_at']
         @expires_at = object['expires_at']
         @id = object['id']
         @last_visited_at = object['last_visited_at']
         @links = object['links']
         @redirect_uri = object['redirect_uri']
-        @short_url = object['short_url']
         @url = object['url']
         @response = response
       end
@@ -77,10 +75,6 @@ module GoCardlessPro
         def institution
           @links['institution']
         end
-
-        def payment_request
-          @links['payment_request']
-        end
       end
     end
   end

data/lib/gocardless_pro/resources/billing_request.rb

@@ -12,11 +12,19 @@ module GoCardlessPro
   module Resources
     # Represents an instance of a billing_request resource returned from the API
 
-    # Billing Requests
+    # Billing Requests help create resources that require input or action from a
+    # customer. An example of required input might be additional customer
+    # billing
+    # details, while an action would be asking a customer to authorise a payment
+    # using their mobile banking app.
+    #
+    # See [Billing Requests:
+    # Overview](https://developer.gocardless.com/getting-started/billing-requests/overview/)
+    # for how-to's, explanations and tutorials.
     class BillingRequest
       attr_reader :actions
-      attr_reader :auto_fulfil
       attr_reader :created_at
+      attr_reader :fallback_enabled
       attr_reader :id
       attr_reader :mandate_request
       attr_reader :metadata
@@ -30,8 +38,8 @@ module GoCardlessPro
         @object = object
 
         @actions = object['actions']
-        @auto_fulfil = object['auto_fulfil']
         @created_at = object['created_at']
+        @fallback_enabled = object['fallback_enabled']
         @id = object['id']
         @links = object['links']
         @mandate_request = object['mandate_request']
@@ -61,6 +69,14 @@ module GoCardlessPro
           @links = links || {}
         end
 
+        def bank_authorisation
+          @links['bank_authorisation']
+        end
+
+        def creditor
+          @links['creditor']
+        end
+
         def customer
           @links['customer']
         end
@@ -73,12 +89,20 @@ module GoCardlessPro
           @links['customer_billing_detail']
         end
 
-        def mandate_bank_authorisation
-          @links['mandate_bank_authorisation']
+        def mandate_request
+          @links['mandate_request']
+        end
+
+        def mandate_request_mandate
+          @links['mandate_request_mandate']
+        end
+
+        def payment_request
+          @links['payment_request']
         end
 
-        def payment_bank_authorisation
-          @links['payment_bank_authorisation']
+        def payment_request_payment
+          @links['payment_request_payment']
         end
       end
     end

data/lib/gocardless_pro/resources/billing_request_flow.rb

@@ -17,9 +17,16 @@ module GoCardlessPro
     # authorisation (such as open banking single payments).
     class BillingRequestFlow
       attr_reader :authorisation_url
+      attr_reader :auto_fulfil
       attr_reader :created_at
+      attr_reader :exit_uri
       attr_reader :expires_at
+      attr_reader :id
+      attr_reader :lock_bank_account
+      attr_reader :lock_customer_details
       attr_reader :redirect_uri
+      attr_reader :session_token
+      attr_reader :show_redirect_buttons
 
       # Initialize a billing_request_flow resource instance
       # @param object [Hash] an object returned from the API
@@ -27,10 +34,17 @@ module GoCardlessPro
         @object = object
 
         @authorisation_url = object['authorisation_url']
+        @auto_fulfil = object['auto_fulfil']
         @created_at = object['created_at']
+        @exit_uri = object['exit_uri']
         @expires_at = object['expires_at']
+        @id = object['id']
         @links = object['links']
+        @lock_bank_account = object['lock_bank_account']
+        @lock_customer_details = object['lock_customer_details']
         @redirect_uri = object['redirect_uri']
+        @session_token = object['session_token']
+        @show_redirect_buttons = object['show_redirect_buttons']
         @response = response
       end
 

data/lib/gocardless_pro/resources/billing_request_template.rb

@@ -0,0 +1,68 @@
+# encoding: utf-8
+
+#
+# This client is automatically generated from a template and JSON schema definition.
+# See https://github.com/gocardless/gocardless-pro-ruby#contributing before editing.
+#
+
+require 'uri'
+
+module GoCardlessPro
+  # A module containing classes for each of the resources in the GC Api
+  module Resources
+    # Represents an instance of a billing_request_template resource returned from the API
+
+    # Billing Request Templates
+    class BillingRequestTemplate
+      attr_reader :authorisation_url
+      attr_reader :created_at
+      attr_reader :id
+      attr_reader :mandate_request_currency
+      attr_reader :mandate_request_metadata
+      attr_reader :mandate_request_scheme
+      attr_reader :mandate_request_verify
+      attr_reader :metadata
+      attr_reader :name
+      attr_reader :payment_request_amount
+      attr_reader :payment_request_currency
+      attr_reader :payment_request_description
+      attr_reader :payment_request_metadata
+      attr_reader :payment_request_scheme
+      attr_reader :redirect_uri
+      attr_reader :updated_at
+
+      # Initialize a billing_request_template resource instance
+      # @param object [Hash] an object returned from the API
+      def initialize(object, response = nil)
+        @object = object
+
+        @authorisation_url = object['authorisation_url']
+        @created_at = object['created_at']
+        @id = object['id']
+        @mandate_request_currency = object['mandate_request_currency']
+        @mandate_request_metadata = object['mandate_request_metadata']
+        @mandate_request_scheme = object['mandate_request_scheme']
+        @mandate_request_verify = object['mandate_request_verify']
+        @metadata = object['metadata']
+        @name = object['name']
+        @payment_request_amount = object['payment_request_amount']
+        @payment_request_currency = object['payment_request_currency']
+        @payment_request_description = object['payment_request_description']
+        @payment_request_metadata = object['payment_request_metadata']
+        @payment_request_scheme = object['payment_request_scheme']
+        @redirect_uri = object['redirect_uri']
+        @updated_at = object['updated_at']
+        @response = response
+      end
+
+      def api_response
+        ApiResponse.new(@response)
+      end
+
+      # Provides the billing_request_template resource as a hash of all its readable attributes
+      def to_h
+        @object
+      end
+    end
+  end
+end

data/lib/gocardless_pro/resources/block.rb

@@ -0,0 +1,76 @@
+# encoding: utf-8
+
+#
+# This client is automatically generated from a template and JSON schema definition.
+# See https://github.com/gocardless/gocardless-pro-ruby#contributing before editing.
+#
+
+require 'uri'
+
+module GoCardlessPro
+  # A module containing classes for each of the resources in the GC Api
+  module Resources
+    # Represents an instance of a block resource returned from the API
+
+    # Blocks are created to prevent certain customer details from being used
+    # when creating
+    # mandates.
+    #
+    # The details used to create blocks can be exact matches, like a bank
+    # account or an email,
+    # or a more generic match such as an email domain. New block types may be
+    # added over time.
+    #
+    # A block object is in essence a simple rule that is used to match against
+    # details in a
+    # newly created mandate. If there is a successful match then the mandate is
+    # transitioned
+    # to a "blocked" state.
+    #
+    # Payments and subscriptions cannot be created against a mandate in blocked
+    # state.
+    #
+    # A mandate can never be transitioned out of the blocked state.
+    #
+    # <p class="notice">
+    #   This API is currently only available for approved integrators - please
+    # <a href="mailto:help@gocardless.com">get in touch</a> if you would like to
+    # use this API.
+    # </p>
+    class Block
+      attr_reader :active
+      attr_reader :block_type
+      attr_reader :created_at
+      attr_reader :id
+      attr_reader :reason_description
+      attr_reader :reason_type
+      attr_reader :resource_reference
+      attr_reader :updated_at
+
+      # Initialize a block resource instance
+      # @param object [Hash] an object returned from the API
+      def initialize(object, response = nil)
+        @object = object
+
+        @active = object['active']
+        @block_type = object['block_type']
+        @created_at = object['created_at']
+        @id = object['id']
+        @reason_description = object['reason_description']
+        @reason_type = object['reason_type']
+        @resource_reference = object['resource_reference']
+        @updated_at = object['updated_at']
+        @response = response
+      end
+
+      def api_response
+        ApiResponse.new(@response)
+      end
+
+      # Provides the block resource as a hash of all its readable attributes
+      def to_h
+        @object
+      end
+    end
+  end
+end

data/lib/gocardless_pro/resources/event.rb

@@ -60,6 +60,18 @@ module GoCardlessPro
           @links = links || {}
         end
 
+        def bank_authorisation
+          @links['bank_authorisation']
+        end
+
+        def billing_request
+          @links['billing_request']
+        end
+
+        def billing_request_flow
+          @links['billing_request_flow']
+        end
+
         def creditor
           @links['creditor']
         end
@@ -80,6 +92,10 @@ module GoCardlessPro
           @links['mandate']
         end
 
+        def mandate_request_mandate
+          @links['mandate_request_mandate']
+        end
+
         def new_customer_bank_account
           @links['new_customer_bank_account']
         end
@@ -104,6 +120,10 @@ module GoCardlessPro
           @links['payment']
         end
 
+        def payment_request_payment
+          @links['payment_request_payment']
+        end
+
         def payout
           @links['payout']
         end

data/lib/gocardless_pro/resources/institution.rb

@@ -13,8 +13,13 @@ module GoCardlessPro
     # Represents an instance of a institution resource returned from the API
 
     # Institutions that are supported when creating [Bank
-    # Authorisations](#billing-requests-bank-authorisations).
+    # Authorisations](#billing-requests-bank-authorisations) for a particular
+    # country or purpose.
+    #
+    # Not all institutions support both Payment Initiation (PIS) and Account
+    # Information (AIS) services.
     class Institution
+      attr_reader :country_code
       attr_reader :icon_url
       attr_reader :id
       attr_reader :logo_url
@@ -25,6 +30,7 @@ module GoCardlessPro
       def initialize(object, response = nil)
         @object = object
 
+        @country_code = object['country_code']
         @icon_url = object['icon_url']
         @id = object['id']
         @logo_url = object['logo_url']

data/lib/gocardless_pro/resources/payer_authorisation.rb

@@ -12,6 +12,15 @@ module GoCardlessPro
   module Resources
     # Represents an instance of a payer_authorisation resource returned from the API
 
+    # <p class="restricted-notice">
+    #   Don't use Payer Authorisations for new integrations.
+    #   It is deprecated in favour of
+    #   <a
+    # href="https://developer.gocardless.com/getting-started/billing-requests/overview/">
+    #   Billing Requests</a>. Use Billing Requests to build any future
+    # integrations.
+    # </p>
+    #
     # Payer Authorisation resource acts as a wrapper for creating customer, bank
     # account and mandate details in a single request.
     # PayerAuthorisation API enables the integrators to build their own custom

data/lib/gocardless_pro/resources/redirect_flow.rb

@@ -49,6 +49,7 @@ module GoCardlessPro
       attr_reader :created_at
       attr_reader :description
       attr_reader :id
+      attr_reader :mandate_reference
       attr_reader :metadata
       attr_reader :redirect_url
       attr_reader :scheme
@@ -65,6 +66,7 @@ module GoCardlessPro
         @description = object['description']
         @id = object['id']
         @links = object['links']
+        @mandate_reference = object['mandate_reference']
         @metadata = object['metadata']
         @redirect_url = object['redirect_url']
         @scheme = object['scheme']
@@ -92,6 +94,10 @@ module GoCardlessPro
           @links = links || {}
         end
 
+        def billing_request
+          @links['billing_request']
+        end
+
         def creditor
           @links['creditor']
         end

data/lib/gocardless_pro/services/bank_authorisations_service.rb

@@ -51,8 +51,6 @@ module GoCardlessPro
               raise IdempotencyConflict, e.error
             when :fetch
               return get(e.conflicting_resource_id)
-            else
-              raise ArgumentError, 'Unknown mode for :on_idempotency_conflict'
             end
           end
 

data/lib/gocardless_pro/services/billing_request_flows_service.rb

@@ -29,6 +29,29 @@ module GoCardlessPro
         Resources::BillingRequestFlow.new(unenvelope_body(response.body), response)
       end
 
+      # Returns the flow having generated a fresh session token which can be used to
+      # power
+      # integrations that manipulate the flow.
+      # Example URL: /billing_request_flows/:identity/actions/initialise
+      #
+      # @param identity       # Unique identifier, beginning with "BRF".
+      # @param options [Hash] parameters as a hash, under a params key.
+      def initialise(identity, options = {})
+        path = sub_url('/billing_request_flows/:identity/actions/initialise', 'identity' => identity)
+
+        params = options.delete(:params) || {}
+        options[:params] = {}
+        options[:params]['data'] = params
+
+        options[:retry_failures] = false
+
+        response = make_request(:post, path, options)
+
+        return if response.body.nil?
+
+        Resources::BillingRequestFlow.new(unenvelope_body(response.body), response)
+      end
+
       private
 
       # Unenvelope the response of the body using the service's `envelope_key`