mollie-api-ruby 4.17.0 → 4.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2cecda0428cc1ec88b912368395adf92608fdb85e92f642e95373cd8cdb6399d
-  data.tar.gz: a0ca1de61ed2079f318a58ac70a80f379bde66ef17a90f69836aa387c68326df
+  metadata.gz: 5d31021bd34c5af9e17792f1e8acc179dc81a88527668eb974eac6fad97e70b8
+  data.tar.gz: 1b26db45dd9c2472806386fd5812c86e00c02cbd3df8a4d278d5bfccd85e0cef
 SHA512:
-  metadata.gz: 1d957aeb32e7653adbde02ec1c8c840e94c70e7fe2c467b5c37d58e14323a14f17c37149b7bf6d136e49045f6c8ab094554fdc1a153347bffeea47e2ea2a69d9
-  data.tar.gz: 978df1487eb575b7dd289928996e1d6d474d6a4cd6eb8e9a0099d831cdadec1da95fdab7a70921a53c27773b7eb277f47339ff6b95f00869e9120f1055ab17f0
+  metadata.gz: 34f4d056e61c127e762eac4fd54436b73f7edc50a8ce9a3046d08b769fd755a6bc069491ab0d79545ea81e202b381062dfd1fe110a891f7e3a7a067bfe6a2098
+  data.tar.gz: 35442554e047f3cef8c196b47436a9022cb9d8a6d6f4c9a560a7c7d30f91995fcb1e6ce15b6328eaf3bcd2b83e18102bd3f008b8af1837c830e5cff966d2c272

data/CHANGELOG.md

@@ -4,6 +4,10 @@
 
 All notable changes to this project will be documented in this file.
 
+## 4.18.0 - 2025-07-20
+
+  - (0ab3a06) Add order attributes to Payment API
+
 ## 4.17.0 - 2025-04-21
 
   - (bc414d0) Payment: add release payment authorization API

data/examples/methods/get.rb

@@ -1,11 +1,4 @@
 method = Mollie::Method.get('ideal')
 
-# Include issuers available for the payment method (e.g. for
-# iDEAL, KBC/CBC payment button or gift cards).
+# Include issuer details such as which iDEAL or gift card issuers are available
 method = Mollie::Method.get('ideal', include: 'issuers')
-
-# Include pricing for each payment method
-method = Mollie::Method.get('ideal', include: 'pricing')
-
-# Include both issuers and pricing
-method = Mollie::Method.get('ideal', include: 'issuers,pricing')

data/examples/methods/list.rb

@@ -1,8 +1,17 @@
+# Retrieve all enabled payment methods
 methods = Mollie::Method.all
 
 # Filter by amount and currency
 methods = Mollie::Method.all(amount: { value: '100.00', currency: 'EUR' })
 
-# Retrieve all payment methods that Mollie offers and can be activated by
-# the Organization.
+# Retrieve all payment methods that Mollie offers and can be activated by the Organization
 methods = Mollie::Method.all_available
+
+# Include issuer details such as which iDEAL or gift card issuers are available
+methods = Mollie::Method.all_available(include: "issuers")
+
+# Include pricing for each payment method
+methods = Mollie::Method.all_available(include: "pricing")
+
+# Include issuer details and pricing
+methods = Mollie::Method.all_available(include: "issuers,pricing")

data/lib/mollie/payment/line.rb

@@ -0,0 +1,50 @@
+module Mollie
+  class Payment
+    class Line < Base
+      attr_accessor :type,
+                    :description,
+                    :quantity,
+                    :quantity_unit,
+                    :vat_rate,
+                    :sku,
+                    :categories,
+                    :image_url,
+                    :product_url
+
+      attr_reader :unit_price,
+                  :discount_amount,
+                  :recurring,
+                  :total_amount,
+                  :vat_amount
+
+      def discounted?
+        !@discount_amount.nil?
+      end
+
+      def unit_price=(amount)
+        @unit_price = Mollie::Amount.new(amount)
+      end
+
+      def discount_amount=(amount)
+        @discount_amount = Mollie::Amount.new(amount)
+      end
+
+      def recurring=(object)
+        return if object.nil?
+
+        @recurring = OpenStruct.new(object).tap do |r|
+          r.amount = Mollie::Amount.new(r.amount) if r.amount
+          r.start_date = Date.parse(r.start_date) if r.start_date
+        end
+      end
+
+      def total_amount=(amount)
+        @total_amount = Mollie::Amount.new(amount)
+      end
+
+      def vat_amount=(amount)
+        @vat_amount = Mollie::Amount.new(amount)
+      end
+    end
+  end
+end

data/lib/mollie/payment.rb

@@ -49,6 +49,10 @@ module Mollie
                   :cancel_url,
                   :webhook_url
 
+    attr_reader :lines,
+                :billing_address,
+                :shipping_address
+
     alias links _links
 
     def open?
@@ -185,6 +189,18 @@ module Mollie
       @amount_refunded = Mollie::Amount.new(amount_refunded)
     end
 
+    def lines=(lines)
+      @lines = lines.map { |line| Payment::Line.new(line) }
+    end
+
+    def billing_address=(address)
+      @billing_address = OpenStruct.new(address) if address.is_a?(Hash)
+    end
+
+    def shipping_address=(address)
+      @shipping_address = OpenStruct.new(address) if address.is_a?(Hash)
+    end
+
     def checkout_url
       Util.extract_url(links, 'checkout')
     end

data/lib/mollie/util.rb

@@ -14,9 +14,31 @@ module Mollie
       end
     end
 
-    def camelize_keys(hash)
-      hash.each_with_object({}) do |(key, value), camelized|
-        camelized[camelize(key)] = value
+    CAMELIZE_NESTED = [
+      :lines,
+      "lines",
+      :recurring,
+      "recurring",
+      :billing_address,
+      "billing_address",
+      :shipping_address,
+      "shipping_address"
+    ].freeze
+
+    def camelize_keys(object)
+      case object
+      when Hash
+        object.each_with_object({}) do |(key, value), camelized|
+          camelized[camelize(key)] = if CAMELIZE_NESTED.include?(key)
+            camelize_keys(value)
+          else
+            value
+          end
+        end
+      when Array
+        object.map { |value| camelize_keys(value) }
+      else
+        object
       end
     end
 

data/lib/mollie/version.rb

@@ -1,3 +1,3 @@
 module Mollie
-  VERSION = '4.17.0'.freeze
+  VERSION = '4.18.0'.freeze
 end

data/lib/mollie.rb

@@ -44,6 +44,7 @@ require 'mollie/order/refund'
 require 'mollie/order/shipment'
 require 'mollie/payment/capture'
 require 'mollie/payment/chargeback'
+require 'mollie/payment/line'
 require 'mollie/payment/refund'
 require 'mollie/settlement/capture'
 require 'mollie/settlement/chargeback'

data/test/mollie/payment_test.rb

@@ -124,6 +124,135 @@ module Mollie
       assert_false Payment.new([]).refunded?
     end
 
+    def test_payment_lines_attributes
+      attributes = {
+        resource: "payment",
+        id: "tr_7UhSN1zuXS",
+        lines: [{
+          type: "physical",
+          description: "LEGO 4440 Forest Police Station",
+          quantity: 1,
+          quantity_unit: "pcs",
+          unit_price: { value: "89.00", currency: "EUR" },
+          discount_amount: { value: "10.00", currency: "EUR" },
+          recurring: {
+            description: "A description of the recurring item.",
+            interval: "3 months",
+            amount: { value: "29.00", currency: "EUR" },
+            times: 4,
+            start_date: "2025-05-04"
+          },
+          total_amount: { value: "95.59", currency: "EUR" },
+          vat_rate: "21.00",
+          vat_amount: { value: "16.59", currency: "EUR" },
+          sku: "SKU-12345",
+          categories: ["eco", "meal", "gift", "sport_culture"],
+          image_url: "https://example.org/lego-4440-forest-police-station.jpg",
+          product_url: "https://example.org/lego-4440-forest-police-station"
+        }]
+      }
+
+      payment = Payment.new(attributes)
+      line = payment.lines.first
+
+      assert_equal Payment::Line, line.class
+      assert_equal "physical", line.type
+      assert_equal "LEGO 4440 Forest Police Station", line.description
+      assert_equal 1, line.quantity
+      assert_equal "pcs", line.quantity_unit
+      assert_equal 89.00, line.unit_price.value
+      assert_equal "EUR", line.unit_price.currency
+      assert_equal 10.00, line.discount_amount.value
+      assert_equal "EUR", line.discount_amount.currency
+      assert_equal 95.59, line.total_amount.value
+      assert_equal "EUR", line.total_amount.currency
+      assert_equal "21.00", line.vat_rate
+      assert_equal 16.59, line.vat_amount.value
+      assert_equal "EUR", line.vat_amount.currency
+      assert_equal "SKU-12345", line.sku
+      assert_equal ["eco", "meal", "gift", "sport_culture"], line.categories
+      assert_equal "https://example.org/lego-4440-forest-police-station.jpg", line.image_url
+      assert_equal "https://example.org/lego-4440-forest-police-station", line.product_url
+
+      # Recurring object
+      assert_equal "A description of the recurring item.", line.recurring.description
+      assert_equal "3 months", line.recurring.interval
+      assert_equal 29.00, line.recurring.amount.value
+      assert_equal "EUR", line.recurring.amount.currency
+      assert_equal 4, line.recurring.times
+      assert_equal Date.parse("2025-05-04"), line.recurring.start_date
+    end
+
+    def test_billing_address
+      attributes = {
+        resource: "payment",
+        id: "tr_7UhSN1zuXS",
+        billing_address: {
+          title: "Dhr",
+          given_name: "Piet",
+          family_name: "Mondriaan",
+          organization_name: "Mollie B.V.",
+          street_and_number: "Keizersgracht 313",
+          street_additional: "apt",
+          postal_code: "1234AB",
+          email: "piet@mondriaan.com",
+          phone: "+31208202070",
+          city: "Amsterdam",
+          region: "Noord-Holland",
+          country: "NL"
+        }
+      }
+
+      payment = Payment.new(attributes)
+      assert_equal "Dhr", payment.billing_address.title
+      assert_equal "Piet", payment.billing_address.given_name
+      assert_equal "Mondriaan", payment.billing_address.family_name
+      assert_equal "Mollie B.V.", payment.billing_address.organization_name
+      assert_equal "Keizersgracht 313", payment.billing_address.street_and_number
+      assert_equal "apt", payment.billing_address.street_additional
+      assert_equal "1234AB", payment.billing_address.postal_code
+      assert_equal "piet@mondriaan.com", payment.billing_address.email
+      assert_equal "+31208202070", payment.billing_address.phone
+      assert_equal "Amsterdam", payment.billing_address.city
+      assert_equal "Noord-Holland", payment.billing_address.region
+      assert_equal "NL", payment.billing_address.country
+    end
+
+    def test_shipping_address
+      attributes = {
+        resource: "payment",
+        id: "tr_7UhSN1zuXS",
+        shipping_address: {
+          title: "Dhr",
+          given_name: "Piet",
+          family_name: "Mondriaan",
+          organization_name: "Mollie B.V.",
+          street_and_number: "Keizersgracht 313",
+          street_additional: "apt",
+          postal_code: "1234AB",
+          email: "piet@mondriaan.com",
+          phone: "+31208202070",
+          city: "Amsterdam",
+          region: "Noord-Holland",
+          country: "NL"
+        }
+      }
+
+      payment = Payment.new(attributes)
+      assert_equal "Dhr", payment.shipping_address.title
+      assert_equal "Piet", payment.shipping_address.given_name
+      assert_equal "Mondriaan", payment.shipping_address.family_name
+      assert_equal "Mollie B.V.", payment.shipping_address.organization_name
+      assert_equal "Keizersgracht 313", payment.shipping_address.street_and_number
+      assert_equal "apt", payment.shipping_address.street_additional
+      assert_equal "1234AB", payment.shipping_address.postal_code
+      assert_equal "piet@mondriaan.com", payment.shipping_address.email
+      assert_equal "+31208202070", payment.shipping_address.phone
+      assert_equal "Amsterdam", payment.shipping_address.city
+      assert_equal "Noord-Holland", payment.shipping_address.region
+      assert_equal "NL", payment.shipping_address.country
+    end
+
     def test_create_payment
       stub_request(:post, 'https://api.mollie.com/v2/payments')
         .with(body: %({"amount":{"value":1.95,"currency":"EUR"}}))

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mollie-api-ruby
 version: !ruby/object:Gem::Version
-  version: 4.17.0
+  version: 4.18.0
 platform: ruby
 authors:
 - Mollie B.V.
@@ -255,6 +255,7 @@ files:
 - lib/mollie/payment.rb
 - lib/mollie/payment/capture.rb
 - lib/mollie/payment/chargeback.rb
+- lib/mollie/payment/line.rb
 - lib/mollie/payment/refund.rb
 - lib/mollie/payment_link.rb
 - lib/mollie/permission.rb
@@ -369,7 +370,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Official Mollie API Client for Ruby
 test_files: