valor_pay_tech 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6f1db53b0153dd157e88c7446cedf647acdbd9815176f7b432d0a35603ba9531
+  data.tar.gz: 7a33faa7126fd52045deb972bb488e6adc5b5ea759e707c9ee9ea1b623a9f699
+SHA512:
+  metadata.gz: 1dfbe4b013db7463cb5a0ec0059e8e6b87f2d075e797a9b88d077a69611fbd4b57643a9f91a2d1d13f0abe20a6839c9eafa0f7c9a7faaa4073bbf74cf62bac40
+  data.tar.gz: fb28f51bf6f5b32f18467c0a1e865dbc1122fe2265518f2cace0002d5fcd998136032209162878f7706bac10fda4f7fd61458423956732ec3e5981ebe12a2c53

data/lib/valor_pay_tech/client.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module ValorPayTech
+  class Client
+    attr_reader :configuration
+
+    def initialize(configuration)
+      @configuration = configuration
+      configuration.validate!
+    end
+
+    def payment_links
+      @payment_links ||= Resources::PaymentLinks.new(self)
+    end
+
+    def post(path, params = {})
+      uri = URI("#{configuration.base_url}/#{path}")
+      request = Net::HTTP::Post.new(uri)
+      request["Content-Type"] = "application/json"
+      request.body = build_body(params).to_json
+
+      response = execute(uri, request)
+      handle_response(response)
+    rescue Errno::ECONNREFUSED, Errno::ETIMEDOUT, SocketError, Net::OpenTimeout, Net::ReadTimeout => e
+      raise ConnectionError, "Connection failed: #{e.message}"
+    end
+
+    private
+
+    def build_body(params)
+      {
+        appid: configuration.app_id,
+        appkey: configuration.app_key,
+        epi: configuration.epi
+      }.merge(params)
+    end
+
+    def execute(uri, request)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = 10
+      http.read_timeout = 30
+      http.request(request)
+    end
+
+    def handle_response(http_response)
+      status = http_response.code.to_i
+      body = parse_body(http_response.body)
+
+      case status
+      when 200..299
+        Response.new(status: status, body: body)
+      when 400..499
+        raise BadRequestError.new("Bad request: #{http_response.body}", status: status, body: body)
+      when 500..599
+        raise ServerError.new("Server error: #{http_response.body}", status: status, body: body)
+      else
+        raise ApiError.new("Unexpected response: #{status}", status: status, body: body)
+      end
+    end
+
+    def parse_body(raw)
+      JSON.parse(raw)
+    rescue JSON::ParserError
+      { "raw" => raw }
+    end
+  end
+end

data/lib/valor_pay_tech/configuration.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module ValorPayTech
+  class Configuration
+    ENVIRONMENTS = {
+      staging: "https://securelink-staging.valorpaytech.com:4430",
+      production: "https://securelink.valorpaytech.com"
+    }.freeze
+
+    attr_accessor :app_id, :app_key, :epi, :environment
+
+    def initialize
+      @environment = :staging
+    end
+
+    def base_url
+      ENVIRONMENTS.fetch(environment) do
+        raise ConfigurationError, "Unknown environment: #{environment}. Use :staging or :production."
+      end
+    end
+
+    def validate!
+      missing = []
+      missing << "app_id" if app_id.nil? || app_id.to_s.strip.empty?
+      missing << "app_key" if app_key.nil? || app_key.to_s.strip.empty?
+      missing << "epi" if epi.nil? || epi.to_s.strip.empty?
+
+      return if missing.empty?
+
+      raise ConfigurationError, "Missing required configuration: #{missing.join(", ")}"
+    end
+  end
+end

data/lib/valor_pay_tech/errors.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module ValorPayTech
+  class Error < StandardError; end
+
+  class ConfigurationError < Error; end
+
+  class ConnectionError < Error; end
+
+  class ApiError < Error
+    attr_reader :status, :body
+
+    def initialize(message = nil, status: nil, body: nil)
+      @status = status
+      @body = body
+      super(message)
+    end
+  end
+
+  class BadRequestError < ApiError; end
+
+  class ServerError < ApiError; end
+end

data/lib/valor_pay_tech/resources/payment_links.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module ValorPayTech
+  module Resources
+    class PaymentLinks
+      REQUIRED_PARAMS = %i[amount txn_type].freeze
+
+      DEFAULTS = {
+        epage: 1,
+        shipping_country: "US"
+      }.freeze
+
+      def initialize(client)
+        @client = client
+      end
+
+      def create(params = {})
+        validate!(params)
+        @client.post("?hostedpagesale", DEFAULTS.merge(params))
+      end
+
+      private
+
+      def validate!(params)
+        missing = REQUIRED_PARAMS.select { |key| params[key].nil? }
+        return if missing.empty?
+
+        raise ArgumentError, "Missing required parameters: #{missing.join(", ")}"
+      end
+    end
+  end
+end

data/lib/valor_pay_tech/response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module ValorPayTech
+  class Response
+    attr_reader :status, :body
+
+    def initialize(status:, body:)
+      @status = status
+      @body = body
+    end
+
+    def success?
+      status == 200 && body.is_a?(Hash) && body["error_no"] == "S00"
+    end
+  end
+end

data/lib/valor_pay_tech/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ValorPayTech
+  VERSION = "0.1.0"
+end

data/lib/valor_pay_tech.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative "valor_pay_tech/version"
+require_relative "valor_pay_tech/errors"
+require_relative "valor_pay_tech/configuration"
+require_relative "valor_pay_tech/response"
+require_relative "valor_pay_tech/client"
+require_relative "valor_pay_tech/resources/payment_links"
+
+module ValorPayTech
+  class << self
+    def configure
+      yield(configuration)
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def client
+      Client.new(configuration)
+    end
+
+    def reset!
+      @configuration = Configuration.new
+    end
+  end
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: valor_pay_tech
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- robzolkos
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-02-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description:
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/valor_pay_tech.rb
+- lib/valor_pay_tech/client.rb
+- lib/valor_pay_tech/configuration.rb
+- lib/valor_pay_tech/errors.rb
+- lib/valor_pay_tech/resources/payment_links.rb
+- lib/valor_pay_tech/response.rb
+- lib/valor_pay_tech/version.rb
+homepage:
+licenses: []
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: Ruby client for the Valor PayTech API
+test_files: []