solidgate-ruby-sdk 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0cc47da7070971ded0369dbc9c2585f4a5a35990cd71dee534abaa417eb1926f
-  data.tar.gz: c83e001aaf639127e66217c80afa0b7c7da03e852e16518fa167a15697bc1802
+  metadata.gz: 2c09427f81d0f0efc89e60222716d8d66490eec414145f244df791d9c6f486dd
+  data.tar.gz: 87b350ffcec8b48c8506278fd3c0cb24892c99a04348990ffa36f2d242aabfa6
 SHA512:
-  metadata.gz: 32cf87089a35994c5a93c701c4652ee7e534f2ec492a79df05089cb8dd67646ee9b46cc5b584ffe821de2ed6c56bddc3393075c22da7dc5d4359ea36481493e8
-  data.tar.gz: 6e2b585477f4c0d7a654ad05bf42ce1c59a9e3f47a49998f5c3ba5a119f6caa7d22f8af1176478a07a011f4548e0d1a6dfa7fde5cdf59e5fc5507c70c788f0ec
+  metadata.gz: 58cbef4744fbf27bf91b43921d25284b46af5c0be8b50b05c5a938172b418f7d762d708c0f19a59b3686b62d6002a290a3e01ac532d9f8d933e46ad729f89266
+  data.tar.gz: 4244c8c9944e9c1175868ed53726781a36d26d21cd00acf75efe67cc4cbd3fce1a3cbdaf425c38c04d471d06e116b814309c0c640b5d03a5ad04772549290c3e

data/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-06-11
+### Added
+- `decrypt_intent` public method to decrypt payment intents generated by `generate_intent`.
+- Internal `decrypt_payload` helper using AES-256-CBC with IV-prefix parsing.
+
+### Changed
+- Added client spec coverage for encrypt/decrypt round-trip and invalid payload handling.
+
 ## [0.2.0] - 2026-05-05
 ### Added
 - `apm_order_status` endpoint for checking alternative payment method order status.
@@ -94,7 +102,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Thread-safe configuration
 - Comprehensive documentation and examples
 
-[Unreleased]: https://github.com/carrfane/solidgate-ruby-sdk/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/carrfane/solidgate-ruby-sdk/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/carrfane/solidgate-ruby-sdk/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/carrfane/solidgate-ruby-sdk/compare/v0.1.17...v0.2.0
 [0.1.17]: https://github.com/carrfane/solidgate-ruby-sdk/releases/tag/v0.1.17
 [0.1.16]: https://github.com/carrfane/solidgate-ruby-sdk/releases/tag/v0.1.16

data/Gemfile.lock

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

data/lib/solidgate/client.rb

@@ -289,6 +289,19 @@ module Solidgate
       encrypt_payload(params)
     end
 
+    # Decrypts an encrypted payment intent generated by {#generate_intent}.
+    #
+    # @param encrypted_payload [String] URL-safe Base64 encrypted payload
+    # @return [String] decrypted JSON payload
+    # @raise [ArgumentError] if payload cannot be decoded/decrypted
+    #
+    # @example Decrypt payment intent
+    #   payload = client.decrypt_intent(encrypted_intent)
+    #
+    def decrypt_intent(encrypted_payload)
+      decrypt_payload(encrypted_payload)
+    end
+
     # Updates an existing price for a product.
     # Use this to modify the amount, currency, or billing interval of a price.
     #
@@ -663,5 +676,30 @@ module Solidgate
       base64_encoded = Base64.urlsafe_encode64(iv + encrypted)
       base64_encoded.gsub('+', '-').gsub('/', '_')
     end
+
+    # Decrypts a URL-safe Base64 payload encrypted with AES-256-CBC.
+    # Expects the IV to be prepended to the encrypted content.
+    #
+    # @param encrypted_payload [String] URL-safe Base64 encrypted payload
+    # @return [String] decrypted payload
+    # @raise [ArgumentError] if payload format/content is invalid
+    #
+    def decrypt_payload(encrypted_payload)
+      raw_payload = Base64.urlsafe_decode64(encrypted_payload)
+      raise ArgumentError, "Invalid encrypted payload" if raw_payload.bytesize <= IV_LENGTH
+
+      iv = raw_payload[0, IV_LENGTH]
+      encrypted_data = raw_payload[IV_LENGTH..]
+      key = config.private_key[0, KEY_LENGTH]
+
+      cipher = OpenSSL::Cipher.new('aes-256-cbc')
+      cipher.decrypt
+      cipher.key = key
+      cipher.iv = iv
+
+      cipher.update(encrypted_data) + cipher.final
+    rescue ArgumentError, OpenSSL::Cipher::CipherError
+      raise ArgumentError, "Invalid encrypted payload"
+    end
   end
 end

data/lib/solidgate/version.rb

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

data/solidgate.gemspec

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative "lib/solidgate/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "solidgate-ruby-sdk"
+  spec.version = Solidgate::VERSION
+  spec.authors = ["Hector Carrillo"]
+  spec.email = ["carrfane@gmail.com"]
+  
+  spec.summary = "Ruby SDK for Solidgate payment processing"
+  spec.description = "A Ruby SDK for integrating with the Solidgate payment gateway API"
+  spec.homepage = "https://github.com/carrfane/solidgate-ruby-sdk"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.6.0"
+  
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/carrfane/solidgate-ruby-sdk"
+  spec.metadata["changelog_uri"] = "https://github.com/carrfane/solidgate-ruby-sdk/blob/master/CHANGELOG.md"
+  
+  # Specify which files should be added to the gem when it is released.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|circleci)|appveyor)})
+    end
+  end
+  
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  
+  # Runtime dependencies
+  spec.add_dependency "faraday"
+  spec.add_dependency "faraday-multipart"
+  
+  #Development dependencies
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "webmock", "~> 3.0"
+  spec.add_development_dependency "vcr", "~> 6.0"
+  spec.add_development_dependency "rubocop", "~> 1.0"
+  spec.add_development_dependency "pry", "~> 0.14"
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solidgate-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Hector Carrillo
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-05 00:00:00.000000000 Z
+date: 2026-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -133,6 +133,7 @@ files:
 - lib/solidgate/payment.rb
 - lib/solidgate/version.rb
 - lib/solidgate/webhook.rb
+- solidgate.gemspec
 homepage: https://github.com/carrfane/solidgate-ruby-sdk
 licenses:
 - MIT