recurly 4.32.0 → 4.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83a909b2f7399097843487765258bb382ccabe06c2f632d8d56a939451e8768a
-  data.tar.gz: 95526afe049b9a83bb167da58b41c04f818fb93936343125623cd1464814fb1c
+  metadata.gz: 1d58e029341b54321e97343bfaec205f5bc54ff3dc701dce3e14b61aab34be77
+  data.tar.gz: 0bf3d6ec35a4902fe4b70036287e65b146bfa541b2e6c0689e34180c663decf1
 SHA512:
-  metadata.gz: 75460a84c7a5fdc3b017a29e00595e0509a9b2e072d25dea98c087340fe0e7d387346f3820154fdd8060d683866dc51e6f2b82db0ddaa0637582ae0515df490e
-  data.tar.gz: 508658c6f25027f7af50bae75683f23160a991aad6610179f50000d610754ee54ebccfbca194e6f9d7b206413b7b19ba3429104e9495b10f4f074628385bd59d
+  metadata.gz: 5e90264d1c835e0fab6a9c59346deb9833799e9d0366a9be770293a85e0a5f65cd86503c17adc684652374b9b78c31539f24cd6bf92d55096e446ad11a28657b
+  data.tar.gz: d3717f71919f049cb49bc0ad797d6a9d9d33a7c2214df50fcb3cd295195038f75422d21c019b0e2f52b1c9a1ab256edcfac355aefd17b9203a6b7a6be39d5f18

data/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 4.32.0
+current_version = 4.34.0
 parse = (?P<major>\d+)
 	\.(?P<minor>\d+)
 	\.(?P<patch>\d+)

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [4.34.0](https://github.com/recurly/recurly-client-ruby/tree/4.34.0) (2023-04-26)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.33.0...4.34.0)
+
+
+**Merged Pull Requests**
+
+- Generated Latest Changes for v2021-02-25 (used_tax_service on Invoice) [#839](https://github.com/recurly/recurly-client-ruby/pull/839) ([recurly-integrations](https://github.com/recurly-integrations))
+
+
+
+## [4.33.0](https://github.com/recurly/recurly-client-ruby/tree/4.33.0) (2023-04-13)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.32.0...4.33.0)
+
+
+**Merged Pull Requests**
+
+- Generated Latest Changes for v2021-02-25 (External Accounts) [#836](https://github.com/recurly/recurly-client-ruby/pull/836) ([recurly-integrations](https://github.com/recurly-integrations))
+
+
+
 ## [4.32.0](https://github.com/recurly/recurly-client-ruby/tree/4.32.0) (2023-04-05)
 
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.31.0...4.32.0)

data/GETTING_STARTED.md

@@ -5,7 +5,7 @@ This repository houses the official ruby client for Recurly's V3 API.
 In your Gemfile, add `recurly` as a dependency.
 
 ```ruby
-gem 'recurly', '~> 4.32'
+gem 'recurly', '~> 4.34'
 ```
 
 > *Note*: We try to follow [semantic versioning](https://semver.org/) and will only apply breaking changes to major versions.

data/lib/recurly/client/operations.rb

@@ -750,6 +750,81 @@ module Recurly
       pager(path, **options)
     end
 
+    # List external accounts for an account
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_external_account list_account_external_account api documentation}
+    #
+    # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Pager<Resources::ExternalAccount>] A list of external accounts on an account.
+    #
+    def list_account_external_account(account_id:, **options)
+      path = interpolate_path("/accounts/{account_id}/external_accounts", account_id: account_id)
+      pager(path, **options)
+    end
+
+    # Create an external account
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_account_external_account create_account_external_account api documentation}
+    #
+    # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
+    # @param body [Requests::ExternalAccountCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ExternalAccountCreate}
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::ExternalAccount] A representation of the created external_account.
+    #
+    def create_account_external_account(account_id:, body:, **options)
+      path = interpolate_path("/accounts/{account_id}/external_accounts", account_id: account_id)
+      post(path, body, Requests::ExternalAccountCreate, **options)
+    end
+
+    # Get an external account for an account
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_account_external_account get_account_external_account api documentation}
+    #
+    # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
+    # @param external_account_id [String] External account ID, e.g. +s28zov4fw0cb+.
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::ExternalAccount] A external account on an account.
+    #
+    def get_account_external_account(account_id:, external_account_id:, **options)
+      path = interpolate_path("/accounts/{account_id}/external_accounts/{external_account_id}", account_id: account_id, external_account_id: external_account_id)
+      get(path, **options)
+    end
+
+    # Update an external account
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/update_account_external_account update_account_external_account api documentation}
+    #
+    # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
+    # @param external_account_id [String] External account ID, e.g. +s28zov4fw0cb+.
+    # @param body [Requests::ExternalAccountUpdate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::ExternalAccountUpdate}
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::ExternalAccount] A representation of the updated external_account.
+    #
+    def update_account_external_account(account_id:, external_account_id:, body:, **options)
+      path = interpolate_path("/accounts/{account_id}/external_accounts/{external_account_id}", account_id: account_id, external_account_id: external_account_id)
+      put(path, body, Requests::ExternalAccountUpdate, **options)
+    end
+
+    # Delete an external account for an account
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/delete_account_external_account delete_account_external_account api documentation}
+    #
+    # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
+    # @param external_account_id [String] External account ID, e.g. +s28zov4fw0cb+.
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::ExternalAccount] Successful Delete
+    #
+    def delete_account_external_account(account_id:, external_account_id:, **options)
+      path = interpolate_path("/accounts/{account_id}/external_accounts/{external_account_id}", account_id: account_id, external_account_id: external_account_id)
+      delete(path, **options)
+    end
+
     # List the external invoices on an account
     #
     # {https://developers.recurly.com/api/v2021-02-25#operation/list_account_external_invoices list_account_external_invoices api documentation}

data/lib/recurly/requests/account_create.rb

@@ -50,6 +50,10 @@ module Recurly
       #   @return [String] The tax exemption certificate number for the account. If the merchant has an integration for the Vertex tax provider, this optional value will be sent in any tax calculation requests for the account.
       define_attribute :exemption_certificate, String
 
+      # @!attribute external_accounts
+      #   @return [Array[ExternalAccountCreate]] External Accounts
+      define_attribute :external_accounts, Array, { :item_type => :ExternalAccountCreate }
+
       # @!attribute first_name
       #   @return [String]
       define_attribute :first_name, String

data/lib/recurly/requests/external_account_create.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Requests
+    class ExternalAccountCreate < Request
+
+      # @!attribute external_account_code
+      #   @return [String] Represents the account code for the external account.
+      define_attribute :external_account_code, String
+
+      # @!attribute external_connection_type
+      #   @return [String] Represents the connection type. `AppleAppStore` or `GooglePlayStore`
+      define_attribute :external_connection_type, String
+    end
+  end
+end

data/lib/recurly/requests/external_account_update.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Requests
+    class ExternalAccountUpdate < Request
+
+      # @!attribute external_account_code
+      #   @return [String] Represents the account code for the external account.
+      define_attribute :external_account_code, String
+
+      # @!attribute external_connection_type
+      #   @return [String] Represents the connection type. `AppleAppStore` or `GooglePlayStore`
+      define_attribute :external_connection_type, String
+    end
+  end
+end

data/lib/recurly/resources/account.rb

@@ -54,6 +54,10 @@ module Recurly
       #   @return [String] The tax exemption certificate number for the account. If the merchant has an integration for the Vertex tax provider, this optional value will be sent in any tax calculation requests for the account.
       define_attribute :exemption_certificate, String
 
+      # @!attribute external_accounts
+      #   @return [Array[ExternalAccount]] The external accounts belonging to this account
+      define_attribute :external_accounts, Array, { :item_type => :ExternalAccount }
+
       # @!attribute first_name
       #   @return [String]
       define_attribute :first_name, String

data/lib/recurly/resources/external_account.rb

@@ -0,0 +1,34 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class ExternalAccount < Resource
+
+      # @!attribute created_at
+      #   @return [DateTime] Created at
+      define_attribute :created_at, DateTime
+
+      # @!attribute external_account_code
+      #   @return [String] Represents the account code for the external account.
+      define_attribute :external_account_code, String
+
+      # @!attribute external_connection_type
+      #   @return [String] Represents the connection type. `AppleAppStore` or `GooglePlayStore`
+      define_attribute :external_connection_type, String
+
+      # @!attribute id
+      #   @return [String] UUID of the external_account .
+      define_attribute :id, String
+
+      # @!attribute object
+      #   @return [String]
+      define_attribute :object, String
+
+      # @!attribute updated_at
+      #   @return [DateTime] Last updated at
+      define_attribute :updated_at, DateTime
+    end
+  end
+end

data/lib/recurly/resources/invoice.rb

@@ -154,6 +154,10 @@ module Recurly
       #   @return [DateTime] Last updated at
       define_attribute :updated_at, DateTime
 
+      # @!attribute used_tax_service
+      #   @return [Boolean] Will be `true` when the invoice had a successful response from the tax service and `false` when the invoice was not sent to tax service due to a lack of address or enabled jurisdiction or was processed without tax due to a non-blocking error returned from the tax service.
+      define_attribute :used_tax_service, :Boolean
+
       # @!attribute uuid
       #   @return [String] Invoice UUID
       define_attribute :uuid, String

data/lib/recurly/version.rb

@@ -1,3 +1,3 @@
 module Recurly
-  VERSION = "4.32.0"
+  VERSION = "4.34.0"
 end

data/openapi/api.yaml

@@ -202,6 +202,7 @@ x-tagGroups:
   - external_subscriptions
   - external_invoices
   - external_products
+  - external_accounts
   - gift_cards
 - name: Products and Promotions
   tags:
@@ -361,6 +362,11 @@ tags:
   x-displayName: Gift Cards
   description: Add gift card purchases to your checkout and allow gift card recipients
     to redeem the gift card for credit towards any of your products.
+- name: external_accounts
+  x-displayName: External Accounts
+  description: An account from an external resource that is not managed by the Recurly
+    platform and instead is managed by third-party platforms like Apple App Store
+    and Google Play Store.
 paths:
   "/sites":
     get:
@@ -3250,6 +3256,208 @@ paths:
           := err.(*recurly.Error); ok {\n\t\tfmt.Printf(\"Failed to retrieve next
           page: %v\", e)\n\t\tbreak\n\t}\n\tfor i, creditPayment := range creditPayments.Data()
           {\n\t\tfmt.Printf(\"Account Credit Payment %3d: %s\\n\",\n\t\t\ti,\n\t\t\tcreditPayment.Id,\n\t\t)\n\t}\n}"
+  "/accounts/{account_id}/external_accounts":
+    parameters:
+    - "$ref": "#/components/parameters/account_id"
+    get:
+      tags:
+      - external_accounts
+      operationId: list_account_external_account
+      summary: List external accounts for an account
+      responses:
+        '200':
+          description: A list of external accounts on an account.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ExternalAccountList"
+        '404':
+          description: Incorrect account or external_account ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '406':
+          description: Unavailable API version
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Feature not enabled on site
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    post:
+      tags:
+      - external_accounts
+      operationId: create_account_external_account
+      summary: Create an external account
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/ExternalAccountCreate"
+      responses:
+        '200':
+          description: A representation of the created external_account.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ExternalAccount"
+        '404':
+          description: Incorrect account or external_account ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '406':
+          description: Unavailable API version
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Feature not enabled on site
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+  "/accounts/{account_id}/external_accounts/{external_account_id}":
+    parameters:
+    - "$ref": "#/components/parameters/account_id"
+    - "$ref": "#/components/parameters/external_account_id"
+    get:
+      tags:
+      - external_accounts
+      operationId: get_account_external_account
+      summary: Get an external account for an account
+      responses:
+        '200':
+          description: A external account on an account.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ExternalAccount"
+        '404':
+          description: Incorrect account or external_account ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '406':
+          description: Unavailable API version
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Feature not enabled on site
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    put:
+      tags:
+      - external_accounts
+      operationId: update_account_external_account
+      summary: Update an external account
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/ExternalAccountUpdate"
+      responses:
+        '200':
+          description: A representation of the updated external_account.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ExternalAccount"
+        '404':
+          description: Incorrect account or external_account ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '406':
+          description: Unavailable API version
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Feature not enabled on site
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+    delete:
+      tags:
+      - external_accounts
+      operationId: delete_account_external_account
+      summary: Delete an external account for an account
+      responses:
+        '200':
+          description: Successful Delete
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ExternalAccount"
+        '404':
+          description: External Account not found
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '406':
+          description: Unavailable API version
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Feature not enabled on site
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
   "/accounts/{account_id}/external_invoices":
     parameters:
     - "$ref": "#/components/parameters/account_id"
@@ -15783,6 +15991,13 @@ components:
       required: true
       schema:
         type: string
+    external_account_id:
+      name: external_account_id
+      in: path
+      description: External account ID, e.g. `s28zov4fw0cb`.
+      required: true
+      schema:
+        type: string
     external_invoice_id:
       name: external_invoice_id
       in: path
@@ -16566,6 +16781,11 @@ components:
             maxLength: 50
           acquisition:
             "$ref": "#/components/schemas/AccountAcquisitionUpdate"
+          external_accounts:
+            type: array
+            title: External Accounts
+            items:
+              "$ref": "#/components/schemas/ExternalAccountCreate"
           shipping_addresses:
             type: array
             items:
@@ -16763,6 +16983,11 @@ components:
             merchant has an integration for the Vertex tax provider, this optional
             value will be sent in any tax calculation requests for the account.
           maxLength: 30
+        external_accounts:
+          type: array
+          description: The external accounts belonging to this account
+          items:
+            "$ref": "#/components/schemas/ExternalAccount"
         parent_account_id:
           type: string
           maxLength: 13
@@ -18807,6 +19032,13 @@ components:
           description: The outstanding balance remaining on this invoice.
         tax_info:
           "$ref": "#/components/schemas/TaxInfo"
+        used_tax_service:
+          type: boolean
+          title: Used Tax Service?
+          description: Will be `true` when the invoice had a successful response from
+            the tax service and `false` when the invoice was not sent to tax service
+            due to a lack of address or enabled jurisdiction or was processed without
+            tax due to a non-blocking error returned from the tax service.
         vat_number:
           type: string
           title: VAT number
@@ -22951,6 +23183,70 @@ components:
           type: array
           items:
             "$ref": "#/components/schemas/ExternalProduct"
+    ExternalAccountList:
+      type: object
+      properties:
+        object:
+          type: string
+          title: Object type
+          description: Will always be List.
+        has_more:
+          type: boolean
+          description: Indicates there are more results on subsequent pages.
+        next:
+          type: string
+          description: Path to subsequent page of results.
+        data:
+          type: array
+          items:
+            "$ref": "#/components/schemas/ExternalAccount"
+    ExternalAccountCreate:
+      type: object
+      properties:
+        external_account_code:
+          type: string
+          description: Represents the account code for the external account.
+        external_connection_type:
+          type: string
+          description: Represents the connection type. `AppleAppStore` or `GooglePlayStore`
+      required:
+      - external_account_code
+      - external_connection_type
+    ExternalAccountUpdate:
+      type: object
+      properties:
+        external_account_code:
+          type: string
+          description: Represents the account code for the external account.
+        external_connection_type:
+          type: string
+          description: Represents the connection type. `AppleAppStore` or `GooglePlayStore`
+    ExternalAccount:
+      type: object
+      title: External Account
+      properties:
+        object:
+          type: string
+          default: external_account
+        id:
+          type: string
+          description: UUID of the external_account .
+        external_account_code:
+          type: string
+          description: Represents the account code for the external account.
+        external_connection_type:
+          type: string
+          description: Represents the connection type. `AppleAppStore` or `GooglePlayStore`
+        created_at:
+          type: string
+          format: date-time
+          description: Created at
+          readOnly: true
+        updated_at:
+          type: string
+          format: date-time
+          description: Last updated at
+          readOnly: true
     ExternalProductReferenceMini:
       type: object
       title: External Product Reference details
@@ -23754,7 +24050,9 @@ components:
       - es-MX
       - es-US
       - fi-FI
+      - fr-BE
       - fr-CA
+      - fr-CH
       - fr-FR
       - hi-IN
       - it-IT

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: recurly
 version: !ruby/object:Gem::Version
-  version: 4.32.0
+  version: 4.34.0
 platform: ruby
 authors:
 - Recurly
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-05 00:00:00.000000000 Z
+date: 2023-04-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -166,6 +166,8 @@ files:
 - lib/recurly/requests/coupon_update.rb
 - lib/recurly/requests/custom_field.rb
 - lib/recurly/requests/dunning_campaigns_bulk_update.rb
+- lib/recurly/requests/external_account_create.rb
+- lib/recurly/requests/external_account_update.rb
 - lib/recurly/requests/external_refund.rb
 - lib/recurly/requests/external_transaction.rb
 - lib/recurly/requests/gift_card_create.rb
@@ -256,6 +258,7 @@ files:
 - lib/recurly/resources/export_dates.rb
 - lib/recurly/resources/export_file.rb
 - lib/recurly/resources/export_files.rb
+- lib/recurly/resources/external_account.rb
 - lib/recurly/resources/external_charge.rb
 - lib/recurly/resources/external_invoice.rb
 - lib/recurly/resources/external_product.rb
@@ -333,7 +336,7 @@ metadata:
   changelog_uri: https://github.com/recurly/recurly-client-ruby/blob/master/CHANGELOG.md
   documentation_uri: https://recurly.github.io/recurly-client-ruby/
   homepage_uri: https://github.com/recurly/recurly-client-ruby
-  source_code_uri: https://github.com/recurly/recurly-client-ruby/tree/4.32.0
+  source_code_uri: https://github.com/recurly/recurly-client-ruby/tree/4.34.0
 post_install_message: 
 rdoc_options: []
 require_paths: