gocardless-pro 0.1.0

data/lib/gocardless-pro/services/customer_bank_account_service.rb

@@ -0,0 +1,153 @@
+require_relative './base_service'
+
+# encoding: utf-8
+#
+# WARNING: Do not edit by hand, this file was generated by Crank:
+#
+#   https://github.com/gocardless/crank
+
+module GoCardless
+  module Services
+    # Service for making requests to the CustomerBankAccount endpoints
+    class CustomerBankAccountService < BaseService
+      # Creates a new bank account object associated to a customer id.
+      #
+      # There are
+      # three different ways to supply bank account details:
+      #
+      # - [Local
+      # details](https://developer.gocardless.com/pro/#ui-compliance-local-bank-details)
+      #
+      #
+      # - IBAN
+      #
+      # - [Customer Bank Account
+      # Tokens](https://developer.gocardless.com/pro/#js-flow-create-a-customer-bank-account-token)
+      #
+      #
+      # For more information on the different fields required in each country, see
+      # [local bank
+      # details](https://developer.gocardless.com/pro/#ui-compliance-local-bank-details).
+      # Example URL: /customer_bank_accounts
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def create(options = {}, custom_headers = {})
+        path = '/customer_bank_accounts'
+        new_options = {}
+        new_options[envelope_key] = options
+        options = new_options
+        response = make_request(:post, path, options, custom_headers)
+
+        Resources::CustomerBankAccount.new(unenvelope_body(response.body))
+      end
+
+      # Returns a
+      # [cursor-paginated](https://developer.gocardless.com/pro/#overview-cursor-pagination)
+      # list of your bank accounts.
+      # Example URL: /customer_bank_accounts
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def list(options = {}, custom_headers = {})
+        path = '/customer_bank_accounts'
+
+        response = make_request(:get, path, options, custom_headers)
+        ListResponse.new(
+          raw_response: response,
+          unenveloped_body: unenvelope_body(response.body),
+          resource_class: Resources::CustomerBankAccount
+        )
+      end
+
+      # Get a lazily enumerated list of all the items returned. This is simmilar to the `list` method but will paginate for you automatically.
+      #
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Otherwise they will be the body of the request.
+      def all(options = {})
+        Paginator.new(
+          service: self,
+          path: '/customer_bank_accounts',
+          options: options
+        ).enumerator
+      end
+
+      # Retrieves the details of an existing bank account.
+      # Example URL: /customer_bank_accounts/:identity
+      #
+      # @param identity       # Unique identifier, beginning with "BA"
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def get(identity, options = {}, custom_headers = {})
+        path = sub_url('/customer_bank_accounts/:identity',           'identity' => identity)
+
+        response = make_request(:get, path, options, custom_headers)
+
+        Resources::CustomerBankAccount.new(unenvelope_body(response.body))
+      end
+
+      # Updates a customer bank account object. Only the metadata parameter is
+      # allowed.
+      # Example URL: /customer_bank_accounts/:identity
+      #
+      # @param identity       # Unique identifier, beginning with "BA"
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def update(identity, options = {}, custom_headers = {})
+        path = sub_url('/customer_bank_accounts/:identity',           'identity' => identity)
+
+        new_options = {}
+        new_options[envelope_key] = options
+        options = new_options
+        response = make_request(:put, path, options, custom_headers)
+
+        Resources::CustomerBankAccount.new(unenvelope_body(response.body))
+      end
+
+      # Immediately cancels all associated mandates and cancellable payments.
+      #
+      #
+      # This will return a `disable_failed` error if the bank account has already been
+      # disabled.
+      #
+      # A disabled bank account can be re-enabled by creating a new
+      # bank account resource with the same details.
+      # Example URL: /customer_bank_accounts/:identity/actions/disable
+      #
+      # @param identity       # Unique identifier, beginning with "BA"
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def disable(identity, options = {}, custom_headers = {})
+        path = sub_url('/customer_bank_accounts/:identity/actions/disable',           'identity' => identity)
+
+        new_options = {}
+        new_options['data'] = options
+        options = new_options
+        response = make_request(:post, path, options, custom_headers)
+
+        Resources::CustomerBankAccount.new(unenvelope_body(response.body))
+      end
+
+      # Unenvelope the response of the body using the service's `envelope_key`
+      #
+      # @param body [Hash]
+      def unenvelope_body(body)
+        body[envelope_key] || body['data']
+      end
+
+      private
+
+      # return the key which API responses will envelope data under
+      def envelope_key
+        'customer_bank_accounts'
+      end
+
+      # take a URL with placeholder params and substitute them out for the acutal value
+      # @param url [String] the URL with placeholders in
+      # @param param_map [Hash] a hash of placeholders and their actual values
+      def sub_url(url, param_map)
+        param_map.reduce(url) do |new_url, (param, value)|
+          new_url.gsub(":#{param}", value)
+        end
+      end
+    end
+  end
+end

data/lib/gocardless-pro/services/customer_service.rb

@@ -0,0 +1,112 @@
+require_relative './base_service'
+
+# encoding: utf-8
+#
+# WARNING: Do not edit by hand, this file was generated by Crank:
+#
+#   https://github.com/gocardless/crank
+
+module GoCardless
+  module Services
+    # Service for making requests to the Customer endpoints
+    class CustomerService < BaseService
+      # Creates a new customer object.
+      # Example URL: /customers
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def create(options = {}, custom_headers = {})
+        path = '/customers'
+        new_options = {}
+        new_options[envelope_key] = options
+        options = new_options
+        response = make_request(:post, path, options, custom_headers)
+
+        Resources::Customer.new(unenvelope_body(response.body))
+      end
+
+      # Returns a
+      # [cursor-paginated](https://developer.gocardless.com/pro/#overview-cursor-pagination)
+      # list of your customers.
+      # Example URL: /customers
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def list(options = {}, custom_headers = {})
+        path = '/customers'
+
+        response = make_request(:get, path, options, custom_headers)
+        ListResponse.new(
+          raw_response: response,
+          unenveloped_body: unenvelope_body(response.body),
+          resource_class: Resources::Customer
+        )
+      end
+
+      # Get a lazily enumerated list of all the items returned. This is simmilar to the `list` method but will paginate for you automatically.
+      #
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Otherwise they will be the body of the request.
+      def all(options = {})
+        Paginator.new(
+          service: self,
+          path: '/customers',
+          options: options
+        ).enumerator
+      end
+
+      # Retrieves the details of an existing customer.
+      # Example URL: /customers/:identity
+      #
+      # @param identity       # Unique identifier, beginning with "CU".
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def get(identity, options = {}, custom_headers = {})
+        path = sub_url('/customers/:identity',           'identity' => identity)
+
+        response = make_request(:get, path, options, custom_headers)
+
+        Resources::Customer.new(unenvelope_body(response.body))
+      end
+
+      # Updates a customer object. Supports all of the fields supported when creating
+      # a customer.
+      # Example URL: /customers/:identity
+      #
+      # @param identity       # Unique identifier, beginning with "CU".
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def update(identity, options = {}, custom_headers = {})
+        path = sub_url('/customers/:identity',           'identity' => identity)
+
+        new_options = {}
+        new_options[envelope_key] = options
+        options = new_options
+        response = make_request(:put, path, options, custom_headers)
+
+        Resources::Customer.new(unenvelope_body(response.body))
+      end
+
+      # Unenvelope the response of the body using the service's `envelope_key`
+      #
+      # @param body [Hash]
+      def unenvelope_body(body)
+        body[envelope_key] || body['data']
+      end
+
+      private
+
+      # return the key which API responses will envelope data under
+      def envelope_key
+        'customers'
+      end
+
+      # take a URL with placeholder params and substitute them out for the acutal value
+      # @param url [String] the URL with placeholders in
+      # @param param_map [Hash] a hash of placeholders and their actual values
+      def sub_url(url, param_map)
+        param_map.reduce(url) do |new_url, (param, value)|
+          new_url.gsub(":#{param}", value)
+        end
+      end
+    end
+  end
+end

data/lib/gocardless-pro/services/event_service.rb

@@ -0,0 +1,80 @@
+require_relative './base_service'
+
+# encoding: utf-8
+#
+# WARNING: Do not edit by hand, this file was generated by Crank:
+#
+#   https://github.com/gocardless/crank
+
+module GoCardless
+  module Services
+    # Service for making requests to the Event endpoints
+    class EventService < BaseService
+      # Returns a
+      # [cursor-paginated](https://developer.gocardless.com/pro/#overview-cursor-pagination)
+      # list of your events.
+      # Example URL: /events
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def list(options = {}, custom_headers = {})
+        path = '/events'
+
+        response = make_request(:get, path, options, custom_headers)
+        ListResponse.new(
+          raw_response: response,
+          unenveloped_body: unenvelope_body(response.body),
+          resource_class: Resources::Event
+        )
+      end
+
+      # Get a lazily enumerated list of all the items returned. This is simmilar to the `list` method but will paginate for you automatically.
+      #
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Otherwise they will be the body of the request.
+      def all(options = {})
+        Paginator.new(
+          service: self,
+          path: '/events',
+          options: options
+        ).enumerator
+      end
+
+      # Retrieves the details of a single event.
+      # Example URL: /events/:identity
+      #
+      # @param identity       # Unique identifier, beginning with "EV"
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def get(identity, options = {}, custom_headers = {})
+        path = sub_url('/events/:identity',           'identity' => identity)
+
+        response = make_request(:get, path, options, custom_headers)
+
+        Resources::Event.new(unenvelope_body(response.body))
+      end
+
+      # Unenvelope the response of the body using the service's `envelope_key`
+      #
+      # @param body [Hash]
+      def unenvelope_body(body)
+        body[envelope_key] || body['data']
+      end
+
+      private
+
+      # return the key which API responses will envelope data under
+      def envelope_key
+        'events'
+      end
+
+      # take a URL with placeholder params and substitute them out for the acutal value
+      # @param url [String] the URL with placeholders in
+      # @param param_map [Hash] a hash of placeholders and their actual values
+      def sub_url(url, param_map)
+        param_map.reduce(url) do |new_url, (param, value)|
+          new_url.gsub(":#{param}", value)
+        end
+      end
+    end
+  end
+end

data/lib/gocardless-pro/services/helper_service.rb

@@ -0,0 +1,97 @@
+require_relative './base_service'
+
+# encoding: utf-8
+#
+# WARNING: Do not edit by hand, this file was generated by Crank:
+#
+#   https://github.com/gocardless/crank
+
+module GoCardless
+  module Services
+    # Service for making requests to the Helper endpoints
+    class HelperService < BaseService
+      # Returns a PDF mandate form with a signature field, ready to be signed by your
+      # customer. May be fully or partially pre-filled.
+      #
+      # You must specify `Accept:
+      # application/pdf` on requests to this endpoint.
+      #
+      # Bank account details may
+      # either be supplied using the IBAN (international bank account number), or
+      # [local
+      # details](https://developer.gocardless.com/pro/#ui-compliance-local-bank-details).
+      # For more information on the different fields required in each country, please
+      # see the [local bank
+      # details](https://developer.gocardless.com/pro/#ui-compliance-local-bank-details)
+      # section.
+      #
+      # To generate a mandate in a foreign language, set your
+      # `Accept-Language` header to the relevant [ISO
+      # 639-1](http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes#Partial_ISO_639_table)
+      # language code. Currently Dutch, English, French, German, Italian, Portuguese
+      # and Spanish are supported.
+      #
+      # _Note:_ If you want to render a PDF of an
+      # existing mandate you can also do so using the [mandate show
+      # endpoint](https://developer.gocardless.com/pro/#mandates-get-a-single-mandate).
+      # Example URL: /helpers/mandate
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def mandate(options = {}, custom_headers = {})
+        path = '/helpers/mandate'
+        new_options = {}
+        new_options['data'] = options
+        options = new_options
+        response = make_request(:post, path, options, custom_headers)
+
+        Resources::Helper.new(unenvelope_body(response.body))
+      end
+
+      # Check whether an account number and bank / branch code combination are
+      # compatible.
+      #
+      # Bank account details may either be supplied using the IBAN
+      # (international bank account number), or [local
+      # details](https://developer.gocardless.com/pro/#ui-compliance-local-bank-details).
+      # For more information on the different fields required in each country, please
+      # see the [local bank
+      # details](https://developer.gocardless.com/pro/#ui-compliance-local-bank-details)
+      # section.
+      # Example URL: /helpers/modulus_check
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def modulus_check(options = {}, custom_headers = {})
+        path = '/helpers/modulus_check'
+        new_options = {}
+        new_options['data'] = options
+        options = new_options
+        response = make_request(:post, path, options, custom_headers)
+
+        Resources::Helper.new(unenvelope_body(response.body))
+      end
+
+      # Unenvelope the response of the body using the service's `envelope_key`
+      #
+      # @param body [Hash]
+      def unenvelope_body(body)
+        body[envelope_key] || body['data']
+      end
+
+      private
+
+      # return the key which API responses will envelope data under
+      def envelope_key
+        'helpers'
+      end
+
+      # take a URL with placeholder params and substitute them out for the acutal value
+      # @param url [String] the URL with placeholders in
+      # @param param_map [Hash] a hash of placeholders and their actual values
+      def sub_url(url, param_map)
+        param_map.reduce(url) do |new_url, (param, value)|
+          new_url.gsub(":#{param}", value)
+        end
+      end
+    end
+  end
+end

data/lib/gocardless-pro/services/mandate_service.rb

@@ -0,0 +1,170 @@
+require_relative './base_service'
+
+# encoding: utf-8
+#
+# WARNING: Do not edit by hand, this file was generated by Crank:
+#
+#   https://github.com/gocardless/crank
+
+module GoCardless
+  module Services
+    # Service for making requests to the Mandate endpoints
+    class MandateService < BaseService
+      # Creates a new mandate object
+      # Example URL: /mandates
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def create(options = {}, custom_headers = {})
+        path = '/mandates'
+        new_options = {}
+        new_options[envelope_key] = options
+        options = new_options
+        response = make_request(:post, path, options, custom_headers)
+
+        Resources::Mandate.new(unenvelope_body(response.body))
+      end
+
+      # Returns a
+      # [cursor-paginated](https://developer.gocardless.com/pro/#overview-cursor-pagination)
+      # list of your mandates. Except where stated, these filters can only be used one
+      # at a time.
+      # Example URL: /mandates
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def list(options = {}, custom_headers = {})
+        path = '/mandates'
+
+        response = make_request(:get, path, options, custom_headers)
+        ListResponse.new(
+          raw_response: response,
+          unenveloped_body: unenvelope_body(response.body),
+          resource_class: Resources::Mandate
+        )
+      end
+
+      # Get a lazily enumerated list of all the items returned. This is simmilar to the `list` method but will paginate for you automatically.
+      #
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Otherwise they will be the body of the request.
+      def all(options = {})
+        Paginator.new(
+          service: self,
+          path: '/mandates',
+          options: options
+        ).enumerator
+      end
+
+      # Retrieves the details of an existing mandate.
+      #
+      # If you specify `Accept:
+      # application/pdf` on a request to this endpoint it will return a PDF complying
+      # to the relevant scheme rules, which you can present to your customer.
+      #
+      # PDF
+      # mandates can be retrieved in Dutch, English, French, German, Italian,
+      # Portuguese and Spanish by specifying the [ISO
+      # 639-1](http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes#Partial_ISO_639_table)
+      # language code as an `Accept-Language` header.
+      # Example URL: /mandates/:identity
+      #
+      # @param identity       # Unique identifier, beginning with "MD"
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def get(identity, options = {}, custom_headers = {})
+        path = sub_url('/mandates/:identity',           'identity' => identity)
+
+        response = make_request(:get, path, options, custom_headers)
+
+        Resources::Mandate.new(unenvelope_body(response.body))
+      end
+
+      # Updates a mandate object. This accepts only the metadata parameter.
+      # Example URL: /mandates/:identity
+      #
+      # @param identity       # Unique identifier, beginning with "MD"
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def update(identity, options = {}, custom_headers = {})
+        path = sub_url('/mandates/:identity',           'identity' => identity)
+
+        new_options = {}
+        new_options[envelope_key] = options
+        options = new_options
+        response = make_request(:put, path, options, custom_headers)
+
+        Resources::Mandate.new(unenvelope_body(response.body))
+      end
+
+      # Immediately cancels a mandate and all associated cancellable payments. Any
+      # metadata supplied to this endpoint will be stored on the mandate cancellation
+      # event it causes.
+      #
+      # This will fail with a `cancellation_failed` error if the
+      # mandate is already cancelled.
+      # Example URL: /mandates/:identity/actions/cancel
+      #
+      # @param identity       # Unique identifier, beginning with "MD"
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def cancel(identity, options = {}, custom_headers = {})
+        path = sub_url('/mandates/:identity/actions/cancel',           'identity' => identity)
+
+        new_options = {}
+        new_options['data'] = options
+        options = new_options
+        response = make_request(:post, path, options, custom_headers)
+
+        Resources::Mandate.new(unenvelope_body(response.body))
+      end
+
+      # <a name="mandate_not_inactive"></a>Reinstates a cancelled or expired mandate
+      # to the banks. You will receive a `resubmission_requested` webhook, but after
+      # that reinstating the mandate follows the same process as its initial creation,
+      # so you will receive a `submitted` webhook, followed by a `reinstated` or
+      # `failed` webhook up to two working days later. Any metadata supplied to this
+      # endpoint will be stored on the `resubmission_requested` event it causes.
+      #
+      #
+      # This will fail with a `mandate_not_inactive` error if the mandate is already
+      # being submitted, or is active.
+      # Example URL: /mandates/:identity/actions/reinstate
+      #
+      # @param identity       # Unique identifier, beginning with "MD"
+      # @param options [Hash] parameters as a hash. If the request is a GET, these will be converted to query parameters.
+      # Else, they will be the body of the request.
+      def reinstate(identity, options = {}, custom_headers = {})
+        path = sub_url('/mandates/:identity/actions/reinstate',           'identity' => identity)
+
+        new_options = {}
+        new_options['data'] = options
+        options = new_options
+        response = make_request(:post, path, options, custom_headers)
+
+        Resources::Mandate.new(unenvelope_body(response.body))
+      end
+
+      # Unenvelope the response of the body using the service's `envelope_key`
+      #
+      # @param body [Hash]
+      def unenvelope_body(body)
+        body[envelope_key] || body['data']
+      end
+
+      private
+
+      # return the key which API responses will envelope data under
+      def envelope_key
+        'mandates'
+      end
+
+      # take a URL with placeholder params and substitute them out for the acutal value
+      # @param url [String] the URL with placeholders in
+      # @param param_map [Hash] a hash of placeholders and their actual values
+      def sub_url(url, param_map)
+        param_map.reduce(url) do |new_url, (param, value)|
+          new_url.gsub(":#{param}", value)
+        end
+      end
+    end
+  end
+end