chargebee 2.62.0 → 2.64.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff7a17d81ecf4007b81e194edf0ec10af8faff50b39f1773b65db699958b3285
-  data.tar.gz: 24ffe480a8a4d1d7035d1ecc4f61c5bf4dffb5b788a52738ab622df27e3dc15d
+  metadata.gz: fe14c7cb3dc2b603cd7c604c383759913f023c9a7ea6a35c9a1ce4856f4525ce
+  data.tar.gz: 4e6d015e8e33c469f4a389be822ca917ebc2075fccc63b7c1ff6591190716b7a
 SHA512:
-  metadata.gz: 3400c6d3c123c1893e8e9e25468984ac08d8224c1af84983f96d8e25f60f57afea0c6124ed7f85cb98d875e912ac6cd9af26a503b2324d02944b1a3f4641d426
-  data.tar.gz: '09d289c3b9df185e11b87a79ff76df2a06426ae9f4b0baa2187378b33af04cd78c4212a009b0f96d0f7bf47761a148d4bb228f093e35551b883f5b0ab4a6e4fe'
+  metadata.gz: c4c935501f85f6a9ec2e3927df5c7e89b28039825a2e12c8434a38266f47bc0447474bb6392f2ec6b37406c7e893f2324a98ab0843e81b182d321a60dfa148fb
+  data.tar.gz: c6a285b0be75c689686eef529c6ae9b0447ecc1958341e8a9aa5a232ee45c648016d9a8ca71b08a0bc4994adf8b1e62af4cf79bda03c5286317c04717823f3ce

data/CHANGELOG.md

@@ -1,3 +1,45 @@
+### v2.64.0 (2025-11-10)
+* * * 
+
+### Error Handling
+  - Added new `ForbiddenError` class that inherits from `Error`
+  - Enhanced `handle_for_error` method to detect and handle 403 status codes
+  - Provides clear error message: "Access forbidden. You do not have permission to access this resource."
+
+### Code Quality Improvements
+  - Renamed `lib/chargebee/nativeRequest.rb` → `lib/chargebee/native_request.rb` to follow Ruby naming conventions
+  - Refactored `handle_for_error` to return error objects instead of raising them inline (cleaner separation of concerns)
+  - Added YARD documentation for `handle_for_error` method
+
+### Testing
+  - Added comprehensive test coverage for 403 error scenarios
+
+### v2.63.0 (2025-10-28)
+* * * 
+
+### New Attributes: 
+* reference_transactions has been added to Invoice.
+* payment_attempts[] has been added to PaymentIntent.
+* checkout_details has been added to PaymentIntent#PaymentAttempt.
+* line_item_id has been added to CreditNoteEstimate#Discount.
+* line_item_id has been added to CreditNote#Discount.
+* line_item_id has been added to InvoiceEstimate#Discount.
+* line_item_id has been added to Invoice#Discount.
+* line_item_id has been added to InvoiceEstimate#Discount.
+* line_item_id has been added to Quote#Discount.
+* line_item_id has been added to QuoteLineGroup#Discount.
+
+### Modified Attributes: 
+* omnichannel_subscription_item_offers has been made optional attribute from required attribute.
+
+### New Input Parameters: 
+* discount[line_item_id] has been added to CreditNote#ImportCreditNoteRequest.
+* discount[line_item_id] has been added to CreditNote#ImportInvoiceRequest.
+
+### New Enums: 
+* OMNICHANNEL_TRANSACTION_CREATED has been added to EventTypeEnum.
+* DEUTSCHE_BANK has been added to Gateway.
+
 ### v2.62.0 ( 2025-09-23)
 * * * 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    chargebee (2.62.0)
+    chargebee (2.64.0)
       cgi (>= 0.1.0, < 1.0.0)
 
 GEM

data/chargebee.gemspec

@@ -4,8 +4,8 @@ Gem::Specification.new do |s|
   s.rubygems_version = '1.3.5'
   s.required_ruby_version = '>= 1.9.3'
   s.name              = 'chargebee'
-  s.version           = '2.62.0'
-  s.date              = '2025-09-23'
+  s.version           = '2.64.0'
+  s.date              = '2025-11-10'
   s.summary     = "Ruby client for Chargebee API."
   s.description = "Subscription Billing - Simple. Secure. Affordable. More details at www.chargebee.com."
   s.metadata = {
@@ -140,7 +140,7 @@ Gem::Specification.new do |s|
     lib/chargebee/models/usage_file.rb
     lib/chargebee/models/virtual_bank_account.rb
     lib/chargebee/models/webhook_endpoint.rb
-    lib/chargebee/nativeRequest.rb
+    lib/chargebee/native_request.rb
     lib/chargebee/request.rb
     lib/chargebee/rest.rb
     lib/chargebee/result.rb

data/lib/chargebee/errors.rb

@@ -8,6 +8,8 @@ module ChargeBee
     end
   end
 
+  class ForbiddenError < Error; end
+
   class IOError < Error; end
 
   class APIError < Error

data/lib/chargebee/models/credit_note.rb

@@ -22,7 +22,7 @@ module ChargeBee
     end
 
     class Discount < Model
-      attr_accessor :amount, :description, :entity_type, :discount_type, :entity_id, :coupon_set_code
+      attr_accessor :amount, :description, :line_item_id, :entity_type, :discount_type, :entity_id, :coupon_set_code
     end
 
     class Tax < Model

data/lib/chargebee/models/credit_note_estimate.rb

@@ -18,7 +18,7 @@ module ChargeBee
     end
 
     class Discount < Model
-      attr_accessor :amount, :description, :entity_type, :discount_type, :entity_id, :coupon_set_code
+      attr_accessor :amount, :description, :line_item_id, :entity_type, :discount_type, :entity_id, :coupon_set_code
     end
 
     class Tax < Model

data/lib/chargebee/models/invoice.rb

@@ -26,7 +26,7 @@ module ChargeBee
     end
 
     class Discount < Model
-      attr_accessor :amount, :description, :entity_type, :discount_type, :entity_id, :coupon_set_code
+      attr_accessor :amount, :description, :line_item_id, :entity_type, :discount_type, :entity_id, :coupon_set_code
     end
 
     class Tax < Model
@@ -41,6 +41,10 @@ module ChargeBee
       attr_accessor :txn_id, :applied_amount, :applied_at, :txn_status, :txn_date, :txn_amount
     end
 
+    class ReferenceTransaction < Model
+      attr_accessor :applied_amount, :applied_at, :txn_id, :txn_status, :txn_date, :txn_amount, :txn_type, :amount_capturable, :authorization_reason
+    end
+
     class DunningAttempt < Model
       attr_accessor :attempt, :transaction_id, :dunning_type, :created_at, :txn_status, :txn_amount
     end
@@ -93,10 +97,10 @@ module ChargeBee
   :first_invoice, :new_sales_amount, :has_advance_charges, :term_finalized, :is_gifted, :generated_at,
   :expected_payment_date, :amount_to_collect, :round_off_amount, :line_items, :line_item_tiers,
   :line_item_discounts, :line_item_taxes, :line_item_credits, :line_item_addresses, :discounts,
-  :taxes, :tax_origin, :linked_payments, :dunning_attempts, :applied_credits, :adjustment_credit_notes,
-  :issued_credit_notes, :linked_orders, :notes, :shipping_address, :billing_address, :statement_descriptor,
-  :einvoice, :void_reason_code, :deleted, :tax_category, :vat_number_prefix, :channel, :business_entity_id,
-  :site_details_at_creation
+  :taxes, :tax_origin, :linked_payments, :reference_transactions, :dunning_attempts, :applied_credits,
+  :adjustment_credit_notes, :issued_credit_notes, :linked_orders, :notes, :shipping_address, :billing_address,
+  :statement_descriptor, :einvoice, :void_reason_code, :deleted, :tax_category, :vat_number_prefix,
+  :channel, :business_entity_id, :site_details_at_creation
 
   # OPERATIONS
   #-----------

data/lib/chargebee/models/invoice_estimate.rb

@@ -26,7 +26,7 @@ module ChargeBee
     end
 
     class Discount < Model
-      attr_accessor :amount, :description, :entity_type, :discount_type, :entity_id, :coupon_set_code
+      attr_accessor :amount, :description, :line_item_id, :entity_type, :discount_type, :entity_id, :coupon_set_code
     end
 
     class Tax < Model

data/lib/chargebee/models/payment_intent.rb

@@ -2,12 +2,16 @@ module ChargeBee
   class PaymentIntent < Model
 
     class PaymentAttempt < Model
-      attr_accessor :id, :status, :payment_method_type, :id_at_gateway, :error_code, :error_text, :created_at, :modified_at, :error_detail
+      attr_accessor :id, :status, :payment_method_type, :id_at_gateway, :error_code, :error_text, :checkout_details, :created_at, :modified_at, :error_detail
+    end
+
+    class PaymentAttempt < Model
+      attr_accessor :id, :status, :payment_method_type, :id_at_gateway, :error_code, :error_text, :checkout_details, :created_at, :modified_at, :error_detail
     end
 
   attr_accessor :id, :status, :currency_code, :amount, :gateway_account_id, :expires_at, :reference_id,
   :payment_method_type, :success_url, :failure_url, :created_at, :modified_at, :resource_version,
-  :updated_at, :customer_id, :gateway, :active_payment_attempt, :business_entity_id
+  :updated_at, :customer_id, :gateway, :active_payment_attempt, :payment_attempts, :business_entity_id
 
   # OPERATIONS
   #-----------

data/lib/chargebee/models/quote.rb

@@ -18,7 +18,7 @@ module ChargeBee
     end
 
     class Discount < Model
-      attr_accessor :amount, :description, :entity_type, :discount_type, :entity_id, :coupon_set_code
+      attr_accessor :amount, :description, :line_item_id, :entity_type, :discount_type, :entity_id, :coupon_set_code
     end
 
     class Tax < Model

data/lib/chargebee/models/quote_line_group.rb

@@ -14,7 +14,7 @@ module ChargeBee
     end
 
     class Discount < Model
-      attr_accessor :amount, :description, :entity_type, :discount_type, :entity_id, :coupon_set_code
+      attr_accessor :amount, :description, :line_item_id, :entity_type, :discount_type, :entity_id, :coupon_set_code
     end
 
     class Tax < Model

data/lib/chargebee/{nativeRequest.rb → native_request.rb}

@@ -167,26 +167,33 @@ module ChargeBee
       end
     end
 
+    # Handle errors returned by the ChargeBee API.
+    #
+    # @param rcode [Integer] HTTP status code.
+    # @param rbody [String] HTTP response body.
+    #
+    # @return [ChargeBee::Error] Appropriate ChargeBee error object.
     def self.handle_for_error(rcode, rbody)
       return Error.new("No response returned by ChargeBee API. HTTP status code: #{rcode}") if rcode == 204
+      return ForbiddenError.new("Access forbidden. You do not have permission to access this resource.") if rcode == 403
       begin
         error_obj = JSON.parse(rbody)
         error_obj = Util.symbolize_keys(error_obj)
       rescue Exception => e
-        raise Error.new("Error response not in JSON format. The http status code is #{rcode} \n #{rbody.inspect}", e)
+        return Error.new("Error response not in JSON format. The http status code is #{rcode} \n #{rbody.inspect}", e)
       end
-      type = error_obj[:type]
-      case type
+
+      case error_obj[:type]
       when "payment"
-        raise PaymentError.new(rcode, error_obj)
+        PaymentError.new(rcode, error_obj)
       when "operation_failed"
-        raise OperationFailedError.new(rcode, error_obj)
+        OperationFailedError.new(rcode, error_obj)
       when "invalid_request"
-        raise InvalidRequestError.new(rcode, error_obj)
+        InvalidRequestError.new(rcode, error_obj)
       when "ubb_batch_ingestion_invalid_request"
-        raise UbbBatchIngestionInvalidRequestError.new(rcode, error_obj)
+        UbbBatchIngestionInvalidRequestError.new(rcode, error_obj)
       else
-        raise APIError.new(rcode, error_obj)
+        APIError.new(rcode, error_obj)
       end
     end
 

data/lib/chargebee/result.rb

@@ -106,7 +106,7 @@ module ChargeBee
 
     def invoice() 
         invoice = get(:invoice, Invoice,
-        {:line_items => Invoice::LineItem, :line_item_tiers => Invoice::LineItemTier, :line_item_discounts => Invoice::LineItemDiscount, :line_item_taxes => Invoice::LineItemTax, :line_item_credits => Invoice::LineItemCredit, :line_item_addresses => Invoice::LineItemAddress, :discounts => Invoice::Discount, :taxes => Invoice::Tax, :tax_origin => Invoice::TaxOrigin, :linked_payments => Invoice::LinkedPayment, :dunning_attempts => Invoice::DunningAttempt, :applied_credits => Invoice::AppliedCredit, :adjustment_credit_notes => Invoice::AdjustmentCreditNote, :issued_credit_notes => Invoice::IssuedCreditNote, :linked_orders => Invoice::LinkedOrder, :notes => Invoice::Note, :shipping_address => Invoice::ShippingAddress, :billing_address => Invoice::BillingAddress, :statement_descriptor => Invoice::StatementDescriptor, :einvoice => Invoice::Einvoice, :site_details_at_creation => Invoice::SiteDetailsAtCreation});
+        {:line_items => Invoice::LineItem, :line_item_tiers => Invoice::LineItemTier, :line_item_discounts => Invoice::LineItemDiscount, :line_item_taxes => Invoice::LineItemTax, :line_item_credits => Invoice::LineItemCredit, :line_item_addresses => Invoice::LineItemAddress, :discounts => Invoice::Discount, :taxes => Invoice::Tax, :tax_origin => Invoice::TaxOrigin, :linked_payments => Invoice::LinkedPayment, :reference_transactions => Invoice::ReferenceTransaction, :dunning_attempts => Invoice::DunningAttempt, :applied_credits => Invoice::AppliedCredit, :adjustment_credit_notes => Invoice::AdjustmentCreditNote, :issued_credit_notes => Invoice::IssuedCreditNote, :linked_orders => Invoice::LinkedOrder, :notes => Invoice::Note, :shipping_address => Invoice::ShippingAddress, :billing_address => Invoice::BillingAddress, :statement_descriptor => Invoice::StatementDescriptor, :einvoice => Invoice::Einvoice, :site_details_at_creation => Invoice::SiteDetailsAtCreation});
         return invoice;
     end
 
@@ -302,7 +302,7 @@ module ChargeBee
 
     def payment_intent() 
         payment_intent = get(:payment_intent, PaymentIntent,
-        {:payment_attempt => PaymentIntent::PaymentAttempt});
+        {:payment_attempt => PaymentIntent::PaymentAttempt, :payment_attempts => PaymentIntent::PaymentAttempt});
         return payment_intent;
     end
 
@@ -582,7 +582,7 @@ module ChargeBee
 
     def invoices() 
         invoices = get_list(:invoices, Invoice,
-        {:line_items => Invoice::LineItem, :line_item_tiers => Invoice::LineItemTier, :line_item_discounts => Invoice::LineItemDiscount, :line_item_taxes => Invoice::LineItemTax, :line_item_credits => Invoice::LineItemCredit, :line_item_addresses => Invoice::LineItemAddress, :discounts => Invoice::Discount, :taxes => Invoice::Tax, :tax_origin => Invoice::TaxOrigin, :linked_payments => Invoice::LinkedPayment, :dunning_attempts => Invoice::DunningAttempt, :applied_credits => Invoice::AppliedCredit, :adjustment_credit_notes => Invoice::AdjustmentCreditNote, :issued_credit_notes => Invoice::IssuedCreditNote, :linked_orders => Invoice::LinkedOrder, :notes => Invoice::Note, :shipping_address => Invoice::ShippingAddress, :billing_address => Invoice::BillingAddress, :statement_descriptor => Invoice::StatementDescriptor, :einvoice => Invoice::Einvoice, :site_details_at_creation => Invoice::SiteDetailsAtCreation});
+        {:line_items => Invoice::LineItem, :line_item_tiers => Invoice::LineItemTier, :line_item_discounts => Invoice::LineItemDiscount, :line_item_taxes => Invoice::LineItemTax, :line_item_credits => Invoice::LineItemCredit, :line_item_addresses => Invoice::LineItemAddress, :discounts => Invoice::Discount, :taxes => Invoice::Tax, :tax_origin => Invoice::TaxOrigin, :linked_payments => Invoice::LinkedPayment, :reference_transactions => Invoice::ReferenceTransaction, :dunning_attempts => Invoice::DunningAttempt, :applied_credits => Invoice::AppliedCredit, :adjustment_credit_notes => Invoice::AdjustmentCreditNote, :issued_credit_notes => Invoice::IssuedCreditNote, :linked_orders => Invoice::LinkedOrder, :notes => Invoice::Note, :shipping_address => Invoice::ShippingAddress, :billing_address => Invoice::BillingAddress, :statement_descriptor => Invoice::StatementDescriptor, :einvoice => Invoice::Einvoice, :site_details_at_creation => Invoice::SiteDetailsAtCreation});
         return invoices;
     end
 

data/lib/chargebee.rb

@@ -1,5 +1,5 @@
 require File.dirname(__FILE__) + '/chargebee/environment'
-require File.dirname(__FILE__) + '/chargebee/nativeRequest'
+require File.dirname(__FILE__) + '/chargebee/native_request'
 require File.dirname(__FILE__) + '/chargebee/util'
 require File.dirname(__FILE__) + '/chargebee/request'
 require File.dirname(__FILE__) + '/chargebee/result'
@@ -98,7 +98,7 @@ require File.dirname(__FILE__) + '/chargebee/models/offer_fulfillment'
 
 module ChargeBee
 
-  VERSION = '2.62.0'
+  VERSION = '2.64.0'
 
   @@default_env = nil
   @@verify_ca_certs = true

data/spec/chargebee/native_request_spec.rb

@@ -141,6 +141,19 @@ module ChargeBee
       end
     end
 
+    it "raises ForbiddenError for 403 status code" do
+      stub_request(:get, "https://dummy.chargebee.com/test").to_return(
+        body: "<html>\r\n<head><title>403 Forbidden</title></head>\r\n<body>\r\n<center><h1>403 Forbidden</h1></center>\r\n</body>\r\n</html>\r\n",
+        status: 403
+      )
+
+      expect {
+        NativeRequest.request(:get, "/test", env)
+      }.to raise_error(ForbiddenError) do |err|
+        expect(err.message).to eq("Access forbidden. You do not have permission to access this resource.")
+      end
+    end
+
     it "retries once on HTTP 503 and succeeds on second attempt" do
       stub_request(:get, "https://dummy.chargebee.com/test")
         .to_return({ status: 503, body: "temporary error" },

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chargebee
 version: !ruby/object:Gem::Version
-  version: 2.62.0
+  version: 2.64.0
 platform: ruby
 authors:
 - Rajaraman S
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-23 00:00:00.000000000 Z
+date: 2025-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -181,7 +181,7 @@ files:
 - lib/chargebee/models/usage_file.rb
 - lib/chargebee/models/virtual_bank_account.rb
 - lib/chargebee/models/webhook_endpoint.rb
-- lib/chargebee/nativeRequest.rb
+- lib/chargebee/native_request.rb
 - lib/chargebee/request.rb
 - lib/chargebee/rest.rb
 - lib/chargebee/result.rb