bk-apimatic-sdk 1.0.0

data/lib/boku_direct_payments_api/models/charge_plus_optin_response.rb

@@ -0,0 +1,278 @@
+# boku_direct_payments_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module BokuDirectPaymentsApi
+  # ChargePlusOptinResponse Model.
+  class ChargePlusOptinResponse < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Boku-assigned merchant ID.
+    # @return [String]
+    attr_accessor :merchant_id
+
+    # Merchant-assigned unique request ID.
+    # @return [String]
+    attr_accessor :merchant_request_id
+
+    # Merchant-assigned transaction ID. 
+    # _***Boku recommends merchants send this ID for future reference**_
+    # @return [String]
+    attr_accessor :merchant_transaction_id
+
+    # The payment method selected
+    # @return [String]
+    attr_accessor :payment_method
+
+    # The 'result' element is defined in every response type. It is used to
+    # convey the outcome of an API request.
+    # @return [Result]
+    attr_accessor :result
+
+    # The Boku Bank ID selected by the consumer.
+    # @return [String]
+    attr_accessor :bank_id
+
+    # Boku-generated unique ID for the charge.
+    # If null, no charge was created, e.g. because the request was rejected.
+    # @return [String]
+    attr_accessor :charge_id
+
+    # Status of the charge at the time this response was returned.
+    # If 'in-progress' is returned, the charge call should be re-issued with the
+    # same request ID until a final status is reached.
+    # If null, no charge was created (e.g., because the request was rejected).
+    # @return [ChargeStatusEnum]
+    attr_accessor :charge_status
+
+    # ISO 3166-1 alpha-2 country code.
+    # @return [String]
+    attr_accessor :country
+
+    # ISO 3166-1 alpha-2 country code.
+    # @return [ChargePlusOptinResponseHosted]
+    attr_accessor :hosted
+
+    # Merchant-supplied metadata
+    # @return [String]
+    attr_accessor :merchant_data
+
+    # Boku-assigned unique opt-in ID.
+    # @return [String]
+    attr_accessor :optin_id
+
+    # Gives the state of the opt-in at the time this response was returned
+    # @return [OptinState]
+    attr_accessor :optin_state
+
+    # Optin and Charge Request API can be made for specific Seller of Record
+    # previously registered with Boku.
+    # @return [SellerOfRecord]
+    attr_accessor :seller_of_record
+
+    # Time request was received ("YYYY-MM-DD hh:mm:ss").
+    # All timestamps are in UTC.
+    # @return [String]
+    attr_accessor :timestamp
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['merchant_id'] = 'merchant-id'
+      @_hash['merchant_request_id'] = 'merchant-request-id'
+      @_hash['merchant_transaction_id'] = 'merchant-transaction-id'
+      @_hash['payment_method'] = 'payment-method'
+      @_hash['result'] = 'result'
+      @_hash['bank_id'] = 'bank-id'
+      @_hash['charge_id'] = 'charge-id'
+      @_hash['charge_status'] = 'charge-status'
+      @_hash['country'] = 'country'
+      @_hash['hosted'] = 'hosted'
+      @_hash['merchant_data'] = 'merchant-data'
+      @_hash['optin_id'] = 'optin-id'
+      @_hash['optin_state'] = 'optin-state'
+      @_hash['seller_of_record'] = 'seller-of-record'
+      @_hash['timestamp'] = 'timestamp'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        bank_id
+        charge_id
+        charge_status
+        country
+        hosted
+        merchant_data
+        optin_id
+        optin_state
+        seller_of_record
+        timestamp
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(merchant_id = nil, merchant_request_id = nil,
+                   merchant_transaction_id = nil, payment_method = nil,
+                   result = nil, bank_id = SKIP, charge_id = SKIP,
+                   charge_status = SKIP, country = SKIP, hosted = SKIP,
+                   merchant_data = SKIP, optin_id = SKIP, optin_state = SKIP,
+                   seller_of_record = SKIP, timestamp = SKIP)
+      @merchant_id = merchant_id
+      @merchant_request_id = merchant_request_id
+      @merchant_transaction_id = merchant_transaction_id
+      @payment_method = payment_method
+      @result = result
+      @bank_id = bank_id unless bank_id == SKIP
+      @charge_id = charge_id unless charge_id == SKIP
+      @charge_status = charge_status unless charge_status == SKIP
+      @country = country unless country == SKIP
+      @hosted = hosted unless hosted == SKIP
+      @merchant_data = merchant_data unless merchant_data == SKIP
+      @optin_id = optin_id unless optin_id == SKIP
+      @optin_state = optin_state unless optin_state == SKIP
+      @seller_of_record = seller_of_record unless seller_of_record == SKIP
+      @timestamp = timestamp unless timestamp == SKIP
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      merchant_id = hash.key?('merchant-id') ? hash['merchant-id'] : nil
+      merchant_request_id =
+        hash.key?('merchant-request-id') ? hash['merchant-request-id'] : nil
+      merchant_transaction_id =
+        hash.key?('merchant-transaction-id') ? hash['merchant-transaction-id'] : nil
+      payment_method =
+        hash.key?('payment-method') ? hash['payment-method'] : nil
+      result = Result.from_hash(hash['result']) if hash['result']
+      bank_id = hash.key?('bank-id') ? hash['bank-id'] : SKIP
+      charge_id = hash.key?('charge-id') ? hash['charge-id'] : SKIP
+      charge_status = hash.key?('charge-status') ? hash['charge-status'] : SKIP
+      country = hash.key?('country') ? hash['country'] : SKIP
+      hosted = ChargePlusOptinResponseHosted.from_hash(hash['hosted']) if hash['hosted']
+      merchant_data = hash.key?('merchant-data') ? hash['merchant-data'] : SKIP
+      optin_id = hash.key?('optin-id') ? hash['optin-id'] : SKIP
+      optin_state = OptinState.from_hash(hash['optin-state']) if hash['optin-state']
+      seller_of_record = SellerOfRecord.from_hash(hash['seller-of-record']) if
+        hash['seller-of-record']
+      timestamp = hash.key?('timestamp') ? hash['timestamp'] : SKIP
+
+      # Create object from extracted values.
+      ChargePlusOptinResponse.new(merchant_id,
+                                  merchant_request_id,
+                                  merchant_transaction_id,
+                                  payment_method,
+                                  result,
+                                  bank_id,
+                                  charge_id,
+                                  charge_status,
+                                  country,
+                                  hosted,
+                                  merchant_data,
+                                  optin_id,
+                                  optin_state,
+                                  seller_of_record,
+                                  timestamp)
+    end
+
+    def self.from_element(root)
+      merchant_id = XmlUtilities.from_element(root, 'merchant-id', String)
+      merchant_request_id = XmlUtilities.from_element(root,
+                                                      'merchant-request-id',
+                                                      String)
+      merchant_transaction_id = XmlUtilities.from_element(
+        root, 'merchant-transaction-id', String
+      )
+      payment_method = XmlUtilities.from_element(root, 'payment-method', String)
+      result = XmlUtilities.from_element(root, 'result', Result)
+      bank_id = XmlUtilities.from_element(root, 'bank-id', String)
+      charge_id = XmlUtilities.from_element(root, 'charge-id', String)
+      charge_status = XmlUtilities.from_element(root, 'charge-status', String)
+      country = XmlUtilities.from_element(root, 'country', String)
+      hosted = XmlUtilities.from_element(root, 'hosted',
+                                         ChargePlusOptinResponseHosted)
+      merchant_data = XmlUtilities.from_element(root, 'merchant-data', String)
+      optin_id = XmlUtilities.from_element(root, 'optin-id', String)
+      optin_state = XmlUtilities.from_element(root, 'optin-state', OptinState)
+      seller_of_record = XmlUtilities.from_element(root, 'seller-of-record',
+                                                   SellerOfRecord)
+      timestamp = XmlUtilities.from_element(root, 'timestamp', String)
+
+      new(merchant_id,
+          merchant_request_id,
+          merchant_transaction_id,
+          payment_method,
+          result,
+          bank_id,
+          charge_id,
+          charge_status,
+          country,
+          hosted,
+          merchant_data,
+          optin_id,
+          optin_state,
+          seller_of_record,
+          timestamp)
+    end
+
+    def to_xml_element(doc, root_name)
+      root = doc.create_element(root_name)
+
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-id', merchant_id)
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-request-id',
+                                     merchant_request_id)
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-transaction-id',
+                                     merchant_transaction_id)
+      XmlUtilities.add_as_subelement(doc, root, 'payment-method',
+                                     payment_method)
+      XmlUtilities.add_as_subelement(doc, root, 'result', result)
+      XmlUtilities.add_as_subelement(doc, root, 'bank-id', bank_id)
+      XmlUtilities.add_as_subelement(doc, root, 'charge-id', charge_id)
+      XmlUtilities.add_as_subelement(doc, root, 'charge-status', charge_status)
+      XmlUtilities.add_as_subelement(doc, root, 'country', country)
+      XmlUtilities.add_as_subelement(doc, root, 'hosted', hosted)
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-data', merchant_data)
+      XmlUtilities.add_as_subelement(doc, root, 'optin-id', optin_id)
+      XmlUtilities.add_as_subelement(doc, root, 'optin-state', optin_state)
+      XmlUtilities.add_as_subelement(doc, root, 'seller-of-record',
+                                     seller_of_record)
+      XmlUtilities.add_as_subelement(doc, root, 'timestamp', timestamp)
+
+      root
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} merchant_id: #{@merchant_id}, merchant_request_id: #{@merchant_request_id},"\
+      " merchant_transaction_id: #{@merchant_transaction_id}, payment_method: #{@payment_method},"\
+      " result: #{@result}, bank_id: #{@bank_id}, charge_id: #{@charge_id}, charge_status:"\
+      " #{@charge_status}, country: #{@country}, hosted: #{@hosted}, merchant_data:"\
+      " #{@merchant_data}, optin_id: #{@optin_id}, optin_state: #{@optin_state}, seller_of_record:"\
+      " #{@seller_of_record}, timestamp: #{@timestamp}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} merchant_id: #{@merchant_id.inspect}, merchant_request_id:"\
+      " #{@merchant_request_id.inspect}, merchant_transaction_id:"\
+      " #{@merchant_transaction_id.inspect}, payment_method: #{@payment_method.inspect}, result:"\
+      " #{@result.inspect}, bank_id: #{@bank_id.inspect}, charge_id: #{@charge_id.inspect},"\
+      " charge_status: #{@charge_status.inspect}, country: #{@country.inspect}, hosted:"\
+      " #{@hosted.inspect}, merchant_data: #{@merchant_data.inspect}, optin_id:"\
+      " #{@optin_id.inspect}, optin_state: #{@optin_state.inspect}, seller_of_record:"\
+      " #{@seller_of_record.inspect}, timestamp: #{@timestamp.inspect}>"
+    end
+  end
+end

data/lib/boku_direct_payments_api/models/charge_plus_optin_response_hosted.rb

@@ -0,0 +1,75 @@
+# boku_direct_payments_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module BokuDirectPaymentsApi
+  # ChargePlusOptinResponseHosted Model.
+  class ChargePlusOptinResponseHosted < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # URL, where the user should be redirected to so the charge can be
+    # authorized
+    # @return [String]
+    attr_accessor :redirect_url
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['redirect_url'] = 'redirect-url'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      []
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(redirect_url = nil)
+      @redirect_url = redirect_url
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      redirect_url = hash.key?('redirect-url') ? hash['redirect-url'] : nil
+
+      # Create object from extracted values.
+      ChargePlusOptinResponseHosted.new(redirect_url)
+    end
+
+    def self.from_element(root)
+      redirect_url = XmlUtilities.from_element(root, 'redirect-url', String)
+
+      new(redirect_url)
+    end
+
+    def to_xml_element(doc, root_name)
+      root = doc.create_element(root_name)
+
+      XmlUtilities.add_as_subelement(doc, root, 'redirect-url', redirect_url)
+
+      root
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} redirect_url: #{@redirect_url}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} redirect_url: #{@redirect_url.inspect}>"
+    end
+  end
+end

data/lib/boku_direct_payments_api/models/charge_request.rb

@@ -0,0 +1,332 @@
+# boku_direct_payments_api
+#
+# This file was automatically generated by
+# APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module BokuDirectPaymentsApi
+  # 'charge' Request - General Parameters
+  class ChargeRequest < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # ISO 4217 three-letter currency code.
+    # @return [String]
+    attr_accessor :currency
+
+    # Boku-assigned merchant ID.
+    # @return [String]
+    attr_accessor :merchant_id
+
+    # A short purchase description that appears on the consumer bill. A string
+    # longer than 20 characters will be truncated.
+    # @return [String]
+    attr_accessor :merchant_item_description
+
+    # Merchant-assigned unique request ID.
+    # Multiple requests received with the same merchant-request-id will be
+    # handled idempotently within the idempotency window.
+    # @return [String]
+    attr_accessor :merchant_request_id
+
+    # Merchant-assigned transaction ID.
+    # _***Boku recommends merchants send this ID for future reference**_
+    # @return [String]
+    attr_accessor :merchant_transaction_id
+
+    # Total amount to charge, including tax.
+    # @return [Float]
+    attr_accessor :total_amount
+
+    # The IP address of the consumer. Helps improve fraud detection by
+    # supporting internal risk checks and partner decisions. Supports IPv4 and
+    # IPv6 formats.
+    # @return [String]
+    attr_accessor :consumer_ip_address
+
+    # Merchant-supplied metadata. This metadata is returned in the 'charge'
+    # response and can be available in merchant reports.
+    # @return [String]
+    attr_accessor :merchant_data
+
+    # Merchant-assigned unique opt-in ID.
+    # @return [String]
+    attr_accessor :merchant_optin_id
+
+    # Supplies the URL for Boku to send a notification once the charge is
+    # complete.
+    # _***Required only for transactions open longer than 24 hours, such as
+    # direct debits. Consult your Integration Manager to confirm if this is
+    # needed for your integration.**_
+    # @return [String]
+    attr_accessor :notification_url
+
+    # Boku-assigned consumer opt-in ID.
+    # @return [String]
+    attr_accessor :optin_id
+
+    # A merchant-defined identifier for the subscription product. Required only
+    # when the opt-in purpose is 'subscription-mandate'. The SKU used in the
+    # charge request must match the one provided during opt-in.
+    # @return [String]
+    attr_accessor :product_sku
+
+    # Optin and Charge Request API can be made for specific Seller of Record
+    # previously registered with Boku.
+    # @return [SellerOfRecord]
+    attr_accessor :seller_of_record
+
+    # **DISCLAIMER: This API or element is use-case specific and not needed for
+    # generic usage of our payment product. Please disregard unless otherwise
+    # directed to include in your integration.**
+    # Element containing settlement information about the original charge.
+    # @return [Settlement]
+    attr_accessor :settlement
+
+    # ISO 3166-1 alpha-2 country code where this operation is occurring (e.g.,
+    # which storefront).
+    # @return [String]
+    attr_accessor :source_country
+
+    # ISO 3166-1 alpha-2 country code where this operation is occurring (e.g.,
+    # which storefront).
+    # @return [Subscription]
+    attr_accessor :subscription
+
+    # Specifies how long to block waiting for a response
+    # @return [Timeout]
+    attr_accessor :timeout
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['currency'] = 'currency'
+      @_hash['merchant_id'] = 'merchant-id'
+      @_hash['merchant_item_description'] = 'merchant-item-description'
+      @_hash['merchant_request_id'] = 'merchant-request-id'
+      @_hash['merchant_transaction_id'] = 'merchant-transaction-id'
+      @_hash['total_amount'] = 'total-amount'
+      @_hash['consumer_ip_address'] = 'consumer-ip-address'
+      @_hash['merchant_data'] = 'merchant-data'
+      @_hash['merchant_optin_id'] = 'merchant-optin-id'
+      @_hash['notification_url'] = 'notification-url'
+      @_hash['optin_id'] = 'optin-id'
+      @_hash['product_sku'] = 'product-sku'
+      @_hash['seller_of_record'] = 'seller-of-record'
+      @_hash['settlement'] = 'settlement'
+      @_hash['source_country'] = 'source-country'
+      @_hash['subscription'] = 'subscription'
+      @_hash['timeout'] = 'timeout'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        consumer_ip_address
+        merchant_data
+        merchant_optin_id
+        notification_url
+        optin_id
+        product_sku
+        seller_of_record
+        settlement
+        source_country
+        subscription
+        timeout
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(currency = nil, merchant_id = nil,
+                   merchant_item_description = nil, merchant_request_id = nil,
+                   merchant_transaction_id = nil, total_amount = nil,
+                   consumer_ip_address = SKIP, merchant_data = SKIP,
+                   merchant_optin_id = SKIP, notification_url = SKIP,
+                   optin_id = SKIP, product_sku = SKIP, seller_of_record = SKIP,
+                   settlement = SKIP, source_country = SKIP,
+                   subscription = SKIP, timeout = SKIP)
+      @currency = currency
+      @merchant_id = merchant_id
+      @merchant_item_description = merchant_item_description
+      @merchant_request_id = merchant_request_id
+      @merchant_transaction_id = merchant_transaction_id
+      @total_amount = total_amount
+      @consumer_ip_address = consumer_ip_address unless consumer_ip_address == SKIP
+      @merchant_data = merchant_data unless merchant_data == SKIP
+      @merchant_optin_id = merchant_optin_id unless merchant_optin_id == SKIP
+      @notification_url = notification_url unless notification_url == SKIP
+      @optin_id = optin_id unless optin_id == SKIP
+      @product_sku = product_sku unless product_sku == SKIP
+      @seller_of_record = seller_of_record unless seller_of_record == SKIP
+      @settlement = settlement unless settlement == SKIP
+      @source_country = source_country unless source_country == SKIP
+      @subscription = subscription unless subscription == SKIP
+      @timeout = timeout unless timeout == SKIP
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      currency = hash.key?('currency') ? hash['currency'] : nil
+      merchant_id = hash.key?('merchant-id') ? hash['merchant-id'] : nil
+      merchant_item_description =
+        hash.key?('merchant-item-description') ? hash['merchant-item-description'] : nil
+      merchant_request_id =
+        hash.key?('merchant-request-id') ? hash['merchant-request-id'] : nil
+      merchant_transaction_id =
+        hash.key?('merchant-transaction-id') ? hash['merchant-transaction-id'] : nil
+      total_amount = hash.key?('total-amount') ? hash['total-amount'] : nil
+      consumer_ip_address =
+        hash.key?('consumer-ip-address') ? hash['consumer-ip-address'] : SKIP
+      merchant_data = hash.key?('merchant-data') ? hash['merchant-data'] : SKIP
+      merchant_optin_id =
+        hash.key?('merchant-optin-id') ? hash['merchant-optin-id'] : SKIP
+      notification_url =
+        hash.key?('notification-url') ? hash['notification-url'] : SKIP
+      optin_id = hash.key?('optin-id') ? hash['optin-id'] : SKIP
+      product_sku = hash.key?('product-sku') ? hash['product-sku'] : SKIP
+      seller_of_record = SellerOfRecord.from_hash(hash['seller-of-record']) if
+        hash['seller-of-record']
+      settlement = Settlement.from_hash(hash['settlement']) if hash['settlement']
+      source_country =
+        hash.key?('source-country') ? hash['source-country'] : SKIP
+      subscription = Subscription.from_hash(hash['subscription']) if hash['subscription']
+      timeout = Timeout.from_hash(hash['timeout']) if hash['timeout']
+
+      # Create object from extracted values.
+      ChargeRequest.new(currency,
+                        merchant_id,
+                        merchant_item_description,
+                        merchant_request_id,
+                        merchant_transaction_id,
+                        total_amount,
+                        consumer_ip_address,
+                        merchant_data,
+                        merchant_optin_id,
+                        notification_url,
+                        optin_id,
+                        product_sku,
+                        seller_of_record,
+                        settlement,
+                        source_country,
+                        subscription,
+                        timeout)
+    end
+
+    def self.from_element(root)
+      currency = XmlUtilities.from_element(root, 'currency', String)
+      merchant_id = XmlUtilities.from_element(root, 'merchant-id', String)
+      merchant_item_description = XmlUtilities.from_element(
+        root, 'merchant-item-description', String
+      )
+      merchant_request_id = XmlUtilities.from_element(root,
+                                                      'merchant-request-id',
+                                                      String)
+      merchant_transaction_id = XmlUtilities.from_element(
+        root, 'merchant-transaction-id', String
+      )
+      total_amount = XmlUtilities.from_element(root, 'total-amount', Float)
+      consumer_ip_address = XmlUtilities.from_element(root,
+                                                      'consumer-ip-address',
+                                                      String)
+      merchant_data = XmlUtilities.from_element(root, 'merchant-data', String)
+      merchant_optin_id = XmlUtilities.from_element(root, 'merchant-optin-id',
+                                                    String)
+      notification_url = XmlUtilities.from_element(root, 'notification-url',
+                                                   String)
+      optin_id = XmlUtilities.from_element(root, 'optin-id', String)
+      product_sku = XmlUtilities.from_element(root, 'product-sku', String)
+      seller_of_record = XmlUtilities.from_element(root, 'seller-of-record',
+                                                   SellerOfRecord)
+      settlement = XmlUtilities.from_element(root, 'Settlement', Settlement)
+      source_country = XmlUtilities.from_element(root, 'source-country', String)
+      subscription = XmlUtilities.from_element(root, 'subscription',
+                                               Subscription)
+      timeout = XmlUtilities.from_element(root, 'timeout', Timeout)
+
+      new(currency,
+          merchant_id,
+          merchant_item_description,
+          merchant_request_id,
+          merchant_transaction_id,
+          total_amount,
+          consumer_ip_address,
+          merchant_data,
+          merchant_optin_id,
+          notification_url,
+          optin_id,
+          product_sku,
+          seller_of_record,
+          settlement,
+          source_country,
+          subscription,
+          timeout)
+    end
+
+    def to_xml_element(doc, root_name)
+      root = doc.create_element(root_name)
+
+      XmlUtilities.add_as_subelement(doc, root, 'currency', currency)
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-id', merchant_id)
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-item-description',
+                                     merchant_item_description)
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-request-id',
+                                     merchant_request_id)
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-transaction-id',
+                                     merchant_transaction_id)
+      XmlUtilities.add_as_subelement(doc, root, 'total-amount', total_amount)
+      XmlUtilities.add_as_subelement(doc, root, 'consumer-ip-address',
+                                     consumer_ip_address)
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-data', merchant_data)
+      XmlUtilities.add_as_subelement(doc, root, 'merchant-optin-id',
+                                     merchant_optin_id)
+      XmlUtilities.add_as_subelement(doc, root, 'notification-url',
+                                     notification_url)
+      XmlUtilities.add_as_subelement(doc, root, 'optin-id', optin_id)
+      XmlUtilities.add_as_subelement(doc, root, 'product-sku', product_sku)
+      XmlUtilities.add_as_subelement(doc, root, 'seller-of-record',
+                                     seller_of_record)
+      XmlUtilities.add_as_subelement(doc, root, 'Settlement', settlement)
+      XmlUtilities.add_as_subelement(doc, root, 'source-country',
+                                     source_country)
+      XmlUtilities.add_as_subelement(doc, root, 'subscription', subscription)
+      XmlUtilities.add_as_subelement(doc, root, 'timeout', timeout)
+
+      root
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} currency: #{@currency}, merchant_id: #{@merchant_id},"\
+      " merchant_item_description: #{@merchant_item_description}, merchant_request_id:"\
+      " #{@merchant_request_id}, merchant_transaction_id: #{@merchant_transaction_id},"\
+      " total_amount: #{@total_amount}, consumer_ip_address: #{@consumer_ip_address},"\
+      " merchant_data: #{@merchant_data}, merchant_optin_id: #{@merchant_optin_id},"\
+      " notification_url: #{@notification_url}, optin_id: #{@optin_id}, product_sku:"\
+      " #{@product_sku}, seller_of_record: #{@seller_of_record}, settlement: #{@settlement},"\
+      " source_country: #{@source_country}, subscription: #{@subscription}, timeout: #{@timeout}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} currency: #{@currency.inspect}, merchant_id: #{@merchant_id.inspect},"\
+      " merchant_item_description: #{@merchant_item_description.inspect}, merchant_request_id:"\
+      " #{@merchant_request_id.inspect}, merchant_transaction_id:"\
+      " #{@merchant_transaction_id.inspect}, total_amount: #{@total_amount.inspect},"\
+      " consumer_ip_address: #{@consumer_ip_address.inspect}, merchant_data:"\
+      " #{@merchant_data.inspect}, merchant_optin_id: #{@merchant_optin_id.inspect},"\
+      " notification_url: #{@notification_url.inspect}, optin_id: #{@optin_id.inspect},"\
+      " product_sku: #{@product_sku.inspect}, seller_of_record: #{@seller_of_record.inspect},"\
+      " settlement: #{@settlement.inspect}, source_country: #{@source_country.inspect},"\
+      " subscription: #{@subscription.inspect}, timeout: #{@timeout.inspect}>"
+    end
+  end
+end