recurly 2.20.0 → 2.20.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76ffc24a326ee1c22ce5484b7077144a9824b7f73286f31e229ea2f91cd6fba0
-  data.tar.gz: 5f5d614ff5665301e9506021a46571acd2b87f119599735639f035483c3c00d1
+  metadata.gz: d29c25aaafb1e7cde4ff0c6c3511bf672c10d5664b1223ccdb522cfed3b3a2de
+  data.tar.gz: ecd2e55f489d5ee557b5a2b0bc21cb88f19195b9815c046a36e90f66cbae5a20
 SHA512:
-  metadata.gz: 0cf092352d0a7ae6d5ff08dde873cb012fbb246f921701dcefe1f097e4cb7e1d1ce8462ca7a7ae4e771918b45ade1d3415d21962219c0466e8c5b355b1892c03
-  data.tar.gz: 254aa164e5abe43ab03cc050bb49d31358256040844134df93a356bf67ed65bc15c2f56e2efa959b2d2dafa7b932178d3602907f1d01a714f008c7681db6b932
+  metadata.gz: 014674a8200bbc58eba2a0238062da93c6f822b394e09d5031802504c9115efae0f380b7ca6ec3ff27a4c57b58f83656e8a823bd882c9ef4ecfe4fb38b3888bd
+  data.tar.gz: 332d7c771d10ceed0353a44c19f370235c8ea261f611803d56d3a914edfa47d05fc012d4e9ece51369bbeb82a558c0c1ee3b5fb9f113a628f06272de97ef2918

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.1'
 ```
 
 Recurly will automatically use [Nokogiri](http://nokogiri.org/) (for a nice

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.1"
 
     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.1
 platform: ruby
 authors:
 - Recurly
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-03 00:00:00.000000000 Z
+date: 2024-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri