multicard 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4deef0f73a9d0f65799ff892e950f24b744a350cadd90b2956fc5dd4c91f6f2f
-  data.tar.gz: 1471a57173d4a1b868867350f9de3e9e72513f6fe873bba4fa10767f79044eba
+  metadata.gz: 41b2116da3fd9724e750a8ace1d5803a09a14bf8eb11a58d323a4bc1235321cc
+  data.tar.gz: ced60479704e63bcfe013cef263bc9286368dc119da3448b373d97de53b14a74
 SHA512:
-  metadata.gz: 9ba05346db8cf1fe2b16577f06423fe19b24652c4cb5210124ef313c94355c4645008be1d57157095c33acce7f4b2197f159905fde1188977bc1cc0c2ae44aa4
-  data.tar.gz: e9e987599830d737e9f878bd46938df9308607bc79a5cf3314bf6b4df4f7076ec81a4389deba588ace709ed517b111844da9c1ebe8ec22661e56cf9df6148802
+  metadata.gz: c1a4f60027a4d7af9d865d434abb4853112051873f7cb86a6d34873b49c0f4dd32def71b7ba59db0f1a45941164536660c34f72f85935354746bca666cb3bf01
+  data.tar.gz: d29d537327f473bcdf8931c83a416ca7a4849607011f4e37b8d6a1c2afcd59772515bdac8dc69107f771ca5c1e611e9b98064159431b06682e5ee70abc5e5bd9

data/CHANGELOG.md

@@ -5,7 +5,33 @@ 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.1.0] - 2026-02-16
+## [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
+
+- Updated gem author metadata
+- Replaced HTTP.rb with Net::HTTP (zero runtime dependencies)
+
+## [0.1.0] - 2026-02-21
 
 ### Added
 

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Honey Murena
+Copyright (c) 2026 Pavel Skripin
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,7 +1,6 @@
 # Multicard Ruby SDK
 
 [![Gem Version](https://badge.fury.io/rb/multicard.svg)](https://badge.fury.io/rb/multicard)
-[![CI](https://github.com/pashgo/multicard-ruby/actions/workflows/ci.yml/badge.svg)](https://github.com/pashgo/multicard-ruby/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 Ruby client for the [Multicard](https://multicard.uz) payment gateway (Uzbekistan).
@@ -211,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.0'
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: multicard
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
-- Honey Murena
+- 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
@@ -70,7 +70,7 @@ description: Ruby SDK for Multicard.uz — payment gateway supporting Uzcard, Hu
   and 9 wallet apps (Payme, Click, Uzum, etc.). Invoices, card payments, splits, holds,
   payouts, card binding, and webhook verification.
 email:
-- dev@honeymurena.com
+- skripin.pavel@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []