qpay-rails 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7767296ec61fadc425f9c4f83b9645e464c79407e85e7b6b5783777601b5fd73
+  data.tar.gz: c20862358e7e1ea2633e9185988d832c46d5d325a23a799ac180ca9a32b29ddb
+SHA512:
+  metadata.gz: 5a28a1e6d830189263d1945437578f6a3c8ea935094131120594ff176481b64cdf21026cbcc1e01bff294825727921aa60b449f11ab68e2eccc74da11d783685
+  data.tar.gz: 6f5e9a3a5ec53f4fdcc1211c1aedbbfe828ef9919edc6da0b1fa6107a9a36a9359484c38f492e70be9770313a4326e518540c279196169a81b759b6a577df284

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 QPay SDK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,47 @@
+# QPay Rails
+
+QPay V2 payment integration for Rails.
+
+## Install
+
+```ruby
+gem "qpay-rails"
+```
+
+```bash
+rails generate qpay:install
+```
+
+## Usage
+
+```ruby
+client = QPay::Rails.client
+invoice = client.create_simple_invoice(
+  invoice_code: "YOUR_CODE",
+  sender_invoice_no: "ORDER-001",
+  amount: 10000,
+  callback_url: "https://yoursite.com/qpay/webhooks"
+)
+```
+
+## View Helpers
+
+```erb
+<%= qpay_qr_code(invoice.qr_image) %>
+<%= qpay_payment_links(invoice.urls) %>
+```
+
+## Webhook
+
+Subscribe to payment events:
+
+```ruby
+ActiveSupport::Notifications.subscribe("payment_received.qpay") do |_name, _start, _finish, _id, payload|
+  invoice_id = payload[:invoice_id]
+  # handle payment
+end
+```
+
+## License
+
+MIT

data/app/controllers/qpay/webhooks_controller.rb

@@ -0,0 +1,32 @@
+module QPay
+  class WebhooksController < ActionController::API
+    def create
+      invoice_id = params[:invoice_id]
+
+      unless invoice_id.present?
+        render json: { error: "Missing invoice_id" }, status: :bad_request
+        return
+      end
+
+      begin
+        client = QPay::Rails.client
+        result = client.check_payment(
+          object_type: "INVOICE",
+          object_id: invoice_id
+        )
+
+        if result.rows&.any?
+          ActiveSupport::Notifications.instrument("payment_received.qpay", {
+            invoice_id: invoice_id,
+            result: result
+          })
+          render json: { status: "paid" }
+        else
+          render json: { status: "unpaid" }
+        end
+      rescue StandardError => e
+        render json: { error: e.message }, status: :internal_server_error
+      end
+    end
+  end
+end

data/app/helpers/qpay_helper.rb

@@ -0,0 +1,25 @@
+module QPayHelper
+  def qpay_qr_code(qr_image, size: 256)
+    return "" if qr_image.blank?
+    content_tag(:div, class: "qpay-qr-code", style: "text-align:center;") do
+      image_tag("data:image/png;base64,#{qr_image}", alt: "QPay QR Code", width: size, height: size)
+    end
+  end
+
+  def qpay_payment_links(urls)
+    return "" if urls.blank?
+    content_tag(:div, style: "display:flex;flex-wrap:wrap;gap:8px;justify-content:center;") do
+      safe_join(urls.map { |link|
+        link_to(link[:link] || link["link"] || "#", target: "_blank",
+          style: "display:inline-flex;align-items:center;gap:6px;padding:10px 16px;border:1px solid #ddd;border-radius:8px;text-decoration:none;color:#333;font-size:14px;") do
+          logo = link[:logo] || link["logo"]
+          name = link[:name] || link["name"] || "Pay"
+          parts = []
+          parts << image_tag(logo, width: 24, height: 24, alt: name) if logo.present?
+          parts << name
+          safe_join(parts)
+        end
+      })
+    end
+  end
+end

data/config/routes.rb

@@ -0,0 +1,3 @@
+QPay::Rails::Engine.routes.draw do
+  post "webhooks", to: "webhooks#create"
+end

data/lib/generators/qpay/install_generator.rb

@@ -0,0 +1,24 @@
+module Qpay
+  class InstallGenerator < ::Rails::Generators::Base
+    source_root File.expand_path("templates", __dir__)
+    desc "Install QPay payment integration"
+
+    def copy_initializer
+      template "initializer.rb", "config/initializers/qpay.rb"
+    end
+
+    def add_route
+      route 'mount QPay::Rails::Engine => "/qpay"'
+    end
+
+    def show_instructions
+      say ""
+      say "QPay installed! Set these environment variables:", :green
+      say "  QPAY_BASE_URL=https://merchant.qpay.mn"
+      say "  QPAY_USERNAME=your_username"
+      say "  QPAY_PASSWORD=your_password"
+      say "  QPAY_INVOICE_CODE=your_invoice_code"
+      say "  QPAY_CALLBACK_URL=https://yoursite.com/qpay/webhooks"
+    end
+  end
+end

data/lib/generators/qpay/templates/initializer.rb

@@ -0,0 +1,7 @@
+QPay::Rails.configure do |config|
+  config.base_url     = ENV.fetch("QPAY_BASE_URL", "https://merchant.qpay.mn")
+  config.username     = ENV.fetch("QPAY_USERNAME")
+  config.password     = ENV.fetch("QPAY_PASSWORD")
+  config.invoice_code = ENV.fetch("QPAY_INVOICE_CODE")
+  config.callback_url = ENV.fetch("QPAY_CALLBACK_URL")
+end

data/lib/qpay/rails/client.rb

@@ -0,0 +1,29 @@
+module QPay
+  module Rails
+    class Client
+      class << self
+        def instance
+          @instance ||= build_client
+        end
+
+        def reset!
+          @instance = nil
+        end
+
+        private
+
+        def build_client
+          cfg = QPay::Rails.configuration
+          config = QPay::Config.new(
+            base_url: cfg.base_url,
+            username: cfg.username,
+            password: cfg.password,
+            invoice_code: cfg.invoice_code,
+            callback_url: cfg.callback_url
+          )
+          QPay::Client.new(config: config)
+        end
+      end
+    end
+  end
+end

data/lib/qpay/rails/configuration.rb

@@ -0,0 +1,15 @@
+module QPay
+  module Rails
+    class Configuration
+      attr_accessor :base_url, :username, :password, :invoice_code, :callback_url
+
+      def initialize
+        @base_url = ENV.fetch("QPAY_BASE_URL", "https://merchant.qpay.mn")
+        @username = ENV["QPAY_USERNAME"]
+        @password = ENV["QPAY_PASSWORD"]
+        @invoice_code = ENV["QPAY_INVOICE_CODE"]
+        @callback_url = ENV["QPAY_CALLBACK_URL"]
+      end
+    end
+  end
+end

data/lib/qpay/rails/engine.rb

@@ -0,0 +1,13 @@
+module QPay
+  module Rails
+    class Engine < ::Rails::Engine
+      isolate_namespace QPay::Rails
+
+      initializer "qpay.helpers" do
+        ActiveSupport.on_load(:action_view) do
+          require "qpay_helper"
+        end
+      end
+    end
+  end
+end

data/lib/qpay/rails/version.rb

@@ -0,0 +1,5 @@
+module QPay
+  module Rails
+    VERSION = "1.0.0"
+  end
+end

data/lib/qpay/rails.rb

@@ -0,0 +1,25 @@
+require "qpay"
+require "qpay/rails/version"
+require "qpay/rails/configuration"
+require "qpay/rails/client"
+require "qpay/rails/engine"
+
+module QPay
+  module Rails
+    class << self
+      attr_writer :configuration
+
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      def configure
+        yield(configuration)
+      end
+
+      def client
+        Client.instance
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: qpay-rails
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- QPay SDK
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-02-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: qpay
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+description: Rails engine for QPay V2 payment API with view helpers and webhook support
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- app/controllers/qpay/webhooks_controller.rb
+- app/helpers/qpay_helper.rb
+- config/routes.rb
+- lib/generators/qpay/install_generator.rb
+- lib/generators/qpay/templates/initializer.rb
+- lib/qpay/rails.rb
+- lib/qpay/rails/client.rb
+- lib/qpay/rails/configuration.rb
+- lib/qpay/rails/engine.rb
+- lib/qpay/rails/version.rb
+homepage: https://github.com/qpay-sdk/qpay-rails
+licenses:
+- MIT
+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.4.19
+signing_key:
+specification_version: 4
+summary: QPay V2 payment integration for Rails
+test_files: []