gocardless_pro 4.2.0 → 4.4.1

data/lib/gocardless_pro/resources/outbound_payment_import_entry.rb

@@ -0,0 +1,77 @@
+#
+# 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 outbound_payment_import_entry resource returned from the API
+
+    # Import Entries are the individual rows of an outbound payment import,
+    # representing each payment to be created.
+    class OutboundPaymentImportEntry
+      attr_reader :amount
+      attr_reader :created_at
+      attr_reader :id
+      attr_reader :metadata
+      attr_reader :processed_at
+      attr_reader :reference
+      attr_reader :scheme
+      attr_reader :validation_errors
+      attr_reader :verification_result
+
+      # Initialize a outbound_payment_import_entry resource instance
+      # @param object [Hash] an object returned from the API
+      def initialize(object, response = nil)
+        @object = object
+
+        @amount = object['amount']
+        @created_at = object['created_at']
+        @id = object['id']
+        @links = object['links']
+        @metadata = object['metadata']
+        @processed_at = object['processed_at']
+        @reference = object['reference']
+        @scheme = object['scheme']
+        @validation_errors = object['validation_errors']
+        @verification_result = object['verification_result']
+        @response = response
+      end
+
+      def api_response
+        ApiResponse.new(@response)
+      end
+
+      # Return the links that the resource has
+      def links
+        @outbound_payment_import_entry_links ||= Links.new(@links)
+      end
+
+      # Provides the outbound_payment_import_entry resource as a hash of all its readable attributes
+      def to_h
+        @object
+      end
+
+      class Links
+        def initialize(links)
+          @links = links || {}
+        end
+
+        def outbound_payment
+          @links['outbound_payment']
+        end
+
+        def outbound_payment_import
+          @links['outbound_payment_import']
+        end
+
+        def recipient_bank_account
+          @links['recipient_bank_account']
+        end
+      end
+    end
+  end
+end

data/lib/gocardless_pro/resources/payer_authorisation.rb

@@ -10,14 +10,13 @@ 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>
+    # It is deprecated in favour of
+    #
+    #   Billing Requests
+    # (https://developer.gocardless.com/getting-started/billing-requests/overview/).
+    # Use Billing Requests to build any future integrations.
     #
     # Payer Authorisation resource acts as a wrapper for creating customer, bank
     # account and mandate details in a single request.
@@ -26,50 +25,53 @@ module GoCardlessPro
     #
     # The process to use the Payer Authorisation API is as follows:
     #
-    #   1. Create a Payer Authorisation, either empty or with already available
+    # 1. Create a Payer Authorisation, either empty or with already available
     # information
-    #   2. Update the authorisation with additional information or fix any
+    # 2. Update the authorisation with additional information or fix any
     # mistakes
-    #   3. Submit the authorisation, after the payer has reviewed their
+    # 3. Submit the authorisation, after the payer has reviewed their
     # information
-    #   4. [coming soon] Redirect the payer to the verification mechanisms from
+    # 4. [coming soon] Redirect the payer to the verification mechanisms from
     # the response of the Submit request (this will be introduced as a
     # non-breaking change)
-    #   5. Confirm the authorisation to indicate that the resources can be
-    # created
+    # 5. Confirm the authorisation to indicate that the resources can be created
     #
     # After the Payer Authorisation is confirmed, resources will eventually be
     # created as it's an asynchronous process.
     #
     # To retrieve the status and ID of the linked resources you can do one of
     # the following:
-    # <ol>
-    #   <li> Listen to <code>  payer_authorisation_completed </code>  <a
-    # href="#appendix-webhooks"> webhook</a> (recommended)</li>
-    #   <li> Poll the GET <a
-    # href="#payer-authorisations-get-a-single-payer-authorisation">
-    # endpoint</a></li>
-    #   <li> Poll the GET events API
-    # <code>https://api.gocardless.com/events?payer_authorisation={id}&action=completed</code>
-    # </li>
-    # </ol>
     #
-    # <p class="notice">
+    # 1.  Listen to   payer_authorisation_completed    webhook
+    # (https://developer.gocardless.com/api-reference/#appendix-webhooks)
+    # (recommended)
+    # 2.  Poll the GET  endpoint
+    # (https://developer.gocardless.com/api-reference/#payer-authorisations-get-a-single-payer-authorisation)
+    # 3.  Poll the GET events API
+    # https://api.gocardless.com/events?payer_authorisation={id}&action=completed
+    #
+    #
     #   Note that the `create` and `update` endpoints behave differently than
-    #   other existing `create` and `update` endpoints. The Payer Authorisation
-    # is still saved if incomplete data is provided.
-    #   We return the list of incomplete data in the `incomplete_fields` along
+    # other existing `create` and `update` endpoints. The Payer Authorisation is
+    # still saved if incomplete data is provided.
+    # We return the list of incomplete data in the `incomplete_fields` along
     # with the resources in the body of the response.
-    #   The bank account details(account_number, bank_code & branch_code) must
-    # be sent together rather than splitting across different request for both
+    # The bank account details(account_number, bank_code & branch_code) must be
+    # sent together rather than splitting across different request for both
     # `create` and `update` endpoints.
-    #   <br><br>
+    #
+    #
     #   The API is designed to be flexible and allows you to collect information
     # in multiple steps without storing any sensitive data in the browser or in
     # your servers.
-    # </p>
     class PayerAuthorisation
-      attr_reader :bank_account, :created_at, :customer, :id, :incomplete_fields, :mandate, :status
+      attr_reader :bank_account
+      attr_reader :created_at
+      attr_reader :customer
+      attr_reader :id
+      attr_reader :incomplete_fields
+      attr_reader :mandate
+      attr_reader :status
 
       # Initialize a payer_authorisation resource instance
       # @param object [Hash] an object returned from the API

data/lib/gocardless_pro/resources/payment.rb

@@ -10,16 +10,31 @@ module GoCardlessPro
   module Resources
     # Represents an instance of a payment resource returned from the API
 
-    # Payment objects represent payments from a
-    # [customer](#core-endpoints-customers) to a
-    # [creditor](#core-endpoints-creditors), taken against a Direct Debit
-    # [mandate](#core-endpoints-mandates).
+    # Payment objects represent payments from a customer
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-customers)
+    # to a creditor
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-creditors),
+    # taken against a Direct Debit mandate
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-mandates).
     #
-    # GoCardless will notify you via a [webhook](#appendix-webhooks) whenever
-    # the state of a payment changes.
+    # GoCardless will notify you via a webhook
+    # (https://developer.gocardless.com/api-reference/#appendix-webhooks)
+    # whenever the state of a payment changes.
     class Payment
-      attr_reader :amount, :amount_refunded, :charge_date, :created_at, :currency, :description, :faster_ach, :fx, :id,
-                  :metadata, :reference, :retry_if_possible, :status
+      attr_reader :amount
+      attr_reader :amount_refunded
+      attr_reader :charge_date
+      attr_reader :created_at
+      attr_reader :currency
+      attr_reader :description
+      attr_reader :faster_ach
+      attr_reader :fx
+      attr_reader :id
+      attr_reader :metadata
+      attr_reader :reference
+      attr_reader :retry_if_possible
+      attr_reader :scheme
+      attr_reader :status
 
       # Initialize a payment resource instance
       # @param object [Hash] an object returned from the API
@@ -39,6 +54,7 @@ module GoCardlessPro
         @metadata = object['metadata']
         @reference = object['reference']
         @retry_if_possible = object['retry_if_possible']
+        @scheme = object['scheme']
         @status = object['status']
         @response = response
       end

data/lib/gocardless_pro/resources/payment_account.rb

@@ -0,0 +1,64 @@
+#
+# 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 payment_account resource returned from the API
+
+    # Access the details of bank accounts provided for you by GoCardless that
+    # are used to fund Outbound Payments
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-outbound-payments).
+    class PaymentAccount
+      attr_reader :account_balance
+      attr_reader :account_holder_name
+      attr_reader :account_number_ending
+      attr_reader :bank_name
+      attr_reader :currency
+      attr_reader :id
+
+      # Initialize a payment_account resource instance
+      # @param object [Hash] an object returned from the API
+      def initialize(object, response = nil)
+        @object = object
+
+        @account_balance = object['account_balance']
+        @account_holder_name = object['account_holder_name']
+        @account_number_ending = object['account_number_ending']
+        @bank_name = object['bank_name']
+        @currency = object['currency']
+        @id = object['id']
+        @links = object['links']
+        @response = response
+      end
+
+      def api_response
+        ApiResponse.new(@response)
+      end
+
+      # Return the links that the resource has
+      def links
+        @payment_account_links ||= Links.new(@links)
+      end
+
+      # Provides the payment_account resource as a hash of all its readable attributes
+      def to_h
+        @object
+      end
+
+      class Links
+        def initialize(links)
+          @links = links || {}
+        end
+
+        def creditor
+          @links['creditor']
+        end
+      end
+    end
+  end
+end

data/lib/gocardless_pro/resources/payment_account_transaction.rb

@@ -0,0 +1,79 @@
+#
+# 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 payment_account_transaction resource returned from the API
+
+    # Payment account transactions represent movements of funds on a given
+    # payment account. The payment account is provisioned by GoCardless and is
+    # used to fund outbound payments
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-outbound-payments).
+    class PaymentAccountTransaction
+      attr_reader :amount
+      attr_reader :balance_after_transaction
+      attr_reader :counterparty_name
+      attr_reader :currency
+      attr_reader :description
+      attr_reader :direction
+      attr_reader :id
+      attr_reader :reference
+      attr_reader :value_date
+
+      # Initialize a payment_account_transaction resource instance
+      # @param object [Hash] an object returned from the API
+      def initialize(object, response = nil)
+        @object = object
+
+        @amount = object['amount']
+        @balance_after_transaction = object['balance_after_transaction']
+        @counterparty_name = object['counterparty_name']
+        @currency = object['currency']
+        @description = object['description']
+        @direction = object['direction']
+        @id = object['id']
+        @links = object['links']
+        @reference = object['reference']
+        @value_date = object['value_date']
+        @response = response
+      end
+
+      def api_response
+        ApiResponse.new(@response)
+      end
+
+      # Return the links that the resource has
+      def links
+        @payment_account_transaction_links ||= Links.new(@links)
+      end
+
+      # Provides the payment_account_transaction resource as a hash of all its readable attributes
+      def to_h
+        @object
+      end
+
+      class Links
+        def initialize(links)
+          @links = links || {}
+        end
+
+        def outbound_payment
+          @links['outbound_payment']
+        end
+
+        def payment_bank_account
+          @links['payment_bank_account']
+        end
+
+        def payout
+          @links['payout']
+        end
+      end
+    end
+  end
+end

data/lib/gocardless_pro/resources/payout.rb

@@ -10,15 +10,26 @@ module GoCardlessPro
   module Resources
     # Represents an instance of a payout resource returned from the API
 
-    # Payouts represent transfers from GoCardless to a
-    # [creditor](#core-endpoints-creditors). Each payout contains the funds
-    # collected from one or many [payments](#core-endpoints-payments). All the
-    # payments in a payout will have been collected in the same currency.
-    # Payouts are created automatically after a payment has been successfully
-    # collected.
+    # Payouts represent transfers from GoCardless to a creditor
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-creditors).
+    # Each payout contains the funds collected from one or many payments
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-payments).
+    # All the payments in a payout will have been collected in the same
+    # currency. Payouts are created automatically after a payment has been
+    # successfully collected.
     class Payout
-      attr_reader :amount, :arrival_date, :created_at, :currency, :deducted_fees, :fx, :id, :metadata, :payout_type,
-                  :reference, :status, :tax_currency
+      attr_reader :amount
+      attr_reader :arrival_date
+      attr_reader :created_at
+      attr_reader :currency
+      attr_reader :deducted_fees
+      attr_reader :fx
+      attr_reader :id
+      attr_reader :metadata
+      attr_reader :payout_type
+      attr_reader :reference
+      attr_reader :status
+      attr_reader :tax_currency
 
       # Initialize a payout resource instance
       # @param object [Hash] an object returned from the API

data/lib/gocardless_pro/resources/payout_item.rb

@@ -30,10 +30,11 @@ module GoCardlessPro
     # retrieved for payouts
     # created in the last 6 months. Requests for older payouts will return an
     # HTTP status
-    # <code>410 Gone</code>.
-    #
+    # 410 Gone.
     class PayoutItem
-      attr_reader :amount, :taxes, :type
+      attr_reader :amount
+      attr_reader :taxes
+      attr_reader :type
 
       # Initialize a payout_item resource instance
       # @param object [Hash] an object returned from the API

data/lib/gocardless_pro/resources/redirect_flow.rb

@@ -10,38 +10,49 @@ module GoCardlessPro
   module Resources
     # Represents an instance of a redirect_flow resource returned from the API
 
-    # <p class="deprecated-notice"><strong>Deprecated</strong>: Redirect Flows
-    # are legacy APIs and cannot be used by new integrators.
-    #     The [Billing Request flow](#billing-requests) API should be used for
-    # your payment flows.</p>
+    # Deprecated: Redirect Flows are legacy APIs and cannot be used by new
+    # integrators.
+    # The Billing Request flow
+    # (https://developer.gocardless.com/api-reference/#billing-requests) API
+    # should be used for your payment flows.
     #
-    # Redirect flows enable you to use GoCardless' [hosted payment
-    # pages](https://pay-sandbox.gocardless.com/AL000000AKFPFF) to set up
-    # mandates with your customers. These pages are fully compliant and have
-    # been translated into Danish, Dutch, French, German, Italian, Norwegian,
+    # Redirect flows enable you to use GoCardless' hosted payment pages
+    # (https://pay-sandbox.gocardless.com/AL000000AKFPFF) to set up mandates
+    # with your customers. These pages are fully compliant and have been
+    # translated into Danish, Dutch, French, German, Italian, Norwegian,
     # Portuguese, Slovak, Spanish and Swedish.
     #
     # The overall flow is:
     #
-    # 1. You [create](#redirect-flows-create-a-redirect-flow) a redirect flow
-    # for your customer, and redirect them to the returned redirect url, e.g.
-    # `https://pay.gocardless.com/flow/RE123`.
-    #
-    # 2. Your customer supplies their name, email, address, and bank account
+    # 1.
+    # You create
+    # (https://developer.gocardless.com/api-reference/#redirect-flows-create-a-redirect-flow)
+    # a redirect flow for your customer, and redirect them to the returned
+    # redirect url, e.g. `https://pay.gocardless.com/flow/RE123`.
+    # 2.
+    # Your customer supplies their name, email, address, and bank account
     # details, and submits the form. This securely stores their details, and
     # redirects them back to your `success_redirect_url` with
     # `redirect_flow_id=RE123` in the querystring.
+    # 3.
+    # You complete
+    # (https://developer.gocardless.com/api-reference/#redirect-flows-complete-a-redirect-flow)
+    # the redirect flow, which creates a customer
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-customers),
+    # customer bank account
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-customer-bank-accounts),
+    # and mandate
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-mandates),
+    # and returns the ID of the mandate. You may wish to create a subscription
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-subscriptions)
+    # or payment
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-payments)
+    # at this point.
     #
-    # 3. You [complete](#redirect-flows-complete-a-redirect-flow) the redirect
-    # flow, which creates a [customer](#core-endpoints-customers), [customer
-    # bank account](#core-endpoints-customer-bank-accounts), and
-    # [mandate](#core-endpoints-mandates), and returns the ID of the mandate.
-    # You may wish to create a [subscription](#core-endpoints-subscriptions) or
-    # [payment](#core-endpoints-payments) at this point.
-    #
-    # Once you have [completed](#redirect-flows-complete-a-redirect-flow) the
-    # redirect flow via the API, you should display a confirmation page to your
-    # customer, confirming that their Direct Debit has been set up. You can
+    # Once you have completed
+    # (https://developer.gocardless.com/api-reference/#redirect-flows-complete-a-redirect-flow)
+    # the redirect flow via the API, you should display a confirmation page to
+    # your customer, confirming that their Direct Debit has been set up. You can
     # build your own page, or redirect to the one we provide in the
     # `confirmation_url` attribute of the redirect flow.
     #
@@ -49,8 +60,16 @@ module GoCardlessPro
     # complete an expired redirect flow. For an integrator this is shorter and
     # they will expire after 10 minutes.
     class RedirectFlow
-      attr_reader :confirmation_url, :created_at, :description, :id, :mandate_reference, :metadata, :redirect_url,
-                  :scheme, :session_token, :success_redirect_url
+      attr_reader :confirmation_url
+      attr_reader :created_at
+      attr_reader :description
+      attr_reader :id
+      attr_reader :mandate_reference
+      attr_reader :metadata
+      attr_reader :redirect_url
+      attr_reader :scheme
+      attr_reader :session_token
+      attr_reader :success_redirect_url
 
       # Initialize a redirect_flow resource instance
       # @param object [Hash] an object returned from the API

data/lib/gocardless_pro/resources/refund.rb

@@ -10,15 +10,24 @@ module GoCardlessPro
   module Resources
     # Represents an instance of a refund resource returned from the API
 
-    # Refund objects represent (partial) refunds of a
-    # [payment](#core-endpoints-payments) back to the
-    # [customer](#core-endpoints-customers).
+    # Refund objects represent (partial) refunds of a payment
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-payments)
+    # back to the customer
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-customers).
     #
-    # GoCardless will notify you via a [webhook](#appendix-webhooks) whenever a
-    # refund is created, and will update the `amount_refunded` property of the
-    # payment.
+    # GoCardless will notify you via a webhook
+    # (https://developer.gocardless.com/api-reference/#appendix-webhooks)
+    # whenever a refund is created, and will update the `amount_refunded`
+    # property of the payment.
     class Refund
-      attr_reader :amount, :created_at, :currency, :fx, :id, :metadata, :reference, :status
+      attr_reader :amount
+      attr_reader :created_at
+      attr_reader :currency
+      attr_reader :fx
+      attr_reader :id
+      attr_reader :metadata
+      attr_reader :reference
+      attr_reader :status
 
       # Initialize a refund resource instance
       # @param object [Hash] an object returned from the API

data/lib/gocardless_pro/resources/scheme_identifier.rb

@@ -13,10 +13,25 @@ module GoCardlessPro
     # This represents a scheme identifier (e.g. a SUN in Bacs or a CID in SEPA).
     # Scheme identifiers are used to specify the beneficiary name that appears
     # on customers' bank statements.
-    #
     class SchemeIdentifier
-      attr_reader :address_line1, :address_line2, :address_line3, :can_specify_mandate_reference, :city, :country_code,
-                  :created_at, :currency, :email, :id, :minimum_advance_notice, :name, :phone_number, :postal_code, :reference, :region, :scheme, :status
+      attr_reader :address_line1
+      attr_reader :address_line2
+      attr_reader :address_line3
+      attr_reader :can_specify_mandate_reference
+      attr_reader :city
+      attr_reader :country_code
+      attr_reader :created_at
+      attr_reader :currency
+      attr_reader :email
+      attr_reader :id
+      attr_reader :minimum_advance_notice
+      attr_reader :name
+      attr_reader :phone_number
+      attr_reader :postal_code
+      attr_reader :reference
+      attr_reader :region
+      attr_reader :scheme
+      attr_reader :status
 
       # Initialize a scheme_identifier resource instance
       # @param object [Hash] an object returned from the API

data/lib/gocardless_pro/resources/subscription.rb

@@ -10,21 +10,24 @@ module GoCardlessPro
   module Resources
     # Represents an instance of a subscription resource returned from the API
 
-    # Subscriptions create [payments](#core-endpoints-payments) according to a
-    # schedule.
+    # Subscriptions create payments
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-payments)
+    # according to a schedule.
     #
-    # ### Recurrence Rules
+    # Recurrence Rules
     #
     # The following rules apply when specifying recurrence:
     #
     # - If `day_of_month` and `start_date` are not provided `start_date` will be
-    # the [mandate](#core-endpoints-mandates)'s `next_possible_charge_date` and
-    # the subscription will then recur based on the `interval` & `interval_unit`
+    # the mandate
+    # (https://developer.gocardless.com/api-reference/#core-endpoints-mandates)'s
+    # `next_possible_charge_date` and the subscription will then recur based on
+    # the `interval` & `interval_unit`
     # - If `month` or `day_of_month` are present the following validations
     # apply:
     #
-    # | __interval_unit__ | __month__                                      |
-    # __day_of_month__                           |
+    # | interval_unit | month                                      |
+    # day_of_month                           |
     # | :---------------- | :--------------------------------------------- |
     # :----------------------------------------- |
     # | yearly            | optional (required if `day_of_month` provided) |
@@ -36,8 +39,8 @@ module GoCardlessPro
     #
     # Examples:
     #
-    # | __interval_unit__ | __interval__ | __month__ | __day_of_month__ | valid?
-    #                                             |
+    # | interval_unit | interval | month | day_of_month | valid?
+    #                             |
     # | :---------------- | :----------- | :-------- | :--------------- |
     # :------------------------------------------------- |
     # | yearly            | 1            | january   | -1               | valid
@@ -57,19 +60,37 @@ module GoCardlessPro
     # | weekly            | 2            | october   | 10               |
     # invalid - `month` and `day_of_month` must be blank |
     #
-    # ### Rolling dates
+    # Rolling dates
     #
     # When a charge date falls on a non-business day, one of two things will
     # happen:
     #
     # - if the recurrence rule specified `-1` as the `day_of_month`, the charge
-    # date will be rolled __backwards__ to the previous business day (i.e., the
-    # last working day of the month).
-    # - otherwise the charge date will be rolled __forwards__ to the next
-    # business day.
+    # date will be rolled backwards to the previous business day (i.e., the last
+    # working day of the month).
+    # - otherwise the charge date will be rolled forwards to the next business
+    # day.
     class Subscription
-      attr_reader :amount, :app_fee, :count, :created_at, :currency, :day_of_month, :earliest_charge_date_after_resume,
-                  :end_date, :id, :interval, :interval_unit, :metadata, :month, :name, :parent_plan_paused, :payment_reference, :retry_if_possible, :start_date, :status, :upcoming_payments
+      attr_reader :amount
+      attr_reader :app_fee
+      attr_reader :count
+      attr_reader :created_at
+      attr_reader :currency
+      attr_reader :day_of_month
+      attr_reader :earliest_charge_date_after_resume
+      attr_reader :end_date
+      attr_reader :id
+      attr_reader :interval
+      attr_reader :interval_unit
+      attr_reader :metadata
+      attr_reader :month
+      attr_reader :name
+      attr_reader :parent_plan_paused
+      attr_reader :payment_reference
+      attr_reader :retry_if_possible
+      attr_reader :start_date
+      attr_reader :status
+      attr_reader :upcoming_payments
 
       # Initialize a subscription resource instance
       # @param object [Hash] an object returned from the API