solidgate-ruby-sdk 0.1.9 → 0.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d961fde0b15268aa678aa14a4578f1de1ad1585d3729c4bdc75168760825bc1
-  data.tar.gz: bf319d42486fed3f868d17994da9041214c89daa63b02d24be45ea9afdd53ac7
+  metadata.gz: ba80035d65a601fc4acd8eef2809b188d165589931403b8fa2b7b05d8766b393
+  data.tar.gz: dcb4ec3eac2443669916e75eefcc040a65cfe00e271aab353473305b07c23b57
 SHA512:
-  metadata.gz: 02e23da68d02d2af05bc92880877f671c59c7eb55290e46bb5657207f3c8360fc19c1d31a4df8f0237e9f4fadf381270db3cec098b3ab0df80a1aa04ac21fb31
-  data.tar.gz: c2fa5f81f3d65fab20906c03f427fd15848962b3052801e6148871b02bfe4068547dcee3c45da97a428d905944094c208febcb9b8ffa2bb4b47e2c3aa4c0b298
+  metadata.gz: 46322d80c7d7694a1e662be9545740af7fb16f2bb6b6d4189476a17ba01d7f65cba006ad22e3c7986c755ed8d5333bc16d7557bff30ce26560984cacf5f16d63
+  data.tar.gz: bfa35892c6ec90740614e4d773abe38e22d800b52196ff5b287135d8ca0214f95ba66d673eb613c76147a7fc2371d3db3c08494030bb35842433529106f07cc7

data/CHANGELOG.md

@@ -7,6 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.10] - 2026-02-03
+- Added refund method example to README
+
 ## [0.1.9] - 2026-02-03
 - Added documentation for restore_subscription method
 - Added restore_subscription to README.md usage examples

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    solidgate-ruby-sdk (0.1.9)
+    solidgate-ruby-sdk (0.1.11)
       faraday
       faraday-multipart
 

data/README.md

@@ -1,3 +1,5 @@
+[![Gem Version](https://badge.fury.io/rb/solidgate-ruby-sdk.svg)](https://badge.fury.io/rb/solidgate-ruby-sdk)
+
 # Solidgate Ruby SDK
 
 A Ruby (unofficial) SDK for integrating with the Solidgate payment gateway API.
@@ -101,11 +103,8 @@ client.capture_payment('payment_id_123', amount: 500)
 # Void an authorized payment (before settlement)
 client.void_payment('payment_id_123')
 
-# Refund a captured payment
-client.refund_payment('payment_id_123')
-
-# Partial refund
-client.refund_payment('payment_id_123', amount: 500, reason: 'Customer request')
+# Refund by order ID (pay.solidgate.com)
+client.refund(order_id: 'order_123', amount: 1000)
 ```
 
 ### Subscription Management
@@ -140,6 +139,15 @@ client.cancel_subscription(
 client.restore_subscription(
   subscription_id: 'sub_123'
 )
+
+### Update subscription payment method
+
+# Update the payment token associated with an existing subscription
+client.update_subscription_payment_method(
+  subscription_id: 'sub_123',
+  token: 'tok_abc123'
+)
+
 ```
 
 ### Subscription Pause Scheduling

data/lib/solidgate/client.rb

@@ -60,7 +60,7 @@ module Solidgate
     # @raise [AuthenticationError] if API credentials are invalid
     #
     def create_payment(params)
-      post("/v1/charge", params)
+      post("/v1/charge", body: params)
     end
 
     # Retrieves payment details and current status.
@@ -88,7 +88,7 @@ module Solidgate
     # @raise [InvalidRequestError] if payment cannot be captured (wrong status, already captured, etc.)
     #
     def capture_payment(payment_id, params = {})
-      post("/v1/charge/#{payment_id}/capture", params)
+      post("/v1/charge/#{payment_id}/capture", body: params)
     end
 
     # Voids a payment that has not yet been settled.
@@ -113,7 +113,7 @@ module Solidgate
     # @raise [InvalidRequestError] if payment cannot be refunded
     #
     def refund_payment(payment_id, params = {})
-      post("/v1/charge/#{payment_id}/refund", params)
+      post("/v1/charge/#{payment_id}/refund", body: params)
     end
 
     # Settles a payment for final processing.
@@ -138,7 +138,7 @@ module Solidgate
     # @raise [InvalidRequestError] if subscription parameters are invalid
     #
     def create_subscription(params)
-      post("/v1/subscription", params)
+      post("/v1/subscription", body: params)
     end
 
     # Retrieves the current status and details of a subscription.
@@ -152,7 +152,7 @@ module Solidgate
     # @raise [InvalidRequestError] if subscription_id is not found
     #
     def subscription_status(subscription_id)
-      post("/api/v1/subscription/status", { subscription_id: subscription_id })
+      post("/api/v1/subscription/status", body: { subscription_id: subscription_id })
     end
 
     # Switches a subscription to a different product/plan.
@@ -171,7 +171,7 @@ module Solidgate
     #   )
     #
     def switch_subscription_product(params)
-      post("/api/v1/subscription/switch-subscription-product", params)
+      post("/api/v1/subscription/switch-subscription-product", body: params)
     end
 
     # Updates an existing pause schedule for a subscription.
@@ -184,7 +184,7 @@ module Solidgate
     # @raise [InvalidRequestError] if subscription has no pause schedule or params are invalid
     #
     def update_subscription_pause(subscription_id, params)
-      patch("/api/v1/subscriptions/#{subscription_id}/pause-schedule", params)
+      patch("/api/v1/subscriptions/#{subscription_id}/pause-schedule", body: params)
     end
 
     # Creates a pause schedule for a subscription.
@@ -198,7 +198,7 @@ module Solidgate
     # @raise [InvalidRequestError] if subscription is invalid or already has a pause schedule
     #
     def create_subscription_pause(subscription_id, params)
-      post("/api/v1/subscriptions/#{subscription_id}/pause-schedule", params)
+      post("/api/v1/subscriptions/#{subscription_id}/pause-schedule", body: params)
     end
 
     # Deletes/cancels a pending pause schedule for a subscription.
@@ -221,7 +221,7 @@ module Solidgate
     # @raise [InvalidRequestError] if subscription is invalid or already cancelled
     #
     def cancel_subscription(params)
-      post("/api/v1/subscription/cancel", params)
+      post("/api/v1/subscription/cancel", body: params)
     end
 
     # Creates a new product in the Solidgate catalog.
@@ -234,7 +234,7 @@ module Solidgate
     # @raise [InvalidRequestError] if product parameters are invalid
     #
     def create_product(params)
-      post("/api/v1/products", params)
+      post("/api/v1/products", body: params)
     end
 
     # Creates a new price for an existing product.
@@ -248,7 +248,7 @@ module Solidgate
     # @raise [InvalidRequestError] if product_id is invalid or price params are invalid
     #
     def create_price(product_id, params)
-      post("/api/v1/products/#{product_id}/prices", params)
+      post("/api/v1/products/#{product_id}/prices", body: params)
     end
 
     # Retrieves all products from the Solidgate catalog.
@@ -322,7 +322,39 @@ module Solidgate
     #   client.restore_subscription(subscription_id: 'sub_12345')
     #
     def restore_subscription(params)
-      post("/api/v1/subscription/restore", params)
+      post("/api/v1/subscription/restore", body: params)
+    end
+
+    # Creates a refund for a transaction.
+    #
+    # @param params [Hash] refund parameters:
+    #   - :order_id [String] the order identifier to refund
+    #   - :amount [Integer] refund amount in minor units (for partial refunds)
+    # @return [Hash] refund response including refund status and details
+    # @raise [InvalidRequestError] if refund parameters are invalid
+    #
+    # @example Create a refund
+    #   client.refund(order_id: 'ord_12345', amount: 1000)
+    #
+    def refund(params)
+      post("/api/v1/refund", body: params, base_url: "https://pay.solidgate.com")
+    end
+
+    # Updates the payment method (token) associated with an existing subscription.
+    #
+    # @param params [Hash] update parameters including:
+    #   - :subscription_id [String] the subscription to update
+    #   - :token [String] new payment token / payment method identifier
+    # @return [Hash] response from the API with updated subscription/payment method details
+    # @raise [InvalidRequestError] if params are invalid
+    #
+    # @example Update a subscription's payment method
+    #   client.update_subscription_payment_method(
+    #     subscription_id: 'sub_123',
+    #     token: 'tok_abc123'
+    #   )
+    def update_subscription_payment_method(params)
+      post("/api/v1/subscription/update-token", body: params)
     end
 
     private
@@ -347,8 +379,17 @@ module Solidgate
     # @return [Faraday::Connection] configured HTTP connection
     #
     def connection
-      @connection ||= Faraday.new(
-        url: config.api_url,
+      @connection ||= connection_for(config.api_url)
+    end
+
+    # Creates a Faraday HTTP connection for the specified base URL.
+    #
+    # @param base_url [String] the base URL for the connection
+    # @return [Faraday::Connection] configured HTTP connection
+    #
+    def connection_for(base_url)
+      Faraday.new(
+        url: base_url,
         headers: default_headers
       ) do |conn|
         conn.request :multipart
@@ -386,10 +427,11 @@ module Solidgate
     #
     # @param path [String] API endpoint path
     # @param body [Hash] request body parameters
+    # @param base_url [String, nil] optional base URL to override the default API URL
     # @return [Hash] parsed response body
     #
-    def post(path, body = {})
-      request(:post, path, body)
+    def post(path, body: {}, base_url: nil)
+      request(:post, path, body: body, base_url: base_url)
     end
 
     # Performs a PATCH request to the specified path.
@@ -398,8 +440,8 @@ module Solidgate
     # @param body [Hash] request body parameters
     # @return [Hash] parsed response body
     #
-    def patch(path, body = {})
-      request(:patch, path, body)
+    def patch(path, body: {})
+      request(:patch, path, body: body)
     end
 
     # Performs a DELETE request to the specified path.
@@ -416,16 +458,19 @@ module Solidgate
     # @param method [Symbol] HTTP method (:get, :post, :patch, :delete)
     # @param path [String] API endpoint path
     # @param body [Hash, nil] optional request body
+    # @param base_url [String, nil] optional base URL to override the default API URL
     # @return [Hash] parsed response body
     # @raise [TimeoutError] if request times out
     # @raise [ConnectionError] if connection fails
     # @raise [Error] for other unexpected errors
     #
-    def request(method, path, body = nil)
+    def request(method, path, body: nil, base_url: nil)
       body_json = body ? JSON.generate(body) : ''
       signature = generate_signature(body_json)
 
-      response = connection.send(method) do |req|
+      conn = base_url ? connection_for(base_url) : connection
+
+      response = conn.send(method) do |req|
         req.url path
         req.headers["Merchant"] = config.public_key
         req.headers["Signature"] = signature

data/lib/solidgate/payment.rb

@@ -64,14 +64,15 @@ module Solidgate
     # @param amount [Integer] amount to refund in cents (optional, defaults to full amount)
     # @param reason [String] refund reason (optional)
     # @return [Hash] refund response
-    def refund(payment_id, amount: nil, reason: nil)
-      raise ArgumentError, "payment_id is required" if payment_id.nil? || payment_id.empty?
+    def refund(order_id, amount: nil, reason: nil)
+      raise ArgumentError, "order_id is required" if order_id.nil? || order_id.empty?
       
       params = {}
-      params[:amount] = amount if amount
-      params[:reason] = reason if reason
+      params[:amount]   = amount if amount
+      params[:reason]   = reason if reason
+      params[:order_id] = order_id
       
-      client.refund_payment(payment_id, params)
+      client.refund(params)
     end
 
     private

data/lib/solidgate/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Solidgate
-  VERSION = "0.1.9"
+  VERSION = "0.1.11"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solidgate-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.1.11
 platform: ruby
 authors:
 - Hector Carrillo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-03 00:00:00.000000000 Z
+date: 2026-02-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday