chargebee 2.56.0 → 2.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 001c016fe4fc0205f06fb61eb647d42281538059
-  data.tar.gz: f833505b1779675814ddc724904de2cb9f12cb8d
+SHA256:
+  metadata.gz: b1cc3386050b2ab1aa940939ce4cdec99d99ae1a78be90f459fbb482ee1fb195
+  data.tar.gz: cd3b659db1ea6cd510ae3ca186c6e35dfe567b370ce12b747d8a1caed608d75b
 SHA512:
-  metadata.gz: 37f8ec23a423df351454d67c8d1a74eb4cd595b2364ac4b31033afa7fe318b815d0f07676c380e6916a1470182347d2d3c3c45cf1aa9fabecb695dcef9a2ed86
-  data.tar.gz: 3b3c3d6dbfe8556c2d1b4679aaf7316c966180b5b596295873edb219967adc51ced19e0ac7dd5c99a97160a4a3b96d88b63cef3d9fb60821a784fe5b24b5d732
+  metadata.gz: 4b6a6f971e017279014fcfeebf66ad88c1e897ae7d4e243ba5bf6014796f9635c224a3a584498b4f3611718651d9feb7eeae0d6ea891c5e2115c9a8f8c78def9
+  data.tar.gz: 849b22407cce88891250aa6e623462a0adcf827c47f17d75017d7465e30196806d9144250a6da32c3816dcb7e1c715f96c2b1c469deade720beeb4aef738df6b

data/CHANGELOG.md

@@ -1,3 +1,40 @@
+### v2.58.0 (2025-07-18) 
+* * * 
+
+### New Resources: 
+* BillingConfiguration has been added. 
+* Brand has been added. 
+
+### New Attributes: 
+* has_children has been added to Hierarchy
+* coupon_applicability_mappings has been added to QuotedRamp.
+
+### New Endpoint:
+* listHierarchyDetail has been added to Customer.
+
+### New Input parameters: 
+* change_reason children has been added to Entitlement#CreateRequest.
+* entitlements[apply_grandfathering] has been added to Entitlement#CreateRequest.
+* replace_primary_payment_source has been added to Purchase#CreateRequest.
+* omnichannel_subscription has been added to RecordedPurchase#CreateRequest.
+* contract_term has been added to Subscription#RemoveScheduledCancellationRequest.
+* contract_term_billing_cycle_on_renewal has been added to Subscription#RemoveScheduledCancellationRequest.
+
+### New Enums: 
+* payconiq_by_bancontact has been added to PaymentMethodType.
+* solidgate has been added to Gateway.
+* solidgate has been added to PaymentMethod.
+
+
+### v2.57.0 (2025-06-23)
+* * * 
+
+### New Features
+* Added built-in retry support for handling transient errors and rate-limiting.
+* Retries are now supported for HTTP status codes 500, 502, 503, 504, and 429.
+* Includes exponential backoff for server errors and Retry-After respect for rate limits (429).
+* Configurable via retryConfig during SDK initialization.
+
 ### v2.56.0 (2025-06-19) 
 * * * 
 

data/Gemfile

@@ -1,3 +1,8 @@
 source "https://rubygems.org"
 
 gemspec
+
+group :development, :test do
+  gem 'rspec', '~> 3.12'
+  gem 'webmock'
+end

data/Gemfile.lock

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

data/README.md

@@ -73,6 +73,58 @@ puts(idempotencyReplayedValue)
 ```
 `is_idempotency_replayed` method can be accessed to differentiate between original and replayed requests.
 
+
+### Retry Handling
+
+Chargebee's SDK includes built-in retry logic to handle temporary network issues and server-side errors. This feature is **disabled by default** but can be **enabled when needed**.
+
+#### Key features include:
+
+- **Automatic retries for specific HTTP status codes**: Retries are automatically triggered for status codes `500`, `502`, `503`, and `504`.
+- **Exponential backoff**: Retry delays increase exponentially to prevent overwhelming the server.
+- **Rate limit management**: If a `429 Too Many Requests` response is received with a `Retry-After` header, the SDK waits for the specified duration before retrying.
+  > *Note: Exponential backoff and max retries do not apply in this case.*
+- **Customizable retry behavior**: Retry logic can be configured using the `retryConfig` parameter in the environment configuration.
+
+#### Example: Customizing Retry Logic
+
+You can enable and configure the retry logic by passing a `retryConfig` object when initializing the Chargebee environment:
+
+```ruby
+require 'chargebee'
+ChargeBee.configure({:api_key => "your_api_key" , :site => "your_site"})
+
+# Set comprehensive retry configuration
+ChargeBee::default_env.retry_config = {
+  enabled: true,
+  max_retries: 1,
+  delay_ms: 2000,
+  retry_on: [500]
+}
+
+# ... your Chargebee API operations ...
+
+```
+
+#### Example: Rate Limit retry logic
+
+You can enable and configure the retry logic for rate-limit by passing a `retryConfig` object when initializing the Chargebee environment:
+
+```ruby
+require 'chargebee'
+ChargeBee.configure({:api_key => "your_api_key" , :site => "your_site"})
+
+# Set comprehensive retry configuration
+ChargeBee::default_env.retry_config = {
+  enabled: true,
+  max_retries: 1,
+  delay_ms: 1000,
+  retry_on: [429]
+}
+
+# ... your Chargebee API operations ...
+```
+
 ## License
 
 See the LICENSE file.

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.56.0'
-  s.date              = '2025-06-19'
+  s.version           = '2.58.0'
+  s.date              = '2025-07-21'
   s.summary     = "Ruby client for Chargebee API."
   s.description = "Subscription Billing - Simple. Secure. Affordable. More details at www.chargebee.com."
   s.metadata = {
@@ -45,6 +45,8 @@ Gem::Specification.new do |s|
     lib/chargebee/models/advance_invoice_schedule.rb
     lib/chargebee/models/attached_item.rb
     lib/chargebee/models/attribute.rb
+    lib/chargebee/models/billing_configuration.rb
+    lib/chargebee/models/brand.rb
     lib/chargebee/models/business_entity.rb
     lib/chargebee/models/business_entity_transfer.rb
     lib/chargebee/models/card.rb
@@ -135,6 +137,7 @@ Gem::Specification.new do |s|
     lib/chargebee/util.rb
     lib/ssl/ca-certs.crt
     spec/chargebee/list_result_spec.rb
+    spec/chargebee/native_request_spec.rb
     spec/chargebee_spec.rb
     spec/errors_spec.rb
     spec/sample_response.rb

data/lib/chargebee/environment.rb

@@ -10,6 +10,9 @@ module ChargeBee
     attr_accessor :api_key, :site, :time_machine_sleeptime, :export_sleeptime, :connect_timeout, :read_timeout
     attr_reader :api_endpoint
 
+    # Add retry_config and enable_debug_logs
+    attr_accessor :retry_config, :enable_debug_logs
+
     def initialize(options)
       options[:time_machine_sleeptime] ||= TIME_MACHINE_TIMEOUT
       options[:export_sleeptime] ||= EXPORT_TIMEOUT
@@ -18,6 +21,8 @@ module ChargeBee
       [:api_key, :site, :time_machine_sleeptime, :export_sleeptime, :connect_timeout, :read_timeout].each do |attr|
         instance_variable_set "@#{attr}", options[attr]
       end
+      @retry_config = options[:retry_config]
+      @enable_debug_logs = options[:enable_debug_logs] || false
       if($CHARGEBEE_DOMAIN == nil)
         @api_endpoint = "https://#{@site}.chargebee.com/api/#{API_VERSION}"
       else
@@ -25,15 +30,16 @@ module ChargeBee
       end
     end
 
-    def api_url(url, sub_domain=nil)
-      if(sub_domain != nil)
-        if($CHARGEBEE_DOMAIN == nil)
-          @api_endpoint = "https://#{@site}.#{sub_domain}.chargebee.com/api/#{API_VERSION}"
-        else
-          @api_endpoint = "#{$ENV_PROTOCOL == nil ? "http": "https"}://#{@site}.#{sub_domain}.#{$CHARGEBEE_DOMAIN}/api/#{API_VERSION}"
-        end
+    def api_url(url, sub_domain = nil)
+      protocol = $ENV_PROTOCOL || "https"
+      domain   = $CHARGEBEE_DOMAIN || "chargebee.com"
+
+      if sub_domain
+        @api_endpoint = "#{protocol}://#{@site}.#{sub_domain}.#{domain}/api/#{API_VERSION}"
+      else
+        @api_endpoint = "#{protocol}://#{@site}.#{domain}/api/#{API_VERSION}"
       end
-      url = @api_endpoint + url
+        @api_endpoint + url
     end
   end
 end

data/lib/chargebee/models/addon.rb

@@ -25,44 +25,61 @@ module ChargeBee
     jsonKeys = { 
         :meta_data => 0,
     }
-    Request.send('post', uri_path("addons"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("addons"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.update(id, params, env=nil, headers={})
     jsonKeys = { 
         :meta_data => 0,
     }
-    Request.send('post', uri_path("addons",id.to_s), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("addons",id.to_s), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.list(params={}, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send_list_request('get', uri_path("addons"), params, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send_list_request('get', uri_path("addons"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.retrieve(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('get', uri_path("addons",id.to_s), {}, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send('get', uri_path("addons",id.to_s), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.delete(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("addons",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("addons",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.copy(params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("addons","copy"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("addons","copy"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.unarchive(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("addons",id.to_s,"unarchive"), {}, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("addons",id.to_s,"unarchive"), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   end # ~Addon

data/lib/chargebee/models/address.rb

@@ -10,13 +10,17 @@ module ChargeBee
   def self.retrieve(params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('get', uri_path("addresses"), params, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send('get', uri_path("addresses"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.update(params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("addresses"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("addresses"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   end # ~Address

data/lib/chargebee/models/attached_item.rb

@@ -11,31 +11,42 @@ module ChargeBee
   def self.create(id, params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("items",id.to_s,"attached_items"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("items",id.to_s,"attached_items"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.update(id, params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("attached_items",id.to_s), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("attached_items",id.to_s), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.retrieve(id, params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('get', uri_path("attached_items",id.to_s), params, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send('get', uri_path("attached_items",id.to_s), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.delete(id, params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("attached_items",id.to_s,"delete"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("attached_items",id.to_s,"delete"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.list(id, params={}, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send_list_request('get', uri_path("items",id.to_s,"attached_items"), params, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send_list_request('get', uri_path("items",id.to_s,"attached_items"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   end # ~AttachedItem

data/lib/chargebee/models/billing_configuration.rb

@@ -0,0 +1,14 @@
+module ChargeBee
+  class BillingConfiguration < Model
+
+    class BillingDate < Model
+      attr_accessor :start_date, :end_date
+    end
+
+  attr_accessor :is_calendar_billing_enabled, :billing_dates
+
+  # OPERATIONS
+  #-----------
+
+  end # ~BillingConfiguration
+end # ~ChargeBee

data/lib/chargebee/models/brand.rb

@@ -0,0 +1,10 @@
+module ChargeBee
+  class Brand < Model
+
+  attr_accessor :id, :name
+
+  # OPERATIONS
+  #-----------
+
+  end # ~Brand
+end # ~ChargeBee

data/lib/chargebee/models/business_entity.rb

@@ -9,13 +9,17 @@ module ChargeBee
   def self.create_transfers(params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("business_entities","transfers"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("business_entities","transfers"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.get_transfers(params={}, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('get', uri_path("business_entities","transfers"), params, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send('get', uri_path("business_entities","transfers"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   end # ~BusinessEntity

data/lib/chargebee/models/card.rb

@@ -13,31 +13,44 @@ module ChargeBee
   def self.retrieve(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('get', uri_path("cards",id.to_s), {}, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send('get', uri_path("cards",id.to_s), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.update_card_for_customer(id, params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("customers",id.to_s,"credit_card"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("customers",id.to_s,"credit_card"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.switch_gateway_for_customer(id, params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("customers",id.to_s,"switch_gateway"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("customers",id.to_s,"switch_gateway"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.copy_card_for_customer(id, params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("customers",id.to_s,"copy_card"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("customers",id.to_s,"copy_card"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.delete_card_for_customer(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("customers",id.to_s,"delete_card"), {}, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("customers",id.to_s,"delete_card"), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   end # ~Card

data/lib/chargebee/models/comment.rb

@@ -9,25 +9,33 @@ module ChargeBee
   def self.create(params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("comments"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("comments"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.retrieve(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('get', uri_path("comments",id.to_s), {}, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send('get', uri_path("comments",id.to_s), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.list(params={}, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send_list_request('get', uri_path("comments"), params, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send_list_request('get', uri_path("comments"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.delete(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("comments",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("comments",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   end # ~Comment

data/lib/chargebee/models/configuration.rb

@@ -9,7 +9,8 @@ module ChargeBee
   def self.list(env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send_list_request('get', uri_path("configurations"), {}, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send_list_request('get', uri_path("configurations"), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   end # ~Configuration

data/lib/chargebee/models/coupon.rb

@@ -27,7 +27,10 @@ module ChargeBee
     jsonKeys = { 
         :meta_data => 0,
     }
-    Request.send('post', uri_path("coupons"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("coupons"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.create_for_items(params, env=nil, headers={})
@@ -38,7 +41,10 @@ module ChargeBee
         :currencies => 1,
         :item_price_periods => 1,
     }
-    Request.send('post', uri_path("coupons","create_for_items"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("coupons","create_for_items"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.update_for_items(id, params, env=nil, headers={})
@@ -49,44 +55,61 @@ module ChargeBee
         :currencies => 1,
         :item_price_periods => 1,
     }
-    Request.send('post', uri_path("coupons",id.to_s,"update_for_items"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("coupons",id.to_s,"update_for_items"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.list(params={}, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send_list_request('get', uri_path("coupons"), params, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send_list_request('get', uri_path("coupons"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.retrieve(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('get', uri_path("coupons",id.to_s), {}, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send('get', uri_path("coupons",id.to_s), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.update(id, params={}, env=nil, headers={})
     jsonKeys = { 
         :meta_data => 0,
     }
-    Request.send('post', uri_path("coupons",id.to_s), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("coupons",id.to_s), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.delete(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("coupons",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("coupons",id.to_s,"delete"), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.copy(params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("coupons","copy"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("coupons","copy"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.unarchive(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("coupons",id.to_s,"unarchive"), {}, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("coupons",id.to_s,"unarchive"), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   end # ~Coupon

data/lib/chargebee/models/coupon_code.rb

@@ -9,25 +9,33 @@ module ChargeBee
   def self.create(params, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("coupon_codes"), params, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("coupon_codes"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.retrieve(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('get', uri_path("coupon_codes",id.to_s), {}, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send('get', uri_path("coupon_codes",id.to_s), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.list(params={}, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send_list_request('get', uri_path("coupon_codes"), params, env, headers,nil, false, jsonKeys)
+    options = {}
+    Request.send_list_request('get', uri_path("coupon_codes"), params, env, headers,nil, false, jsonKeys, options)
   end
 
   def self.archive(id, env=nil, headers={})
     jsonKeys = { 
     }
-    Request.send('post', uri_path("coupon_codes",id.to_s,"archive"), {}, env, headers,nil, false, jsonKeys)
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("coupon_codes",id.to_s,"archive"), {}, env, headers,nil, false, jsonKeys, options)
   end
 
   end # ~CouponCode