mollie-api-ruby 4.14.0 → 4.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 727393f8a67630c11c052da7b282456a2ca751cbbd23b39825bca74bbbe5192d
-  data.tar.gz: c0c66af4d34388f7ce8648d33a1cb94b8ff0ac433e419ce2996aa55b1f727b0f
+  metadata.gz: 8c69f3ca558a810762900aa7a74798129377ee91d41b136d5b32428085451d8f
+  data.tar.gz: cde2ea24aa5eeae5218d71af093b7081e9dbcdd5f94dd9b84bb7f9cef9d841de
 SHA512:
-  metadata.gz: 9d99d066f8f1a02e06158680e5bdef30f329fada43091e49eda123534cb9e7449a0792ae30a30a2ffc0efe1b7c0da587dba14c6bf82e8bd4810cdd025038e93d
-  data.tar.gz: 2f6998f5f91999f5c794d2d3479c26552e6487f006221b9e51149f165ec80b7ea392c636e3f2b328e8e0bd13e47bdbcfcc967e5fed67257f33b7ad321ff88768
+  metadata.gz: 25f7c4a575b44e5ce96a8842fdb9c95f817f0beb0ab7150d221394a2b6c906921d538a8a398e6aab6f0569e772ef589fbdb6c75f51d6caa02ad9e95b6e313987
+  data.tar.gz: 27d0e5486b0e3c18f6e69eadc606aaaa75a32bd851780a3bebfbbd2f7952193743cfd3c2c7a133cd553292bfe561ca99727717bb710b62eba679d48576a8a49c

data/CHANGELOG.md

@@ -4,6 +4,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## 4.16.0 - 2025-03-19
+
+  - (9caf303) Support embedded payment captures and chargebacks
+  - (ed1916e) Add support for embedded refunds
+  - (c322aca) Avoid frozen string literals warnings with Ruby 3.4
+
+## 4.15.0 - 2024-12-01
+
+  - (f659c19) Add Balance API
+
 ## 4.14.0 - 2024-11-02
 
   - (0876f2b) Add Payment Links API

data/examples/balances/get-primary.rb

@@ -0,0 +1 @@
+primary_balance = Mollie::Balance.primary

data/examples/balances/get-report.rb

@@ -0,0 +1,2 @@
+balance = Mollie::Balance.get("bal_gVMhHKqSSRYJyPsuoPNFH")
+report = balance.report

data/examples/balances/get.rb

@@ -0,0 +1 @@
+balance = Mollie::Balance.get("bal_gVMhHKqSSRYJyPsuoPNFH")

data/examples/balances/list-transactions.rb

@@ -0,0 +1,2 @@
+balance = Mollie::Balance.get("bal_gVMhHKqSSRYJyPsuoPNFH")
+transactions = balance.transactions

data/examples/balances/list.rb

@@ -0,0 +1 @@
+balances = Mollie::Balance.all

data/examples/payments/get.rb

@@ -1 +1,4 @@
 payment = Mollie::Payment.get('tr_7UhSN1zuXS')
+
+# With embedded resources
+payment = Mollie::Payment.get('tr_7UhSN1zuXS', embed: 'captures,chargebacks,refunds')

data/lib/mollie/balance/report.rb

@@ -0,0 +1,25 @@
+module Mollie
+  class Balance
+    class Report < Base
+      attr_accessor :balance_id,
+                    :time_zone,
+                    :grouping,
+                    :totals,
+                    :_links
+
+      attr_reader :from,
+                  :until
+
+      alias links _links
+
+      def from=(from)
+        @from = Date.parse(from)
+      end
+
+      def until=(until_date)
+        # `until` is a reserved keyword
+        @until = Date.parse(until_date)
+      end
+    end
+  end
+end

data/lib/mollie/balance/transaction.rb

@@ -0,0 +1,41 @@
+module Mollie
+  class Balance
+    class Transaction < Base
+      attr_accessor :id,
+                    :type,
+                    :_links
+
+      attr_reader :result_amount,
+                  :initial_amount,
+                  :deductions,
+                  :context,
+                  :created_at
+
+      alias links _links
+
+      def self.embedded_resource_name
+        "balance_transactions"
+      end
+
+      def result_amount=(amount)
+        @result_amount = Mollie::Amount.new(amount)
+      end
+
+      def initial_amount=(amount)
+       @initial_amount = Mollie::Amount.new(amount)
+      end
+
+      def deductions=(amount)
+       @deductions = Mollie::Amount.new(amount)
+      end
+
+      def context=(context)
+        @context = OpenStruct.new(context) if context.is_a?(Hash)
+      end
+
+      def created_at=(created_at)
+        @created_at = Time.parse(created_at.to_s)
+      end
+    end
+  end
+end

data/lib/mollie/balance.rb

@@ -0,0 +1,53 @@
+module Mollie
+  class Balance < Base
+    attr_accessor :id,
+                  :mode,
+                  :currency,
+                  :description,
+                  :status,
+                  :transfer_frequency,
+                  :transfer_reference,
+                  :_links
+
+    attr_reader :transfer_threshold,
+                :transfer_destination,
+                :available_amount,
+                :pending_amount,
+                :created_at
+
+    alias links _links
+
+    def self.primary(options = {})
+      get('primary', options)
+    end
+
+    def transfer_threshold=(amount)
+      @transfer_threshold = Mollie::Amount.new(amount)
+    end
+
+    def transfer_destination=(transfer_destination)
+      @transfer_destination = OpenStruct.new(transfer_destination) if transfer_destination.is_a?(Hash)
+    end
+
+    def available_amount=(amount)
+      @available_amount = Mollie::Amount.new(amount)
+    end
+
+    def pending_amount=(amount)
+      @pending_amount = Mollie::Amount.new(amount)
+    end
+
+    def created_at=(created_at)
+      @created_at = Time.parse(created_at.to_s)
+    end
+
+    def report(options = {})
+      response = Client.instance.perform_http_call("GET", "balances/#{id}", "report", {}, options)
+      Balance::Report.new(response)
+    end
+
+    def transactions(options = {})
+      Balance::Transaction.all(options.merge(balance_id: id))
+    end
+  end
+end

data/lib/mollie/client.rb

@@ -50,8 +50,8 @@ module Mollie
       @api_key         = api_key
       @version_strings = []
 
-      add_version_string 'Mollie/' << VERSION
-      add_version_string 'Ruby/' << RUBY_VERSION
+      add_version_string "Mollie/#{VERSION}"
+      add_version_string "Ruby/#{RUBY_VERSION}"
       add_version_string OpenSSL::OPENSSL_VERSION.split(' ').slice(0, 2).join '/'
     end
 

data/lib/mollie/payment.rb

@@ -197,15 +197,33 @@ module Mollie
     end
 
     def refunds(options = {})
-      Payment::Refund.all(options.merge(payment_id: id))
+      resources = (attributes['_embedded']['refunds'] if attributes['_embedded'])
+
+      if resources.nil?
+        Payment::Refund.all(options.merge(payment_id: id))
+      else
+        List.new({ '_embedded' => { 'refunds' => resources } }, Payment::Refund)
+      end
     end
 
     def chargebacks(options = {})
-      Payment::Chargeback.all(options.merge(payment_id: id))
+      resources = (attributes['_embedded']['chargebacks'] if attributes['_embedded'])
+
+      if resources.nil?
+        Payment::Chargeback.all(options.merge(payment_id: id))
+      else
+        List.new({ '_embedded' => { 'chargebacks' => resources } }, Payment::Chargeback)
+      end
     end
 
     def captures(options = {})
-      Payment::Capture.all(options.merge(payment_id: id))
+      resources = (attributes['_embedded']['captures'] if attributes['_embedded'])
+
+      if resources.nil?
+        Payment::Capture.all(options.merge(payment_id: id))
+      else
+        List.new({ '_embedded' => { 'captures' => resources } }, Payment::Capture)
+      end
     end
 
     def customer(options = {})

data/lib/mollie/version.rb

@@ -1,3 +1,3 @@
 module Mollie
-  VERSION = '4.14.0'.freeze
+  VERSION = '4.16.0'.freeze
 end

data/lib/mollie.rb

@@ -13,6 +13,7 @@ require 'mollie/version'
 
 require 'mollie/base'
 require 'mollie/amount'
+require 'mollie/balance'
 require 'mollie/chargeback'
 require 'mollie/client'
 require 'mollie/customer'
@@ -31,6 +32,8 @@ require 'mollie/settlement'
 require 'mollie/subscription'
 require 'mollie/terminal'
 
+require 'mollie/balance/report'
+require 'mollie/balance/transaction'
 require 'mollie/customer/mandate'
 require 'mollie/customer/payment'
 require 'mollie/customer/subscription'

data/test/fixtures/balances/get.json

@@ -0,0 +1,38 @@
+{
+  "resource": "balance",
+  "id": "bal_gVMhHKqSSRYJyPsuoPNFH",
+  "mode": "live",
+  "currency": "EUR",
+  "description": "Primary balance",
+  "availableAmount": {
+    "currency": "EUR",
+    "value": "905.25"
+  },
+  "pendingAmount": {
+    "currency": "EUR",
+    "value": "0.00"
+  },
+  "transferFrequency": "twice-a-month",
+  "transferThreshold": {
+    "currency": "EUR",
+    "value": "5.00"
+  },
+  "transferReference": "Mollie settlement",
+  "transferDestination": {
+    "type": "bank-account",
+    "beneficiaryName": "John Doe",
+    "bankAccount": "NL55INGB0000000000"
+  },
+  "status": "active",
+  "createdAt": "2019-01-10T12:06:28+00:00",
+  "_links": {
+    "self": {
+      "href": "https://api.mollie.com/v2/balances/bal_gVMhHKqSSRYJyPsuoPNFH",
+      "type": "application/hal+json"
+    },
+    "documentation": {
+      "href": "https://docs.mollie.com/reference/get-balance",
+      "type": "text/html"
+    }
+  }
+}

data/test/fixtures/balances/list.json

@@ -0,0 +1,34 @@
+{
+  "count": 1,
+  "_embedded": {
+    "balances": [
+      {
+        "resource": "balance",
+        "id": "bal_one"
+      },
+      {
+        "resource": "balance",
+        "id": "bal_two"
+      },
+      {
+        "resource": "balance",
+        "id": "bal_three"
+      }
+    ]
+  },
+  "_links": {
+    "documentation": {
+      "href": "https://docs.mollie.com/reference/v2/balances-api/list-balances",
+      "type": "text/html"
+    },
+    "self": {
+      "href": "https://api.mollie.com/v2/balances?limit=5",
+      "type": "application/hal+json"
+    },
+    "previous": null,
+    "next": {
+      "href": "https://api.mollie.com/v2/balances?from=bal_gVMhHKqSSRYJyPsuoPABC&limit=5",
+      "type": "application/hal+json"
+    }
+  }
+}

data/test/fixtures/balances/list_transactions.json

@@ -0,0 +1,65 @@
+{
+  "count": 2,
+  "_embedded": {
+    "balance_transactions": [
+      {
+        "resource": "balance_transaction",
+        "id": "baltr_QM24QwzUWR4ev4Xfgyt29A",
+        "type": "refund",
+        "resultAmount": {
+          "currency": "EUR",
+          "value": "-10.25"
+        },
+        "initialAmount": {
+          "currency": "EUR",
+          "value": "-10.00"
+        },
+        "deductions": {
+          "currency": "EUR",
+          "value": "-0.25"
+        },
+        "context": {
+          "paymentId": "tr_7UhSN1zuXS",
+          "refundId": "re_4qqhO89gsT"
+        },
+        "createdAt": "2021-01-10T12:06:28+00:00"
+      },
+      {
+        "resource": "balance_transaction",
+        "id": "baltr_WhmDwNYR87FPDbiwBhUXCh",
+        "type": "payment",
+        "resultAmount": {
+          "currency": "EUR",
+          "value": "9.71"
+        },
+        "initialAmount": {
+          "currency": "EUR",
+          "value": "10.00"
+        },
+        "deductions": {
+          "currency": "EUR",
+          "value": "-0.29"
+        },
+        "context": {
+          "paymentId": "tr_7UhSN1zuXS"
+        },
+        "createdAt": "2021-01-10T12:06:28+00:00"
+      }
+    ]
+  },
+  "_links": {
+    "self": {
+      "href": "...",
+      "type": "application/hal+json"
+    },
+    "previous": null,
+    "next": {
+      "href": "https://api.mollie.com/v2/balances/bal_gVMhHKqSSRYJyPsuoPNFH/transactions?from=baltr_rXeW2yPqqDUyfAqq8fS5Bg&limit=5",
+      "type": "application/hal+json"
+    },
+    "documentation": {
+      "href": "...",
+      "type": "text/html"
+    }
+  }
+}

data/test/fixtures/balances/report.json

@@ -0,0 +1,149 @@
+{
+  "resource": "balance-report",
+  "balanceId": "bal_gVMhHKqSSRYJyPsuoPNFH",
+  "timeZone": "Europe/Amsterdam",
+  "from": "2024-01-01",
+  "until": "2024-01-31",
+  "grouping": "transaction-categories",
+  "totals": {
+    "open": {
+      "available": {
+        "amount": {
+          "currency": "EUR",
+          "value": "0.00"
+        }
+      },
+      "pending": {
+        "amount": {
+          "currency": "EUR",
+          "value": "0.00"
+        }
+      }
+    },
+    "payments": {
+      "immediatelyAvailable": {
+        "amount": {
+          "currency": "EUR",
+          "value": "0.00"
+        }
+      },
+      "pending": {
+        "amount": {
+          "currency": "EUR",
+          "value": "4.98"
+        },
+        "subtotals": [
+          {
+            "transactionType": "payment",
+            "count": 1,
+            "amount": {
+              "currency": "EUR",
+              "value": "4.98"
+            },
+            "subtotals": [
+              {
+                "method": "ideal",
+                "count": 1,
+                "amount": {
+                  "currency": "EUR",
+                  "value": "4.98"
+                }
+              }
+            ]
+          }
+        ]
+      },
+      "movedToAvailable": {
+        "amount": {
+          "currency": "EUR",
+          "value": "0.00"
+        }
+      }
+    },
+    "refunds": {},
+    "capital": {},
+    "chargebacks": {},
+    "transfers": {},
+    "fee-prepayments": {
+      "immediatelyAvailable": {
+        "amount": {
+          "currency": "EUR",
+          "value": "0.00"
+        }
+      },
+      "movedToAvailable": {
+        "amount": {
+          "currency": "EUR",
+          "value": "-0.36"
+        },
+        "subtotals": [
+          {
+            "prepaymentPartType": "fee",
+            "count": 1,
+            "amount": {
+              "currency": "EUR",
+              "value": "-0.29"
+            },
+            "subtotals": [
+              {
+                "feeType": "payment-fee",
+                "method": "ideal",
+                "count": 1,
+                "amount": {
+                  "currency": "EUR",
+                  "value": "-0.29"
+                }
+              }
+            ]
+          },
+          {
+            "prepaymentPartType": "fee-vat",
+            "amount": {
+              "currency": "EUR",
+              "value": "-0.0609"
+            }
+          },
+          {
+            "prepaymentPartType": "fee-rounding-compensation",
+            "amount": {
+              "currency": "EUR",
+              "value": "-0.0091"
+            }
+          }
+        ]
+      },
+      "pending": {
+        "amount": {
+          "currency": "EUR",
+          "value": "-0.36"
+        },
+        "subtotals": []
+      }
+    },
+    "corrections": {},
+    "close": {
+      "available": {
+        "amount": {
+          "currency": "EUR",
+          "value": "0.00"
+        }
+      },
+      "pending": {
+        "amount": {
+          "currency": "EUR",
+          "value": "4.32"
+        }
+      }
+    }
+  },
+  "_links": {
+    "self": {
+      "href": "...",
+      "type": "application/hal+json"
+    },
+    "documentation": {
+      "href": "...",
+      "type": "text/html"
+    }
+  }
+}

data/test/fixtures/payments/get_embedded_resources.json

@@ -0,0 +1,126 @@
+{
+  "resource": "payment",
+  "id": "tr_WDqYK6vllg",
+  "mode": "test",
+  "createdAt": "2018-03-20T13:13:37+00:00",
+  "amount": {
+    "value": "10.00",
+    "currency": "EUR"
+  },
+  "description": "Order #12345",
+  "method": null,
+  "metadata": {
+    "order_id": "12345"
+  },
+  "status": "open",
+  "isCancelable": false,
+  "locale": "nl_NL",
+  "restrictPaymentMethodsToCountry": "NL",
+  "expiresAt": "2018-03-20T13:28:37+00:00",
+  "details": null,
+  "profileId": "pfl_QkEhN94Ba",
+  "sequenceType": "oneoff",
+  "redirectUrl": "https://webshop.example.org/order/12345/",
+  "webhookUrl": "https://webshop.example.org/payments/webhook/",
+  "_embedded": {
+    "captures": [
+      {
+        "resource": "capture",
+        "id": "cpt_mNepDkEtco6ah3QNPUGYH",
+        "mode": "test",
+        "amount": {
+          "value": "10.00",
+          "currency": "EUR"
+        },
+        "status": "succeeded",
+        "createdAt": "2025-03-19T15:03:34+00:00",
+        "description": "Capture for order #12345",
+        "settlementAmount": {
+          "value": "10.00",
+          "currency": "EUR"
+        },
+        "paymentId": "tr_WDqYK6vllg",
+        "_links": {
+          "self": {
+            "href": "https://api.mollie.com/v2/payments/tr_WDqYK6vllg/captures/cpt_mNepDkEtco6ah3QNPUGYH",
+            "type": "application/hal+json"
+          },
+          "payment": {
+            "href": "https://api.mollie.com/v2/payments/tr_WDqYK6vllg",
+            "type": "application/hal+json"
+          }
+        }
+      }
+    ],
+    "chargebacks": [
+      {
+        "resource": "chargeback",
+        "id": "chb_ls7ahg",
+        "amount": {
+          "value": "10.00",
+          "currency": "EUR"
+        },
+        "created_at": "2022-01-03T13:20:37+00:00",
+        "payment_id": "tr_WDqYK6vllg",
+        "settlement_amount": {
+          "value": "-10.00",
+          "currency": "EUR"
+        },
+        "_links": {
+          "self": {
+            "href": "https://api.mollie.com/v2/payments/tr_WDqYK6vllg/chargebacks/chb_ls7ahg",
+            "type": "application/hal+json"
+          },
+          "payment": {
+            "href": "https://api.mollie.com/v2/payments/tr_WDqYK6vllg",
+            "type": "application/hal+json"
+          }
+        }
+      }
+    ],
+    "refunds": [
+      {
+        "resource": "refund",
+        "id": "re_vD3Jm32wQt",
+        "mode": "test",
+        "amount": {
+          "value": "329.99",
+          "currency": "EUR"
+        },
+        "status": "pending",
+        "createdAt": "2019-01-15T15:41:21+00:00",
+        "description": "Required quantity not in stock, refunding one photo book.",
+        "metadata": null,
+        "paymentId": "tr_WDqYK6vllg",
+        "settlementAmount": {
+          "value": "-329.99",
+          "currency": "EUR"
+        },
+        "_links": {
+          "self": {
+            "href": "https://api.mollie.com/v2/payments/tr_WDqYK6vllg/refunds/re_vD3Jm32wQt",
+            "type": "application/hal+json"
+          },
+          "payment": {
+            "href": "https://api.mollie.com/v2/payments/tr_WDqYK6vllg",
+            "type": "application/hal+json"
+          }
+        }
+      }
+    ]
+  },
+  "_links": {
+    "self": {
+      "href": "https://api.mollie.com/v2/payments/tr_WDqYK6vllg",
+      "type": "application/hal+json"
+    },
+    "checkout": {
+      "href": "https://www.mollie.com/payscreen/select-method/WDqYK6vllg",
+      "type": "text/html"
+    },
+    "documentation": {
+      "href": "https://docs.mollie.com/reference/v2/payments-api/get-payment",
+      "type": "text/html"
+    }
+  }
+}

data/test/mollie/balance/transaction_test.rb

@@ -0,0 +1,36 @@
+require 'helper'
+
+module Mollie
+  class Balance
+    class TransactionTest < Test::Unit::TestCase
+      def test_setting_attributes
+        attributes = {
+          id: "baltr_QM24QwzUWR4ev4Xfgyt29A",
+          type: "refund",
+          result_amount: { "value" => "-10.25", "currency" => "EUR" },
+          initial_amount: { "value" => "-10.00", "currency" => "EUR" },
+          deductions: { "value" => "0.25", "currency" => "EUR" },
+          context: {
+            "paymentId" => "tr_7UhSN1zuXS",
+            "refundId" => "re_4qqhO89gsT"
+          },
+          created_at: "2021-01-10T12:06:28+00:00"
+        }
+
+        balance = Balance::Transaction.new(attributes)
+
+        assert_equal "baltr_QM24QwzUWR4ev4Xfgyt29A", balance.id
+        assert_equal "refund", balance.type
+        assert_equal BigDecimal("-10.25"), balance.result_amount.value
+        assert_equal "EUR", balance.result_amount.currency
+        assert_equal BigDecimal("-10.00"), balance.initial_amount.value
+        assert_equal "EUR", balance.initial_amount.currency
+        assert_equal BigDecimal("0.25"), balance.deductions.value
+        assert_equal "EUR", balance.deductions.currency
+        assert_equal "tr_7UhSN1zuXS", balance.context.paymentId
+        assert_equal "re_4qqhO89gsT", balance.context.refundId
+        assert_equal Time.parse("2021-01-10T12:06:28+00:00"), balance.created_at
+      end
+    end
+  end
+end

data/test/mollie/balance_test.rb

@@ -0,0 +1,108 @@
+require "helper"
+
+module Mollie
+  class BalanceTest < Test::Unit::TestCase
+    GET_BALANCE = read_fixture('balances/get.json')
+    GET_BALANCE_REPORT = read_fixture('balances/report.json')
+    LIST_BALANCES = read_fixture('balances/list.json')
+    LIST_BALANCE_TRANSACTIONS = read_fixture('balances/list_transactions.json')
+
+    def test_setting_attributes
+      attributes = {
+        id: "bal_gVMhHKqSSRYJyPsuoPNFH",
+        mode: "live",
+        currency: "EUR",
+        description: "Primary balance",
+        available_amount: { "value" => "0.00", "currency" => "EUR" },
+        pending_amount: { "value" => "0.00", "currency" => "EUR" },
+        transfer_frequency: "twice-a-month",
+        transfer_threshold: { "value" => "5.00", "currency" => "EUR" },
+        transfer_reference: "Mollie settlement",
+        transfer_destination: {
+          type: "bank-account",
+          beneficiary_name: "John Doe",
+          bank_account: "NL55INGB0000000000"
+        },
+        status: "active",
+        created_at:  "2018-03-20T09:13:37+00:00",
+      }
+
+      balance = Mollie::Balance.new(attributes)
+
+      assert_equal "bal_gVMhHKqSSRYJyPsuoPNFH", balance.id
+      assert_equal "live", balance.mode
+      assert_equal "EUR", balance.currency
+      assert_equal "Primary balance", balance.description
+      assert_equal BigDecimal("0.00"), balance.available_amount.value
+      assert_equal "EUR", balance.available_amount.currency
+      assert_equal BigDecimal("0.00"), balance.pending_amount.value
+      assert_equal "EUR", balance.pending_amount.currency
+      assert_equal "twice-a-month", balance.transfer_frequency
+      assert_equal BigDecimal("5.00"), balance.transfer_threshold.value
+      assert_equal "EUR", balance.transfer_threshold.currency
+      assert_equal "Mollie settlement", balance.transfer_reference
+      assert_equal "bank-account", balance.transfer_destination.type
+      assert_equal "John Doe", balance.transfer_destination.beneficiary_name
+      assert_equal "NL55INGB0000000000", balance.transfer_destination.bank_account
+      assert_equal "active", balance.status
+      assert_equal Time.parse('2018-03-20T09:13:37+00:00'), balance.created_at
+    end
+
+    def test_get_balance
+      stub_request(:get, "https://api.mollie.com/v2/balances/bal_gVMhHKqSSRYJyPsuoPNFH")
+        .to_return(status: 200, body: GET_BALANCE, headers: {})
+
+      balance = Balance.get("bal_gVMhHKqSSRYJyPsuoPNFH")
+      assert_equal "bal_gVMhHKqSSRYJyPsuoPNFH", balance.id
+    end
+
+    def test_list_balances
+      stub_request(:get, 'https://api.mollie.com/v2/balances')
+        .to_return(status: 200, body: LIST_BALANCES, headers: {})
+
+      balances = Balance.all
+      assert_equal 3, balances.size
+      assert_equal 'bal_one', balances[0].id
+      assert_equal 'bal_two', balances[1].id
+      assert_equal 'bal_three', balances[2].id
+    end
+
+    def test_primary
+      stub_request(:get, "https://api.mollie.com/v2/balances/primary")
+        .to_return(status: 200, body: GET_BALANCE, headers: {})
+
+      balance = Balance.primary
+      assert_equal "bal_gVMhHKqSSRYJyPsuoPNFH", balance.id
+    end
+
+    def test_report
+      stub_request(:get, "https://api.mollie.com/v2/balances/bal_gVMhHKqSSRYJyPsuoPNFH")
+        .to_return(status: 200, body: GET_BALANCE, headers: {})
+
+      stub_request(:get, 'https://api.mollie.com/v2/balances/bal_gVMhHKqSSRYJyPsuoPNFH/report')
+        .to_return(status: 200, body: GET_BALANCE_REPORT, headers: {})
+
+      report = Balance.get("bal_gVMhHKqSSRYJyPsuoPNFH").report
+
+      assert_equal Date.parse("2024-01-01"), report.from
+      assert_equal Date.parse("2024-01-31"), report.until
+      assert_equal "transaction-categories", report.grouping
+      assert_equal "4.98", report.totals.dig("payments", "pending", "amount", "value")
+      assert_equal "-0.36", report.totals.dig("fee_prepayments", "moved_to_available", "amount", "value")
+    end
+
+    def test_list_transactions
+      stub_request(:get, "https://api.mollie.com/v2/balances/bal_gVMhHKqSSRYJyPsuoPNFH")
+        .to_return(status: 200, body: GET_BALANCE, headers: {})
+
+      stub_request(:get, 'https://api.mollie.com/v2/balances/bal_gVMhHKqSSRYJyPsuoPNFH/transactions')
+        .to_return(status: 200, body: LIST_BALANCE_TRANSACTIONS, headers: {})
+
+      transactions = Balance.get("bal_gVMhHKqSSRYJyPsuoPNFH").transactions
+      assert_equal 2, transactions.size
+
+      assert_equal "baltr_QM24QwzUWR4ev4Xfgyt29A", transactions[0].id
+      assert_equal "baltr_WhmDwNYR87FPDbiwBhUXCh", transactions[1].id
+    end
+  end
+end

data/test/mollie/payment_test.rb

@@ -2,6 +2,8 @@ require 'helper'
 
 module Mollie
   class PaymentTest < Test::Unit::TestCase
+    GET_PAYMENT_WITH_EMBEDDED_RESOURCES = read_fixture('payments/get_embedded_resources.json')
+
     def test_setting_attributes
       attributes = {
         resource:   'payment',
@@ -233,6 +235,36 @@ module Mollie
       assert_equal 'NL', payment.restrict_payment_methods_to_country
     end
 
+    def test_embedded_captures
+      stub_request(:get, 'https://api.mollie.com/v2/payments/tr_WDqYK6vllg?embed=captures')
+        .to_return(status: 200, body: GET_PAYMENT_WITH_EMBEDDED_RESOURCES, headers: {})
+
+      payment = Payment.get('tr_WDqYK6vllg', embed: 'captures')
+
+      assert_equal 'cpt_mNepDkEtco6ah3QNPUGYH', payment.captures.first.id
+      assert_equal 1, payment.captures.size
+    end
+
+    def test_embedded_chargebacks
+      stub_request(:get, 'https://api.mollie.com/v2/payments/tr_WDqYK6vllg?embed=chargebacks')
+        .to_return(status: 200, body: GET_PAYMENT_WITH_EMBEDDED_RESOURCES, headers: {})
+
+      payment = Payment.get('tr_WDqYK6vllg', embed: 'chargebacks')
+
+      assert_equal 'chb_ls7ahg', payment.chargebacks.first.id
+      assert_equal 1, payment.chargebacks.size
+    end
+
+    def test_embedded_refunds
+      stub_request(:get, 'https://api.mollie.com/v2/payments/tr_WDqYK6vllg?embed=refunds')
+        .to_return(status: 200, body: GET_PAYMENT_WITH_EMBEDDED_RESOURCES, headers: {})
+
+      payment = Payment.get('tr_WDqYK6vllg', embed: 'refunds')
+
+      assert_equal 're_vD3Jm32wQt', payment.refunds.first.id
+      assert_equal 1, payment.refunds.size
+    end
+
     def test_list_refunds
       stub_request(:get, 'https://api.mollie.com/v2/payments/pay-id/refunds')
         .to_return(status: 200, body: %({"_embedded" : {"refunds" : [{"id":"ref-id", "payment_id":"pay-id"}]}}), headers: {})

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: mollie-api-ruby
 version: !ruby/object:Gem::Version
-  version: 4.14.0
+  version: 4.16.0
 platform: ruby
 authors:
 - Mollie B.V.
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-11-02 00:00:00.000000000 Z
+date: 2025-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ostruct
@@ -129,6 +128,11 @@ files:
 - bin/setup
 - docs/migration_v2_2_x.md
 - docs/migration_v3_x.md
+- examples/balances/get-primary.rb
+- examples/balances/get-report.rb
+- examples/balances/get.rb
+- examples/balances/list-transactions.rb
+- examples/balances/list.rb
 - examples/captures/get-payment.rb
 - examples/captures/get-settlement.rb
 - examples/captures/get-shipment.rb
@@ -226,6 +230,9 @@ files:
 - lib/mollie-api-ruby.rb
 - lib/mollie.rb
 - lib/mollie/amount.rb
+- lib/mollie/balance.rb
+- lib/mollie/balance/report.rb
+- lib/mollie/balance/transaction.rb
 - lib/mollie/base.rb
 - lib/mollie/chargeback.rb
 - lib/mollie/client.rb
@@ -263,6 +270,10 @@ files:
 - lib/mollie/util.rb
 - lib/mollie/version.rb
 - mollie-api-ruby.gemspec
+- test/fixtures/balances/get.json
+- test/fixtures/balances/list.json
+- test/fixtures/balances/list_transactions.json
+- test/fixtures/balances/report.json
 - test/fixtures/captures/get.json
 - test/fixtures/captures/list.json
 - test/fixtures/customer/get.json
@@ -292,6 +303,7 @@ files:
 - test/fixtures/payment_links/list.json
 - test/fixtures/payment_links/update.json
 - test/fixtures/payments/get.json
+- test/fixtures/payments/get_embedded_resources.json
 - test/fixtures/refunds/get.json
 - test/fixtures/shipments/create.json
 - test/fixtures/shipments/get.json
@@ -303,6 +315,8 @@ files:
 - test/fixtures/terminals/list.json
 - test/helper.rb
 - test/mollie/amount_test.rb
+- test/mollie/balance/transaction_test.rb
+- test/mollie/balance_test.rb
 - test/mollie/base_test.rb
 - test/mollie/chargeback_test.rb
 - test/mollie/client_test.rb
@@ -341,7 +355,6 @@ licenses:
 - BSD
 metadata:
   changelog_uri: https://github.com/mollie/mollie-api-ruby/blob/master/CHANGELOG.md
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -356,11 +369,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key: 
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Official Mollie API Client for Ruby
 test_files:
+- test/fixtures/balances/get.json
+- test/fixtures/balances/list.json
+- test/fixtures/balances/list_transactions.json
+- test/fixtures/balances/report.json
 - test/fixtures/captures/get.json
 - test/fixtures/captures/list.json
 - test/fixtures/customer/get.json
@@ -390,6 +406,7 @@ test_files:
 - test/fixtures/payment_links/list.json
 - test/fixtures/payment_links/update.json
 - test/fixtures/payments/get.json
+- test/fixtures/payments/get_embedded_resources.json
 - test/fixtures/refunds/get.json
 - test/fixtures/shipments/create.json
 - test/fixtures/shipments/get.json
@@ -401,6 +418,8 @@ test_files:
 - test/fixtures/terminals/list.json
 - test/helper.rb
 - test/mollie/amount_test.rb
+- test/mollie/balance/transaction_test.rb
+- test/mollie/balance_test.rb
 - test/mollie/base_test.rb
 - test/mollie/chargeback_test.rb
 - test/mollie/client_test.rb