recurly 2.20.0 → 2.20.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76ffc24a326ee1c22ce5484b7077144a9824b7f73286f31e229ea2f91cd6fba0
-  data.tar.gz: 5f5d614ff5665301e9506021a46571acd2b87f119599735639f035483c3c00d1
+  metadata.gz: 7b9df673d417f04fe0f5bed15fe3813eebcd79909b343c767e23b7c398ae8146
+  data.tar.gz: 20f3090cb3f98c01961ceeeb32062a70b7298bb76739a3590f1f45c3641a0302
 SHA512:
-  metadata.gz: 0cf092352d0a7ae6d5ff08dde873cb012fbb246f921701dcefe1f097e4cb7e1d1ce8462ca7a7ae4e771918b45ade1d3415d21962219c0466e8c5b355b1892c03
-  data.tar.gz: 254aa164e5abe43ab03cc050bb49d31358256040844134df93a356bf67ed65bc15c2f56e2efa959b2d2dafa7b932178d3602907f1d01a714f008c7681db6b932
+  metadata.gz: 1eeed62429b20bb43da5e7c255f492ba188bba4aab7b561f138fe517250a17151e1878abbabf7270d8b9ccac3c5209bfc2dc2d45e70d694a028fbed2f3071862
+  data.tar.gz: 1240588db91fd5c2f2b31c9acdc2aecc19e9b07e0aba7ecd39ac279edc44ff37369b303a0ced725c037520b7a09c69f48acce16875e4dfb9224c465d1f37693a

data/README.md

@@ -14,7 +14,7 @@ Recurly is packaged as a Ruby gem. We recommend you install it with
 [Bundler](http://gembundler.com/) by adding the following line to your Gemfile:
 
 ``` ruby
-gem 'recurly', '~> 2.20.0'
+gem 'recurly', '~> 2.20.2'
 ```
 
 Recurly will automatically use [Nokogiri](http://nokogiri.org/) (for a nice

data/lib/recurly/external_subscription.rb

@@ -15,6 +15,7 @@ module Recurly
 
     define_attribute_methods %w(
       account
+      uuid
       external_id
       external_product_reference
       quantity
@@ -53,5 +54,9 @@ module Recurly
     def self.find_by_external_id(external_id)
       self.find("external-id-#{external_id}")
     end
+
+    def self.find_by_uuid(uuid)
+      self.find("uuid-#{uuid}")
+    end
   end
 end

data/lib/recurly/invoice.rb

@@ -249,6 +249,25 @@ module Recurly
       )
     end
 
+    # Refunds the invoice for a specific percentage.
+    #
+    # @return [Invoice, false] Invoice if successful, false if the invoice isn't
+    # refundable.
+    # @raise [Error] If the refund fails.
+    # @param percentage [Integer, nil] The percentage to refund from the invoice.
+    # @param refund_method ["credit_first", "transaction_first", "all_transaction", "all_credit"] The method used to refund.
+    # @param external_refund [true, false] Designates that the refund transactions created are manual.
+    # @param credit_customer_notes [String] Adds notes to refund credit invoice.
+    # @param payment_method [String] Creates the manual transactions with this payment method. Allowed if *external_refund* is true.
+    # @param description [String] Sets this value as the *transaction_note* on the manual transactions created. Allowed if *external_refund* is true.
+    # @param refunded_at [DateTime] Sets this value as the *collected_at* on the manual transactions created. Allowed if *external_refund* is true.
+    def refund_percentage(percentage = nil, refund_method = 'credit_first', options = {})
+      return false unless link? :refund
+      self.class.from_response(
+        follow_link :refund, :body => refund_percentage_to_xml(percentage, refund_method, options)
+      )
+    end
+
     def xml_keys
       super - ['currency']
     end
@@ -285,6 +304,16 @@ module Recurly
       builder.to_s
     end
 
+    def refund_percentage_to_xml(percentage = nil, refund_method = nil, options = {})
+      builder = XML.new("<invoice/>")
+      builder.add_element 'refund_method', refund_method
+      builder.add_element 'percentage', percentage
+      options.each do |k, v|
+        builder.add_element k.to_s, v
+      end
+      builder.to_s
+    end
+
     def refund_line_items_to_xml(line_items = nil, refund_method = nil, options = {})
       builder = XML.new("<invoice/>")
       builder.add_element 'refund_method', refund_method
@@ -296,8 +325,10 @@ module Recurly
       line_items.each do |line_item|
         adj_node = node.add_element 'adjustment'
         adj_node.add_element 'uuid', line_item[:adjustment].uuid
-        adj_node.add_element 'quantity', line_item[:quantity]
+        adj_node.add_element 'quantity', line_item[:quantity] if line_item.key?(:quantity)
         adj_node.add_element('quantity_decimal', line_item[:quantity_decimal]) if line_item.key?(:quantity_decimal)
+        adj_node.add_element 'percentage', line_item[:percentage] if line_item.key?(:percentage)
+        adj_node.add_element 'amount_in_cents', line_item[:amount_in_cents] if line_item.key?(:amount_in_cents)
         adj_node.add_element 'prorate', line_item[:prorate]
       end
       builder.to_s

data/lib/recurly/version.rb

@@ -1,6 +1,6 @@
 module Recurly
   module Version
-    VERSION = "2.20.0"
+    VERSION = "2.20.2"
 
     class << self
       def inspect

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: recurly
 version: !ruby/object:Gem::Version
-  version: 2.20.0
+  version: 2.20.2
 platform: ruby
 authors:
 - Recurly
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-03 00:00:00.000000000 Z
+date: 2024-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri