solidgate-ruby-sdk 0.1.9 → 0.1.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d961fde0b15268aa678aa14a4578f1de1ad1585d3729c4bdc75168760825bc1
-  data.tar.gz: bf319d42486fed3f868d17994da9041214c89daa63b02d24be45ea9afdd53ac7
+  metadata.gz: 7f1670a04649a2c491affa62db248bd7bb08ecb82d3db6df1d132131ee486bf6
+  data.tar.gz: 1d611dae1d1e9d8ddb8aa8b74161ccb064b57cddfa0f57c2bc2777916f5d7eb6
 SHA512:
-  metadata.gz: 02e23da68d02d2af05bc92880877f671c59c7eb55290e46bb5657207f3c8360fc19c1d31a4df8f0237e9f4fadf381270db3cec098b3ab0df80a1aa04ac21fb31
-  data.tar.gz: c2fa5f81f3d65fab20906c03f427fd15848962b3052801e6148871b02bfe4068547dcee3c45da97a428d905944094c208febcb9b8ffa2bb4b47e2c3aa4c0b298
+  metadata.gz: '08e8fb84413b4e7ad186c4b70c9099764c5d0b7d3b598e12772e07712ebc98890d979b73b7c52a00ed1cb7bb1d833eac20ff85d95e1a1d8f6ddb698a9117fea7'
+  data.tar.gz: 6a4cc2aff3ce40534e1eb77b3a3b5d4e95232edc599e348054890a269eeb09659cf7f6f675b61c408cd10fa213dcf570999a46dc9532ab3c09df113df88e11f3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    solidgate-ruby-sdk (0.1.9)
+    solidgate-ruby-sdk (0.1.10)
       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.

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,22 @@ 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
 
     private
@@ -347,8 +362,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 +410,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 +423,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 +441,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.10"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solidgate-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.1.10
 platform: ruby
 authors:
 - Hector Carrillo