Support embedded payment captures and chargebacks

Author: justincase

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')

lib/mollie/payment.rb

@@ -207,11 +207,23 @@ def refunds(options = {})
     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 = {})

test/fixtures/payments/get_embedded_resources.json

@@ -23,18 +23,74 @@
   "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.",
-        "orderId": "ord_kEn1PlbGa",
+        "metadata": null,
         "paymentId": "tr_WDqYK6vllg",
         "settlementAmount": {
           "value": "-329.99",
@@ -48,10 +104,6 @@
           "payment": {
             "href": "https://api.mollie.com/v2/payments/tr_WDqYK6vllg",
             "type": "application/hal+json"
-          },
-          "order": {
-            "href": "https://api.mollie.com/v2/orders/ord_kEn1PlbGa",
-            "type": "application/hal+json"
           }
         }
       }

test/mollie/payment_test.rb

@@ -235,11 +235,31 @@ def test_restrict_payment_methods_to_country
       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')
+      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')
+      payment = Payment.get('tr_WDqYK6vllg', embed: 'refunds')
 
       assert_equal 're_vD3Jm32wQt', payment.refunds.first.id
       assert_equal 1, payment.refunds.size