multicard 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83e277fb90b85d6ba4d0102b60ad62bf4356f7273c5b23fcdd3c0e5711e22d3d
-  data.tar.gz: 7a1f25bfcfe356be1ee55b58d71c520102e6b9925d44d7434c21fdb94a9c3861
+  metadata.gz: 41b2116da3fd9724e750a8ace1d5803a09a14bf8eb11a58d323a4bc1235321cc
+  data.tar.gz: ced60479704e63bcfe013cef263bc9286368dc119da3448b373d97de53b14a74
 SHA512:
-  metadata.gz: efc811a4c23204b0f617878a7bd2e769d5a21d4aa8bc2a2faaaa857c302cd4e460d6aa3c6ec6fa4f40c35a17afc62b00a579cbd605c51842bfa08b0c85968049
-  data.tar.gz: 5800f6833e8304c7191f631d40421880281aced34fe9a15efb0105e92a3b36a9171de889ef1bc88555d3c25bf3dc697eac1b063e3743b1b770e55107fb3b7655
+  metadata.gz: c1a4f60027a4d7af9d865d434abb4853112051873f7cb86a6d34873b49c0f4dd32def71b7ba59db0f1a45941164536660c34f72f85935354746bca666cb3bf01
+  data.tar.gz: d29d537327f473bcdf8931c83a416ca7a4849607011f4e37b8d6a1c2afcd59772515bdac8dc69107f771ca5c1e611e9b98064159431b06682e5ee70abc5e5bd9

data/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-06-22
+
+### Fixed
+
+- `Payments#partial_refund` now uses the correct Multicard endpoint
+  `DELETE /payment/{uuid}/partial` with body `{ refund_amount, ofd, card_pan? }`.
+  Previously it issued `POST /payment/{uuid}/refund/partial { amount }` (wrong
+  verb, path, and missing the mandatory `ofd` fiscal array).
+
+### Changed
+
+- **Breaking:** `Payments#partial_refund` signature is now
+  `partial_refund(payment_id, refund_amount:, ofd:, card_pan: nil)`
+  (was `partial_refund(payment_id, amount:)`). `ofd` is required (the original
+  receipt is cancelled and a new one issued for the remaining items); `card_pan`
+  is optional and only used for wallet apps (Payme/Click).
+- `HttpClient#delete` and `Resources::Base#delete` now accept an optional JSON
+  `body:`, enabling DELETE-with-body requests.
+
 ## [0.1.1] - 2026-02-21
 
 ### Changed
@@ -12,7 +31,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Updated gem author metadata
 - Replaced HTTP.rb with Net::HTTP (zero runtime dependencies)
 
-## [0.1.0] - 2026-02-16
+## [0.1.0] - 2026-02-21
 
 ### Added
 

data/README.md

@@ -210,8 +210,16 @@ client.payments.confirm('payment-uuid', otp_code: '123456')
 # Full refund
 client.payments.refund('payment-uuid')
 
-# Partial refund
-client.payments.partial_refund('payment-uuid', amount: 100_000)
+# Partial refund — cancels the original fiscal receipt and issues a new one
+# for the remaining items, so the `ofd` array is mandatory.
+client.payments.partial_refund(
+  'payment-uuid',
+  refund_amount: 100_000,
+  ofd: [{ vat_percent: 12, price: 100_000, amount: 1, package_code: '1234567', mxik: '08110' }]
+)
+
+# Wallet refunds (Payme/Click) additionally require the masked PAN:
+client.payments.partial_refund('payment-uuid', refund_amount: 100_000, ofd: [...], card_pan: '8600****1234')
 ```
 
 ### Fiscal Receipt

data/lib/multicard/client.rb

@@ -51,7 +51,7 @@ module Multicard
         # The 401 retry in authenticated_request is still applied (token refresh).
         @http_client.post(path, body: body || {}, headers: headers)
       when :delete
-        @http_client.delete(path, params: params || {}, headers: headers)
+        @http_client.delete(path, body: body, params: params || {}, headers: headers)
       else
         raise ArgumentError, "Unsupported HTTP method: #{method}"
       end

data/lib/multicard/configuration.rb

@@ -11,7 +11,7 @@ module Multicard
     def initialize(**options)
       @application_id = options[:application_id]
       @secret = options[:secret]
-      @base_url = options[:base_url] || DEFAULT_BASE_URL
+      @base_url = (options[:base_url] || DEFAULT_BASE_URL).chomp('/')
       @timeout = options[:timeout] || DEFAULT_TIMEOUT
       @open_timeout = options[:open_timeout] || DEFAULT_OPEN_TIMEOUT
       @logger = options[:logger]

data/lib/multicard/http_client.rb

@@ -18,8 +18,8 @@ module Multicard
       request(:post, path, body: body, headers: headers)
     end
 
-    def delete(path, params: {}, headers: {})
-      request(:delete, path, params: params, headers: headers)
+    def delete(path, body: nil, params: {}, headers: {})
+      request(:delete, path, body: body, params: params, headers: headers)
     end
 
     def get_with_retry(path, params: {}, headers: {}, retries: 2)

data/lib/multicard/resources/base.rb

@@ -19,8 +19,8 @@ module Multicard
         @client.authenticated_request(:post, path, body: body)
       end
 
-      def delete(path, params = {})
-        @client.authenticated_request(:delete, path, params: params)
+      def delete(path, body: nil, params: {})
+        @client.authenticated_request(:delete, path, body: body, params: params)
       end
 
       def default_store_id

data/lib/multicard/resources/payments.rb

@@ -113,11 +113,20 @@ module Multicard
 
       # Partial refund.
       #
+      # Cancels the original fiscal receipt and issues a new one for the
+      # remaining items (the +ofd+ array is mandatory for partial refunds).
+      #
       # @param payment_id [String] payment ID (UUID)
-      # @param amount [Integer] refund amount in tiyin
+      # @param refund_amount [Integer] refund amount in tiyin
+      # @param ofd [Array<Hash>] fiscal receipt items for the remaining goods
+      # @param card_pan [String, nil] masked PAN — required only for wallet apps (Payme/Click)
       # @return [Response]
-      def partial_refund(payment_id, amount:)
-        post("/payment/#{encode_path(payment_id)}/refund/partial", { amount: amount })
+      def partial_refund(payment_id, refund_amount:, ofd:, card_pan: nil)
+        delete("/payment/#{encode_path(payment_id)}/partial", body: {
+          refund_amount: refund_amount,
+          ofd: ofd,
+          card_pan: card_pan
+        }.compact)
       end
 
       # Submit a fiscal receipt link.

data/lib/multicard/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Multicard
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: multicard
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Pavel Skripin
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-21 00:00:00.000000000 Z
+date: 2026-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake