recurly 4.27.0 → 4.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 640a24b929e9682d7617c76acc1a64e15e7ffab1911caf2c451d87a66879636b
-  data.tar.gz: 3f8a5c5064c8e7171dc6e6b0ff7159c4da7bb6e483795053455a0cd46024525e
+  metadata.gz: 0a12c336abc5627ae6108c79356cc295fdab9e5417fc932a7bcf41192fc08e1a
+  data.tar.gz: 4f2125b55ea52e1afe80feda3c48ad6e3688c879ffa1ccd954180f721a4bf4d2
 SHA512:
-  metadata.gz: add90da54e5859f423bb14382674297aab1cd4807e3238c31bb7b8edc23ee2c963efa0acdeae40a4943678960d375c1d19dfea7666c753b422e54782c5cc1d7f
-  data.tar.gz: 116106098e2251a1cf36031e2f15e51853052ffe7ec5da674a441a1b231ae3b81327cb00264d7cab48e43b4c925ae21c39b7d979c89e3082e39208b263d29e0f
+  metadata.gz: 7e717e56f0f8fd73609e0c500f2dc6162450db20c20760d529e32e5c6c530169e1ff359a13d97c2a06fed6e059cec561a38db9142020b248854d7086108b45da
+  data.tar.gz: 8f99005efd5625d1dfaa9fa9e1f56ea8128b85234b14990e8ba95f806fc52f79b1429c7f4d778d2cf94803b2b000354843687d2aa54b9b50ed0d0ee8cd3a4e61

data/.bumpversion.cfg

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

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [4.29.0](https://github.com/recurly/recurly-client-ruby/tree/4.29.0) (2023-02-07)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.28.0...4.29.0)
+
+
+**Merged Pull Requests**
+
+- Generated Latest Changes for v2021-02-25 (GiftCard endpoints and new transaction error support) [#827](https://github.com/recurly/recurly-client-ruby/pull/827) ([recurly-integrations](https://github.com/recurly-integrations))
+
+
+
+## [4.28.0](https://github.com/recurly/recurly-client-ruby/tree/4.28.0) (2023-01-19)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.27.0...4.28.0)
+
+
+**Merged Pull Requests**
+
+- Generated Latest Changes for v2021-02-25 (Custom Fields on Line Items) [#821](https://github.com/recurly/recurly-client-ruby/pull/821) ([recurly-integrations](https://github.com/recurly-integrations))
+
+
+
 ## [4.27.0](https://github.com/recurly/recurly-client-ruby/tree/4.27.0) (2023-01-11)
 
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.26.0...4.27.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.27'
+gem 'recurly', '~> 4.29'
 ```
 
 > *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

@@ -135,6 +135,7 @@ module Recurly
     #       code: account_code,
     #       first_name: "Benjamin",
     #       last_name: "Du Monde",
+    #       preferred_time_zone: "America/Chicago",
     #       acquisition: {
     #         campaign: "podcast-marketing",
     #         channel: "social_media",
@@ -4214,5 +4215,75 @@ module Recurly
       path = interpolate_path("/accounts/{account_id}/external_subscriptions", account_id: account_id)
       pager(path, **options)
     end
+
+    # List gift cards
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_gift_cards list_gift_cards api documentation}
+    #
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Pager<Resources::GiftCard>] List of all created gift cards on your site.
+    #
+    def list_gift_cards(**options)
+      path = "/gift_cards"
+      pager(path, **options)
+    end
+
+    # Create gift card
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/create_gift_card create_gift_card api documentation}
+    #
+    # @param body [Requests::GiftCardCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::GiftCardCreate}
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::GiftCard] Returns the gift card
+    #
+    def create_gift_card(body:, **options)
+      path = "/gift_cards"
+      post(path, body, Requests::GiftCardCreate, **options)
+    end
+
+    # Fetch a gift card
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/get_gift_card get_gift_card api documentation}
+    #
+    # @param gift_card_id [String] Gift Card ID, e.g. +e28zov4fw0v2+.
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::GiftCard] Gift card details
+    #
+    def get_gift_card(gift_card_id:, **options)
+      path = interpolate_path("/gift_cards/{gift_card_id}", gift_card_id: gift_card_id)
+      get(path, **options)
+    end
+
+    # Preview gift card
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/preview_gift_card preview_gift_card api documentation}
+    #
+    # @param body [Requests::GiftCardCreate] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::GiftCardCreate}
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::GiftCard] Returns the gift card
+    #
+    def preview_gift_card(body:, **options)
+      path = "/gift_cards/preview"
+      post(path, body, Requests::GiftCardCreate, **options)
+    end
+
+    # Redeem gift card
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/redeem_gift_card redeem_gift_card api documentation}
+    #
+    # @param redemption_code [String] Gift Card redemption code, e.g., +N1A2T8IRXSCMO40V+.
+    # @param body [Requests::GiftCardRedeem] The Hash representing the JSON request to send to the server. It should conform to the schema of {Requests::GiftCardRedeem}
+    # @param params [Hash] Optional query string parameters:
+    #
+    # @return [Resources::GiftCard] Redeems and returns the gift card
+    #
+    def redeem_gift_card(redemption_code:, body:, **options)
+      path = interpolate_path("/gift_cards/{redemption_code}/redeem", redemption_code: redemption_code)
+      post(path, body, Requests::GiftCardRedeem, **options)
+    end
   end
 end

data/lib/recurly/requests/account_reference.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 AccountReference < Request
+
+      # @!attribute code
+      #   @return [String]
+      define_attribute :code, String
+
+      # @!attribute id
+      #   @return [String]
+      define_attribute :id, String
+    end
+  end
+end

data/lib/recurly/requests/gift_card_create.rb

@@ -0,0 +1,30 @@
+# 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 GiftCardCreate < Request
+
+      # @!attribute currency
+      #   @return [String] 3-letter ISO 4217 currency code.
+      define_attribute :currency, String
+
+      # @!attribute delivery
+      #   @return [GiftCardDeliveryCreate] The delivery details for the gift card.
+      define_attribute :delivery, :GiftCardDeliveryCreate
+
+      # @!attribute gifter_account
+      #   @return [AccountPurchase] Block of account details for the gifter. This references an existing account_code.
+      define_attribute :gifter_account, :AccountPurchase
+
+      # @!attribute product_code
+      #   @return [String] The product code or SKU of the gift card product.
+      define_attribute :product_code, String
+
+      # @!attribute unit_amount
+      #   @return [Float] The amount of the gift card, which is the amount of the charge to the gifter account and the amount of credit that is applied to the recipient account upon successful redemption.
+      define_attribute :unit_amount, Float
+    end
+  end
+end

data/lib/recurly/requests/gift_card_delivery_create.rb

@@ -0,0 +1,42 @@
+# 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 GiftCardDeliveryCreate < Request
+
+      # @!attribute deliver_at
+      #   @return [DateTime] When the gift card should be delivered to the recipient. If null, the gift card will be delivered immediately. If a datetime is provided, the delivery will be in an hourly window, rounding down. For example, 6:23 pm will be in the 6:00 pm hourly batch.
+      define_attribute :deliver_at, DateTime
+
+      # @!attribute email_address
+      #   @return [String] The email address of the recipient. Required if `method` is `email`.
+      define_attribute :email_address, String
+
+      # @!attribute first_name
+      #   @return [String] The first name of the recipient.
+      define_attribute :first_name, String
+
+      # @!attribute gifter_name
+      #   @return [String] The name of the gifter for the purpose of a message displayed to the recipient.
+      define_attribute :gifter_name, String
+
+      # @!attribute last_name
+      #   @return [String] The last name of the recipient.
+      define_attribute :last_name, String
+
+      # @!attribute method
+      #   @return [String] Whether the delivery method is email or postal service.
+      define_attribute :method, String
+
+      # @!attribute personal_message
+      #   @return [String] The personal message from the gifter to the recipient.
+      define_attribute :personal_message, String
+
+      # @!attribute recipient_address
+      #   @return [Address] Address information for the recipient. Required if `method` is `post`.
+      define_attribute :recipient_address, :Address
+    end
+  end
+end

data/lib/recurly/requests/gift_card_redeem.rb

@@ -0,0 +1,14 @@
+# 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 GiftCardRedeem < Request
+
+      # @!attribute recipient_account
+      #   @return [AccountReference] The account for the recipient of the gift card.
+      define_attribute :recipient_account, :AccountReference
+    end
+  end
+end

data/lib/recurly/requests/line_item_create.rb

@@ -26,6 +26,10 @@ module Recurly
       #   @return [String] 3-letter ISO 4217 currency code. If `item_code`/`item_id` is part of the request then `currency` is optional, if the site has a single default currency. `currency` is required if `item_code`/`item_id` is present, and there are multiple currencies defined on the site. If `item_code`/`item_id` is not present `currency` is required.
       define_attribute :currency, String
 
+      # @!attribute custom_fields
+      #   @return [Array[CustomField]] The custom fields will only be altered when they are included in a request. Sending an empty array will not remove any existing values. To remove a field send the name with a null or empty value.
+      define_attribute :custom_fields, Array, { :item_type => :CustomField }
+
       # @!attribute description
       #   @return [String] Description that appears on the invoice. If `item_code`/`item_id` is part of the request then `description` must be absent.
       define_attribute :description, String

data/lib/recurly/requests/subscription_create.rb

@@ -46,6 +46,10 @@ module Recurly
       #   @return [String] This will default to the Customer Notes text specified on the Invoice Settings. Specify custom notes to add or override Customer Notes. Custom notes will stay with a subscription on all renewals.
       define_attribute :customer_notes, String
 
+      # @!attribute gift_card_redemption_code
+      #   @return [String] A gift card redemption code to be redeemed on the purchase invoice.
+      define_attribute :gift_card_redemption_code, String
+
       # @!attribute net_terms
       #   @return [Integer] Integer representing the number of days after an invoice's creation that the invoice will become past due. If an invoice's net terms are set to '0', it is due 'On Receipt' and will become past due 24 hours after it’s created. If an invoice is due net 30, it will become past due at 31 days exactly.
       define_attribute :net_terms, Integer

data/lib/recurly/resources/gift_card.rb

@@ -0,0 +1,78 @@
+# 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 GiftCard < Resource
+
+      # @!attribute balance
+      #   @return [Float] The remaining credit on the recipient account associated with this gift card. Only has a value once the gift card has been redeemed. Can be used to create gift card balance displays for your customers.
+      define_attribute :balance, Float
+
+      # @!attribute canceled_at
+      #   @return [DateTime] When the gift card was canceled.
+      define_attribute :canceled_at, DateTime
+
+      # @!attribute created_at
+      #   @return [DateTime] Created at
+      define_attribute :created_at, DateTime
+
+      # @!attribute currency
+      #   @return [String] 3-letter ISO 4217 currency code.
+      define_attribute :currency, String
+
+      # @!attribute delivered_at
+      #   @return [DateTime] When the gift card was sent to the recipient by Recurly via email, if method was email and the "Gift Card Delivery" email template was enabled. This will be empty for post delivery or email delivery where the email template was disabled.
+      define_attribute :delivered_at, DateTime
+
+      # @!attribute delivery
+      #   @return [GiftCardDelivery] The delivery details for the gift card.
+      define_attribute :delivery, :GiftCardDelivery
+
+      # @!attribute gifter_account_id
+      #   @return [String] The ID of the account that purchased the gift card.
+      define_attribute :gifter_account_id, String
+
+      # @!attribute id
+      #   @return [String] Gift card ID
+      define_attribute :id, String
+
+      # @!attribute object
+      #   @return [String] Object type
+      define_attribute :object, String
+
+      # @!attribute product_code
+      #   @return [String] The product code or SKU of the gift card product.
+      define_attribute :product_code, String
+
+      # @!attribute purchase_invoice_id
+      #   @return [String] The ID of the invoice for the gift card purchase made by the gifter.
+      define_attribute :purchase_invoice_id, String
+
+      # @!attribute recipient_account_id
+      #   @return [String] The ID of the account that redeemed the gift card redemption code.  Does not have a value until gift card is redeemed.
+      define_attribute :recipient_account_id, String
+
+      # @!attribute redeemed_at
+      #   @return [DateTime] When the gift card was redeemed by the recipient.
+      define_attribute :redeemed_at, DateTime
+
+      # @!attribute redemption_code
+      #   @return [String] The unique redemption code for the gift card, generated by Recurly. Will be 16 characters, alphanumeric, displayed uppercase, but accepted in any case at redemption. Used by the recipient account to create a credit in the amount of the `unit_amount` on their account.
+      define_attribute :redemption_code, String
+
+      # @!attribute redemption_invoice_id
+      #   @return [String] The ID of the invoice for the gift card redemption made by the recipient.  Does not have a value until gift card is redeemed.
+      define_attribute :redemption_invoice_id, String
+
+      # @!attribute unit_amount
+      #   @return [Float] The amount of the gift card, which is the amount of the charge to the gifter account and the amount of credit that is applied to the recipient account upon successful redemption.
+      define_attribute :unit_amount, Float
+
+      # @!attribute updated_at
+      #   @return [DateTime] Last updated at
+      define_attribute :updated_at, DateTime
+    end
+  end
+end

data/lib/recurly/resources/gift_card_delivery.rb

@@ -0,0 +1,42 @@
+# 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 GiftCardDelivery < Resource
+
+      # @!attribute deliver_at
+      #   @return [DateTime] When the gift card should be delivered to the recipient. If null, the gift card will be delivered immediately. If a datetime is provided, the delivery will be in an hourly window, rounding down. For example, 6:23 pm will be in the 6:00 pm hourly batch.
+      define_attribute :deliver_at, DateTime
+
+      # @!attribute email_address
+      #   @return [String] The email address of the recipient.
+      define_attribute :email_address, String
+
+      # @!attribute first_name
+      #   @return [String] The first name of the recipient.
+      define_attribute :first_name, String
+
+      # @!attribute gifter_name
+      #   @return [String] The name of the gifter for the purpose of a message displayed to the recipient.
+      define_attribute :gifter_name, String
+
+      # @!attribute last_name
+      #   @return [String] The last name of the recipient.
+      define_attribute :last_name, String
+
+      # @!attribute method
+      #   @return [String] Whether the delivery method is email or postal service.
+      define_attribute :method, String
+
+      # @!attribute personal_message
+      #   @return [String] The personal message from the gifter to the recipient.
+      define_attribute :personal_message, String
+
+      # @!attribute recipient_address
+      #   @return [Address] Address information for the recipient.
+      define_attribute :recipient_address, :Address
+    end
+  end
+end

data/lib/recurly/resources/line_item.rb

@@ -54,6 +54,10 @@ module Recurly
       #   @return [String] 3-letter ISO 4217 currency code.
       define_attribute :currency, String
 
+      # @!attribute custom_fields
+      #   @return [Array[CustomField]] The custom fields will only be altered when they are included in a request. Sending an empty array will not remove any existing values. To remove a field send the name with a null or empty value.
+      define_attribute :custom_fields, Array, { :item_type => :CustomField }
+
       # @!attribute description
       #   @return [String] Description that appears on the invoice. For subscription related items this will be filled in automatically.
       define_attribute :description, String

data/lib/recurly/resources/subscription.rb

@@ -46,6 +46,10 @@ module Recurly
       #   @return [String] Collection method
       define_attribute :collection_method, String
 
+      # @!attribute converted_at
+      #   @return [DateTime] When the subscription was converted from a gift card.
+      define_attribute :converted_at, DateTime
+
       # @!attribute coupon_redemptions
       #   @return [Array[CouponRedemptionMini]] Returns subscription level coupon redemptions that are tied to this subscription.
       define_attribute :coupon_redemptions, Array, { :item_type => :CouponRedemptionMini }
@@ -150,6 +154,10 @@ module Recurly
       #   @return [SubscriptionShipping] Subscription shipping details
       define_attribute :shipping, :SubscriptionShipping
 
+      # @!attribute started_with_gift
+      #   @return [Boolean] Whether the subscription was started with a gift certificate.
+      define_attribute :started_with_gift, :Boolean
+
       # @!attribute state
       #   @return [String] State
       define_attribute :state, String

data/lib/recurly/resources/transaction_error.rb

@@ -14,6 +14,10 @@ module Recurly
       #   @return [String] Code
       define_attribute :code, String
 
+      # @!attribute decline_code
+      #   @return [String] Decline code
+      define_attribute :decline_code, String
+
       # @!attribute merchant_advice
       #   @return [String] Merchant message
       define_attribute :merchant_advice, String

data/lib/recurly/version.rb

@@ -1,3 +1,3 @@
 module Recurly
-  VERSION = "4.27.0"
+  VERSION = "4.29.0"
 end

data/openapi/api.yaml

@@ -201,6 +201,7 @@ x-tagGroups:
   - automated_exports
   - external_subscriptions
   - external_products
+  - gift_cards
 - name: Products and Promotions
   tags:
   - item
@@ -350,6 +351,10 @@ tags:
   description: A product 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.
+- name: gift_cards
+  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.
 paths:
   "/sites":
     get:
@@ -722,6 +727,7 @@ paths:
               code: accountCode,
               firstName: 'Benjamin',
               lastName: 'Du Monde',
+              preferredTimeZone: 'America/Chicago',
               address: {
                 street1: '900 Camp St',
                 city: 'New Orleans',
@@ -750,6 +756,7 @@ paths:
                   "code": account_code,
                   "first_name": "Benjamin",
                   "last_name": "Du Monde",
+                  "preferred_time_zone": "America/Chicago",
                   "acquisition": {
                       "campaign": "podcast-marketing",
                       "channel": "social_media",
@@ -785,6 +792,7 @@ paths:
                   Code = accountCode,
                   FirstName = "Benjamin",
                   LastName = "Du Monde",
+                  PreferredTimeZone = "America/Chicago",
                   Address = new Address()
                   {
                       City = "New Orleans",
@@ -815,6 +823,7 @@ paths:
               code: account_code,
               first_name: "Benjamin",
               last_name: "Du Monde",
+              preferred_time_zone: "America/Chicago",
               acquisition: {
                 campaign: "podcast-marketing",
                 channel: "social_media",
@@ -853,6 +862,7 @@ paths:
               accountReq.setCode(accountCode);
               accountReq.setFirstName("Aaron");
               accountReq.setLastName("Du Monde");
+              accountReq.setPreferredTimeZone("America/Chicago");
 
               address.setStreet1("900 Camp St.");
               address.setCity("New Orleans");
@@ -879,6 +889,7 @@ paths:
                   "code" => $account_code,
                   "first_name" => "Douglas",
                   "last_name" => "DuMonde",
+                  "preferred_time_zone" => "America/Chicago",
                   "shipping_addresses" => [
                       [
                           "first_name" => "Douglas",
@@ -908,17 +919,17 @@ paths:
       - lang: Go
         source: "accountReq := &recurly.AccountCreate{\n\tCode:      &accountCode,\n\tFirstName:
           recurly.String(\"Isaac\"),\n\tLastName:  recurly.String(\"Du Monde\"),\n\tEmail:
-          \    recurly.String(\"isaac@example.com\"),\n\tBillingInfo: &recurly.BillingInfoCreate{\n\t\tFirstName:
-          recurly.String(\"Isaac\"),\n\t\tLastName:  recurly.String(\"Du Monde\"),\n\t\tAddress:
-          &recurly.AddressCreate{\n\t\t\tPhone:      recurly.String(\"415-555-5555\"),\n\t\t\tStreet1:
-          \   recurly.String(\"400 Alabama St.\"),\n\t\t\tCity:       recurly.String(\"San
-          Francisco\"),\n\t\t\tPostalCode: recurly.String(\"94110\"),\n\t\t\tCountry:
-          \   recurly.String(\"US\"),\n\t\t\tRegion:     recurly.String(\"CA\"),\n\t\t},\n\t\tNumber:
-          recurly.String(\"4111111111111111\"),\n\t\tMonth:  recurly.String(\"12\"),\n\t\tYear:
-          \  recurly.String(\"22\"),\n\t\tCvv:    recurly.String(\"123\"),\n\t},\n}\n\naccount,
-          err := client.CreateAccount(accountReq)\nif e, ok := err.(*recurly.Error);
-          ok {\n\tif e.Type == recurly.ErrorTypeValidation {\n\t\tfmt.Printf(\"Failed
-          validation: %v\", e)\n\t\treturn nil, err\n\t}\n\tfmt.Printf(\"Unexpected
+          \    recurly.String(\"isaac@example.com\"),\n\tPreferredTimeZone: recurly.String(\"America/Los_Angeles\"),\n\tBillingInfo:
+          &recurly.BillingInfoCreate{\n\t\tFirstName: recurly.String(\"Isaac\"),\n\t\tLastName:
+          \ recurly.String(\"Du Monde\"),\n\t\tAddress: &recurly.AddressCreate{\n\t\t\tPhone:
+          \     recurly.String(\"415-555-5555\"),\n\t\t\tStreet1:    recurly.String(\"400
+          Alabama St.\"),\n\t\t\tCity:       recurly.String(\"San Francisco\"),\n\t\t\tPostalCode:
+          recurly.String(\"94110\"),\n\t\t\tCountry:    recurly.String(\"US\"),\n\t\t\tRegion:
+          \    recurly.String(\"CA\"),\n\t\t},\n\t\tNumber: recurly.String(\"4111111111111111\"),\n\t\tMonth:
+          \ recurly.String(\"12\"),\n\t\tYear:   recurly.String(\"22\"),\n\t\tCvv:
+          \   recurly.String(\"123\"),\n\t},\n}\n\naccount, err := client.CreateAccount(accountReq)\nif
+          e, ok := err.(*recurly.Error); ok {\n\tif e.Type == recurly.ErrorTypeValidation
+          {\n\t\tfmt.Printf(\"Failed validation: %v\", e)\n\t\treturn nil, err\n\t}\n\tfmt.Printf(\"Unexpected
           Recurly error: %v\", e)\n\treturn nil, err\n}\nfmt.Printf(\"Created Account:
           %s\", account.Id)"
   "/accounts/{account_id}":
@@ -14688,6 +14699,8 @@ paths:
         The API request allows the inclusion of one of the following fields: **external_hpp_type** with `'adyen'` and **online_banking_payment_type** with `'ideal'` or `'sofort'` in the **billing_info** object.
 
         For additional information regarding shipping fees, please see https://docs.recurly.com/docs/shipping
+
+        Note: an email address is required on the account for a Pending Purchase.
       requestBody:
         content:
           application/json:
@@ -15394,6 +15407,175 @@ paths:
               schema:
                 "$ref": "#/components/schemas/Error"
       x-code-samples: []
+  "/gift_cards":
+    get:
+      tags:
+      - gift_cards
+      operationId: list_gift_cards
+      summary: List gift cards
+      responses:
+        '200':
+          description: List of all created gift cards on your site.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/GiftCardList"
+        '404':
+          description: Incorrect 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:
+      - gift_cards
+      operationId: create_gift_card
+      summary: Create gift card
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/GiftCardCreate"
+        required: true
+      responses:
+        '201':
+          description: Returns the gift card
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/GiftCard"
+        '400':
+          description: Bad request; perhaps missing or invalid parameters.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Gift card cannot be completed for the specified reason.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+  "/gift_cards/{gift_card_id}":
+    parameters:
+    - "$ref": "#/components/parameters/gift_card_id"
+    get:
+      tags:
+      - gift_cards
+      operationId: get_gift_card
+      summary: Fetch a gift card
+      responses:
+        '200':
+          description: Gift card details
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/GiftCard"
+        '404':
+          description: Incorrect site or gift card ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+  "/gift_cards/preview":
+    post:
+      tags:
+      - gift_cards
+      operationId: preview_gift_card
+      summary: Preview gift card
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/GiftCardCreate"
+        required: true
+      responses:
+        '201':
+          description: Returns the gift card
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/GiftCard"
+        '400':
+          description: Bad request; perhaps missing or invalid parameters.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Gift card cannot be completed for the specified reason.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
+  "/gift_cards/{redemption_code}/redeem":
+    parameters:
+    - "$ref": "#/components/parameters/redemption_code"
+    post:
+      tags:
+      - gift_cards
+      operationId: redeem_gift_card
+      summary: Redeem gift card
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/GiftCardRedeem"
+        required: true
+      responses:
+        '201':
+          description: Redeems and returns the gift card
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/GiftCard"
+        '400':
+          description: Bad request; perhaps missing or invalid parameters.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        '422':
+          description: Gift card cannot be redeemed for the specified reason.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
 servers:
 - url: https://v3.recurly.com
 - url: https://v3.eu.recurly.com
@@ -15568,6 +15750,20 @@ components:
       required: true
       schema:
         type: string
+    gift_card_id:
+      name: gift_card_id
+      in: path
+      description: Gift Card ID, e.g. `e28zov4fw0v2`.
+      required: true
+      schema:
+        type: string
+    redemption_code:
+      name: redemption_code
+      in: path
+      description: Gift Card redemption code, e.g., `N1A2T8IRXSCMO40V`.
+      required: true
+      schema:
+        type: string
     ids:
       name: ids
       in: query
@@ -16249,6 +16445,15 @@ components:
         required:
         - code
       - "$ref": "#/components/schemas/AccountUpdate"
+    AccountReference:
+      type: object
+      properties:
+        id:
+          type: string
+          maxLength: 13
+        code:
+          type: string
+          maxLength: 50
     AccountUpdate:
       type: object
       properties:
@@ -19133,6 +19338,8 @@ components:
           format: date-time
           title: End date
           description: If this date is provided, it indicates the end of a time range.
+        custom_fields:
+          "$ref": "#/components/schemas/CustomFields"
         created_at:
           type: string
           format: date-time
@@ -19299,6 +19506,8 @@ components:
             true.  This origin creates a charge and opposite credit on the account
             to be used for future invoices.
           "$ref": "#/components/schemas/LineItemCreateOriginEnum"
+        custom_fields:
+          "$ref": "#/components/schemas/CustomFields"
         start_date:
           type: string
           format: date-time
@@ -20709,6 +20918,16 @@ components:
             subscription.
           maxLength: 13
           readOnly: true
+        started_with_gift:
+          type: boolean
+          default: false
+          description: Whether the subscription was started with a gift certificate.
+          title: Started with Gift
+        converted_at:
+          type: string
+          format: date-time
+          description: When the subscription was converted from a gift card.
+          title: Converted at
     SubscriptionAddOn:
       type: object
       title: Subscription Add-on
@@ -21421,6 +21640,11 @@ components:
             created by this request. Supports 'moto' value, which is the acronym for
             mail order and telephone transactions.
           "$ref": "#/components/schemas/GatewayTransactionTypeEnum"
+        gift_card_redemption_code:
+          type: string
+          title: Gift card Redemption Code
+          description: A gift card redemption code to be redeemed on the purchase
+            invoice.
       required:
       - plan_code
       - currency
@@ -22838,6 +23062,262 @@ components:
           type: string
           description: Username of the associated payment method. Currently only associated
             with Venmo.
+    GiftCardList:
+      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/GiftCard"
+    GiftCard:
+      type: object
+      description: Gift card details
+      properties:
+        id:
+          title: Gift card ID
+          type: string
+          maxLength: 13
+          readOnly: true
+        object:
+          title: Object type
+          type: string
+          readOnly: true
+        gifter_account_id:
+          title: Gifter account ID
+          type: string
+          maxLength: 13
+          description: The ID of the account that purchased the gift card.
+        recipient_account_id:
+          title: Recipient account ID
+          type: string
+          maxLength: 13
+          description: The ID of the account that redeemed the gift card redemption
+            code.  Does not have a value until gift card is redeemed.
+        purchase_invoice_id:
+          title: Purchase invoice ID
+          type: string
+          maxLength: 13
+          description: The ID of the invoice for the gift card purchase made by the
+            gifter.
+        redemption_invoice_id:
+          title: Redemption invoice ID
+          type: string
+          maxLength: 13
+          description: The ID of the invoice for the gift card redemption made by
+            the recipient.  Does not have a value until gift card is redeemed.
+        redemption_code:
+          title: Redemption code
+          type: string
+          description: The unique redemption code for the gift card, generated by
+            Recurly. Will be 16 characters, alphanumeric, displayed uppercase, but
+            accepted in any case at redemption. Used by the recipient account to create
+            a credit in the amount of the `unit_amount` on their account.
+        balance:
+          title: Remaining balance
+          type: number
+          format: float
+          description: The remaining credit on the recipient account associated with
+            this gift card. Only has a value once the gift card has been redeemed.
+            Can be used to create gift card balance displays for your customers.
+        product_code:
+          title: Product code
+          type: string
+          description: The product code or SKU of the gift card product.
+        unit_amount:
+          title: Purchase unit amount
+          type: number
+          format: float
+          description: The amount of the gift card, which is the amount of the charge
+            to the gifter account and the amount of credit that is applied to the
+            recipient account upon successful redemption.
+        currency:
+          title: Currency
+          type: string
+          description: 3-letter ISO 4217 currency code.
+          maxLength: 3
+        delivery:
+          title: Delivery details
+          description: The delivery details for the gift card.
+          readOnly: true
+          "$ref": "#/components/schemas/GiftCardDelivery"
+        created_at:
+          type: string
+          format: date-time
+          title: Created at
+          readOnly: true
+        updated_at:
+          type: string
+          format: date-time
+          title: Last updated at
+          readOnly: true
+        delivered_at:
+          type: string
+          format: date-time
+          title: Delivered at
+          readOnly: true
+          description: When the gift card was sent to the recipient by Recurly via
+            email, if method was email and the "Gift Card Delivery" email template
+            was enabled. This will be empty for post delivery or email delivery where
+            the email template was disabled.
+        redeemed_at:
+          type: string
+          format: date-time
+          title: Redeemed at
+          readOnly: true
+          description: When the gift card was redeemed by the recipient.
+        canceled_at:
+          type: string
+          format: date-time
+          title: Canceled at
+          readOnly: true
+          description: When the gift card was canceled.
+    GiftCardCreate:
+      type: object
+      description: Gift card details
+      properties:
+        product_code:
+          title: Product code
+          type: string
+          description: The product code or SKU of the gift card product.
+        unit_amount:
+          title: Purchase unit amount
+          type: number
+          format: float
+          description: The amount of the gift card, which is the amount of the charge
+            to the gifter account and the amount of credit that is applied to the
+            recipient account upon successful redemption.
+        currency:
+          title: Currency
+          type: string
+          description: 3-letter ISO 4217 currency code.
+          maxLength: 3
+        delivery:
+          title: Delivery details
+          description: The delivery details for the gift card.
+          readOnly: true
+          "$ref": "#/components/schemas/GiftCardDeliveryCreate"
+        gifter_account:
+          title: Gifter account details
+          description: Block of account details for the gifter. This references an
+            existing account_code.
+          readOnly: true
+          "$ref": "#/components/schemas/AccountPurchase"
+      required:
+      - product_code
+      - unit_amount
+      - currency
+      - delivery
+      - gifter_account
+    GiftCardDeliveryCreate:
+      type: object
+      description: Gift card delivery details
+      properties:
+        method:
+          title: Delivery method
+          description: Whether the delivery method is email or postal service.
+          "$ref": "#/components/schemas/DeliveryMethodEnum"
+        email_address:
+          title: Recipient email address
+          type: string
+          description: The email address of the recipient. Required if `method` is
+            `email`.
+        deliver_at:
+          type: string
+          format: date-time
+          title: Deliver at
+          readOnly: true
+          description: When the gift card should be delivered to the recipient. If
+            null, the gift card will be delivered immediately. If a datetime is provided,
+            the delivery will be in an hourly window, rounding down. For example,
+            6:23 pm will be in the 6:00 pm hourly batch.
+        first_name:
+          title: Recipient first name
+          type: string
+          description: The first name of the recipient.
+        last_name:
+          title: Recipient last name
+          type: string
+          description: The last name of the recipient.
+        recipient_address:
+          title: Recipient address
+          description: Address information for the recipient. Required if `method`
+            is `post`.
+          "$ref": "#/components/schemas/Address"
+        gifter_name:
+          title: Gifter name
+          type: string
+          description: The name of the gifter for the purpose of a message displayed
+            to the recipient.
+        personal_message:
+          title: Personal message
+          type: string
+          maxLength: 255
+          description: The personal message from the gifter to the recipient.
+      required:
+      - method
+    GiftCardDelivery:
+      type: object
+      description: Gift card delivery details
+      properties:
+        method:
+          title: Delivery method
+          description: Whether the delivery method is email or postal service.
+          "$ref": "#/components/schemas/DeliveryMethodEnum"
+        email_address:
+          title: Recipient email address
+          type: string
+          description: The email address of the recipient.
+        deliver_at:
+          type: string
+          format: date-time
+          title: Deliver at
+          readOnly: true
+          description: When the gift card should be delivered to the recipient. If
+            null, the gift card will be delivered immediately. If a datetime is provided,
+            the delivery will be in an hourly window, rounding down. For example,
+            6:23 pm will be in the 6:00 pm hourly batch.
+        first_name:
+          title: Recipient first name
+          type: string
+          description: The first name of the recipient.
+        last_name:
+          title: Recipient last name
+          type: string
+          description: The last name of the recipient.
+        recipient_address:
+          title: Recipient address
+          description: Address information for the recipient.
+          "$ref": "#/components/schemas/Address"
+        gifter_name:
+          title: Gifter name
+          type: string
+          description: The name of the gifter for the purpose of a message displayed
+            to the recipient.
+        personal_message:
+          title: Personal message
+          type: string
+          maxLength: 255
+          description: The personal message from the gifter to the recipient.
+    GiftCardRedeem:
+      type: object
+      description: The information necessary to redeem a gift card.
+      properties:
+        recipient_account:
+          title: Recipient account
+          description: The account for the recipient of the gift card.
+          "$ref": "#/components/schemas/AccountReference"
+      required:
+      - recipient_account
     Error:
       type: object
       properties:
@@ -22879,6 +23359,9 @@ components:
               code:
                 title: Code
                 "$ref": "#/components/schemas/ErrorCodeEnum"
+              decline_code:
+                title: Decline code
+                "$ref": "#/components/schemas/DeclineCodeEnum"
               message:
                 type: string
                 title: Customer message
@@ -22899,6 +23382,7 @@ components:
       - item
       - plan
       - subscription
+      - charge
     RefundTypeEnum:
       type: string
       enum:
@@ -23049,6 +23533,11 @@ components:
       enum:
       - parent
       - self
+    DeliveryMethodEnum:
+      type: string
+      enum:
+      - email
+      - post
     GatewayTransactionTypeEnum:
       type: string
       enum:
@@ -23686,6 +24175,38 @@ components:
       - unmapped_partner_error
       - vaultly_service_unavailable
       - zero_dollar_auth_not_supported
+    DeclineCodeEnum:
+      type: string
+      enum:
+      - account_closed
+      - call_issuer
+      - card_not_activated
+      - card_not_supported
+      - cardholder_requested_stop
+      - do_not_honor
+      - do_not_try_again
+      - exceeds_daily_limit
+      - generic_decline
+      - expired_card
+      - fraudulent
+      - insufficient_funds
+      - incorrect_address
+      - incorrect_security_code
+      - invalid_amount
+      - invalid_number
+      - invalid_transaction
+      - issuer_unavailable
+      - lifecycle_decline
+      - lost_card
+      - pickup_card
+      - policy_decline
+      - restricted_card
+      - restricted_card_chargeback
+      - security_decline
+      - stolen_card
+      - try_again
+      - update_cardholder_data
+      - requires_3d_secure
     ExportDates:
       type: object
       properties:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: recurly
 version: !ruby/object:Gem::Version
-  version: 4.27.0
+  version: 4.29.0
 platform: ruby
 authors:
 - Recurly
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-11 00:00:00.000000000 Z
+date: 2023-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -150,6 +150,7 @@ files:
 - lib/recurly/requests/account_acquisition_update.rb
 - lib/recurly/requests/account_create.rb
 - lib/recurly/requests/account_purchase.rb
+- lib/recurly/requests/account_reference.rb
 - lib/recurly/requests/account_update.rb
 - lib/recurly/requests/add_on_create.rb
 - lib/recurly/requests/add_on_pricing.rb
@@ -167,6 +168,9 @@ files:
 - lib/recurly/requests/dunning_campaigns_bulk_update.rb
 - lib/recurly/requests/external_refund.rb
 - lib/recurly/requests/external_transaction.rb
+- lib/recurly/requests/gift_card_create.rb
+- lib/recurly/requests/gift_card_delivery_create.rb
+- lib/recurly/requests/gift_card_redeem.rb
 - lib/recurly/requests/invoice_address.rb
 - lib/recurly/requests/invoice_collect.rb
 - lib/recurly/requests/invoice_create.rb
@@ -257,6 +261,8 @@ files:
 - lib/recurly/resources/external_resource_mini.rb
 - lib/recurly/resources/external_subscription.rb
 - lib/recurly/resources/fraud_info.rb
+- lib/recurly/resources/gift_card.rb
+- lib/recurly/resources/gift_card_delivery.rb
 - lib/recurly/resources/granted_by.rb
 - lib/recurly/resources/invoice.rb
 - lib/recurly/resources/invoice_address.rb
@@ -326,7 +332,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.27.0
+  source_code_uri: https://github.com/recurly/recurly-client-ruby/tree/4.29.0
 post_install_message: 
 rdoc_options: []
 require_paths: