parsbank 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99f934eb7c7f86c5672690ea579ec6e1e5839500ec0c75268a49a1878bc50973
-  data.tar.gz: be36aa6271f70befb1ab12486bfa996757032807bd3ca39a43df2cb47dc7efbe
+  metadata.gz: b9f5826abb8b78b831b9be8e8565e004863a75b7c64ff44beabd899a93bbafa4
+  data.tar.gz: 2c6ad504a2e26757a781c144844843f224da7ee57d80346d09dd74b4b08acac4
 SHA512:
-  metadata.gz: 10d5222300d787982406ac0d8f260609f3fc6aa14ab8f2dc7317be84755c70cf79e49aab330dfc569ab970636c42efec1e3cc60d5f57308274db123b07f1933d
-  data.tar.gz: 03d92ce711d799e2d8cb268c8fb9c176926cc69eadc6af4030c1730fe50ba0c42bbefb0dddcdac46a7ce39f7ab971c8284fddc8703e650467eb98883551dd7b3
+  metadata.gz: 6814ce0975c37dc51992680307ed6dc411ce7e075d12ae1c60b15a649e0a4e303f3cb18a9a47eb5f49d04ccc6d52fccb8caaf441ca2288d67f431d6691c966a9
+  data.tar.gz: c0d2a6b4aeef2f6f325e18d322016b7643a1f4c89f7c05a37a9f915625823b25c2552f681f1c9a37fe77febfc6b795a0f0811486de99b6f3ff18beea001f55f5

data/README.md

@@ -1,111 +1,195 @@
 # ParsBank
 ==============
 
-[![Gem Version](https://badge.fury.io/rb/parsbank.svg)](https://rubygems.org/gems/parsbank)
-![Build](https://github.com/abrfanet/ParsBank/workflows/CI/badge.svg)
+[![Gem Version](https://badge.fury.io/rb/parsbank.svg)](https://rubygems.org/gems/parsbank)  
+![Build Status](https://github.com/abrfanet/ParsBank/workflows/CI/badge.svg)
 
+**ParsBank Gateway** is a Ruby gem designed to integrate with WSDL and JSON APIs of all payments methods such as cryptocurrency platforms (e.g., Bitcoin, USDT), and traditional payment platforms like Stripe and PayPal or private banks such as Troy bank or persians banks. This gem leverages **SOAP** and **Faraday** libraries, optimized for multiple retries during connection failures or timeouts. Additionally, it includes a proxy wrapper for connecting to core banks via MITM (man-in-the-middle) servers.
 
-ParsBank Gateway
-
-An Ruby Gem Library for integrate with WSDL and JSON of Persian Banks, In this Gem we use soap and faraday lib as main dependency also we tunned soap/faraday for multile retries when failed connections or request, in the end we work on proxy wrapper for connct to core bank with MITM server 
+---
 
 ## Installation
 
-Install the gem and add to the application's Gemfile by executing:
+### Using Bundler
+Add ParsBank to your application's Gemfile and install it with:
 
-    $ bundle add ParsBank
+```bash
+$ bundle add ParsBank
+```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+### Without Bundler
+Install the gem directly:
 
-    $ gem install ParsBank
+```bash
+$ gem install ParsBank
+```
 
-In sinatra application just add `gem "ParsBank"` on your Gemfile and install with `bundle install`
+### For Sinatra Applications
+Include the gem in your Gemfile:
 
-## Usage
+```ruby
+gem "ParsBank"
+```
 
-First step:
+Then install it with:
 
-in config/initilizers create new config file:
+```bash
+$ bundle install
 ```
-#config/initilizers/pars_bank.rb
 
+---
+
+## Usage
 
+### Step 1: Configure ParsBank
+Create a configuration file in `config/initializers` (e.g., `config/initializers/pars_bank.rb`):
+
+```ruby
 ParsBank.configuration do |config|
+  config.callback_url = 'https://example.com/CallBack' # Your callback URL
+  config.debug = false                                 # Enable logging (Rails logs and STDOUT)
+  config.sandbox = false                               # Simulate requests and auto-approve callbacks
+  config.webhook = 'https://yoursite.com/income-webhook?title=TITLE&message=MESSAGE' # Transaction notification webhook
+  config.webhook_method = 'GET'                        # Webhook HTTP method (GET or POST)
+  config.mitm_server = 'https://your-mitm-server.com'  # MITM server location
+  config.secrets_path = Rails.root.join('config/bank_secrets.yaml') # Path to bank credentials (e.g., merchant ID, tokens)
+
+  # Web Panel Configuration
+  config.webpanel_path = '/parsbank'                   # Web panel path
+  config.username = ENV['PARSBANK_USERNAME']           # Web panel username
+  config.password = ENV['PARSBANK_PASSWORD']           # Web panel password
+  config.allowed_ips = ['192.168.10.10']               # Restrict access by IP (use '*' to allow all)
+  config.allow_when = ->(username, password) {         # Authentication using a Rails model
+    user = User.find_by(username: username)
+    user&.authenticate(password) && user.admin?
+  }
+  config.captcha = false                               # Enable CAPTCHA for security
+  config.model = Transaction                          # Define transaction model (must include fields like amount, status, etc.)
+end
+```
 
-    config.callback_url = 'YOUR CALLBACK LOCATION LIKE https://example.com/CallBack'
+---
+
+### Step 2: Use ParsBank in Your Controller
+
+Use the `get_redirect_from` method to generate a redirect form for users:
+
+```ruby
+class CartController < ApplicationController
+  # @INPUT fiat_amount: can be dollars or rials
+  # @INPUT crypto_amount: can be crypto assets amount like 0.0005
+  # @INPUT real_amount: When use crypto or Rials can use dollar instead amount of crypto (E.G 100 dollar equal 0.005 bitcoin)
+  # @INPUT description(required): Explain transaction details
+  # @INPUT bank: Select specific bank or payment method like 'bsc-binance', 'nobitex', 'zarinpal', 'perfect-money'
+  # @INPUT tags: Used for call which payments method such as ['crypto','rls','dollar','persian-banks','russian-banks']
+  # @OUTPUT get_redirect_from: an javascript code for redirect user to gateways
+  def redirect_to_parsbank
+    form = ParsBank.get_redirect_from(fiat_amount: '10', description: 'Charge Account')
+    render html: form
+  end
+
+  # @DESC: Shortcode for get all of enabled paymetns methods
+  # @INPUT tags(Optional): ['crypto','rls','dollar','persian-banks','russian-banks']
+  # @OUTPUT gateways_list_shortcode: List of all banks with name and logo with ul wrapper as html
+  def choose_payment
+    @payments_list_available_shortcode = ParsBank.gateways_list_shortcode
+  end
+
+  # @DESC: Parse all returned params from banks for verify transaction
+  # @OUTPUT verify_transaction: Return transaction status as json like {status: 200, message: 'Payment Successfull'}
+  def callback
+    @parsbank_verifier= ParsBank.verify_transaction
+    if @parsbank_verifier[:status] == 200
+      flash[:success]= @parsbank_verifier[:message]
+      redirect_to Something_path
+    else
+      flash[:error]= @parsbank_verifier[:message]
+      redirect_to Something_path
+    end
+  end
 
-    config.debug = false # Enable Log Tracking with Rails.log and STDOUT
 
-    config.sandbox = false # Enable Simulation for your requst also approve callback without verification
+end
+```
 
-    config.webhook = "https://yoursite.com/income-webhook?title=TITLE&message=MESSAGE" # Webhook for notify any success transactions or errors on cominiucate with Core Bank
-    config.webhook_method = 'GET' # or POST 
+---
 
-    config.mitm_server = 'YOUR_MITM_SERVER_LOCATION as HTTP or HTTPS'
+## ParsBank Amazing Web
 
-    config.secrets_path = Rails.root.join('config/bank_secrets.yaml') #PATH OF YOUR BANKS CREDITS like merchant id, username, password or token
+ParsBank comes with a built-in **web dashboard** for managing transactions and configurations visually. The dashboard includes:
+- A beautiful interface with **Canva graphs** for transaction analysis.
+- Tools for campaign improvements and data-driven decisions.
 
-    config.min_amount = '10000' # as rials
+### Security Notice
+Ensure that you apply CIS and other hardening rules to secure your bank credentials and virtual accounts (e.g., Binance) when using ParsBank Web.
 
-    # WebPanel Config
-    config.webpanel_path = '/parsbank'
-    ## Basic Authentication
-    config.username = ENV['PARSBANK_USERNAME']
-    config.password = ENV['PARSBANK_PASSWORD']
-    ## Authetication With IP source
-    config.allowed_ips = ['192.168.10.10'] # add * to allow all ip
-    ## Authentication with rails model
-    config.allow_when = User.find_by(username: USERNAME).authenticate(PASSWORD) && User.find_by(username: USERNAME).admin?
+---
 
-    # Secure by captcha
-    config.captcha = false
+### Setup for ParsBank Web
 
-    # Model for store transactions
-    # Transaction model should have amount, status, bank_name, callback_url, authority_code or anything you need
-    config.model = Transaction 
-    
+#### Method 1: Isolated Docker Container
+**Requirements**:
+- Docker
+- Nginx or Apache (for reverse proxy)
+- Resources: Adequate CPU, RAM, and modern storage for concurrent operations.
 
-end
+**Steps**:
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/Abrfanet/parsbank-web
+   ```
+2. Follow the repository's setup instructions.
 
-```
+#### Method 2: Inside a Rails Application
+Include the web dashboard gem in your Rails app (refer to ParsBank Web documentation).
 
+---
 
-Inside of your controller call Token action and get url for redirect user to Gateway page
+## 👨🏻‍💻 Development
 
-```
-class ApplicationController > Cart 
-    def redirect_to_ParsBank
-        form = ParsBank.get_redirect_from(amount: 100000, description: 'Charge Account')
-        render html: form
-    end
-end
-```
+We currently do not accept pull requests. Please report any issues in the [GitHub Issues section](https://github.com/abrfanet/ParsBank/issues). Also If you live in countries with specific payment systems, such as Russia (MIR Card), Germany, Turkey (Troy Card), or others, we warmly welcome you to join us as a developer or contributor. Your expertise and perspective can help us better support diverse payment ecosystems(We support you with PAGs users & CPC ⭐).
 
+---
 
+## 💖 Support This Project
+
+If you find this project helpful and would like to support its development, consider making a donation. Your contributions help maintain and improve this project. Thank you for your generosity! 🙏
+
+### Donate USDT (Tether)
+- **USDT (ERC-20):** `0x2028f409a42413076665231e209896bbe0221d64`
+- **USDT (TRC-20):** `TNtLkdy2FAKKBGJ4F8ij2mppWpjkB8GULy`
+- **USDT (BEP-20):** `0x2028f409a42413076665231e209896bbe0221d64`
+
+
+### Donate BTC (Bitcoin)
+- **BSC (BEP-20):** `0x2028f409a42413076665231e209896bbe0221d64`
 
-# ParsBank Amazing Web
-With ParsBank Web You Can Access To Your Transactions and Config Files Visualy! Also You Get Beautifull Dashboard with Canva Graph For Analysis Your Transaction And Improve Your Campiagn And Important Decisions ⭐
 
-```
-Important Note: When Use ParsBank Web you should apply CIS rules and all harening rules for secure your credentials of banks and virtuals account like binance.
-```
 
-Get Ready For ParsBank Web Gem:
+## 🚀 Premium Features
 
-## Method 1 (Isolated Dockerfile)
-Requrements:
-    - Docker
-    - Nginx or Apache Reverse Proxy for forward trafik to specific port
-    - ParsBank Web use sinatra with Concurency so needs considerable resource like RAM, CPU or next-gen of Hard Drive
-in first step clone git repository `git clone https://github.com/Abrfanet/parsbank-web`
+This project offers **premium features** to enhance your experience and support ongoing development. By contributing, you'll gain access to advanced capabilities while helping sustain and improve this project. 🙌
 
+#### 🔐 How to Access Premium Features
+1. **Make a Contribution**: 
+   - Pay 29 USDT to one of the wallet addresses below(Annualy).
+2. **Send Proof of Payment**: 
+   - Email your transaction details to `info@abrfa.net` or submit them via a dedicated contact form.
+3. **Receive Access**: 
+   - Upon verification, you'll receive instructions to access the premium features.
 
-## Method 2 (Inside of Rails App)
+#### 💳 USDT Wallet Addresses
+- **USDT (ERC-20):** `0x2028f409a42413076665231e209896bbe0221d64`
+- **USDT (TRC-20):** `TNtLkdy2FAKKBGJ4F8ij2mppWpjkB8GULy`
 
-## Development
+#### 🔥 Available Premium Features
+- Feature 1: **Advanced Analytics**  
+- Feature 2: **Customizable Reports**  
+- Feature 3: **Priority Support**
+- Feature 4: **ParsBank Web Access**
 
-We don't accept any pull request, just use issue section
+> **Note**: Contributions are used to maintain and improve this project. Thank you for your support! 🙏
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/ParsBank.
+Bug reports and feature requests are welcome at [ParsBank GitHub repository](https://github.com/abrfanet/ParsBank).

data/lib/configuration.rb

@@ -12,7 +12,8 @@ class Configuration
                   :allowed_ips,
                   :allow_when,
                   :captcha,
-                  :model
+                  :model,
+                  :database_url
 
     def initialize
       @callback_url = nil
@@ -30,5 +31,6 @@ class Configuration
       @allow_when = -> { true }
       @captcha = false
       @model = nil
+      @database_url = nil
     end
   end

data/lib/parsbank/restfull.rb

@@ -1,7 +1,14 @@
+require 'net/http'
+require 'uri'
+require 'json'
+
 module Parsbank
   class Restfull
     attr_accessor :connection
 
+    MAX_RETRIES = 3
+    RETRY_INTERVAL = 1 # In seconds
+
     def initialize(args = {})
       @endpoint = args.fetch(:endpoint)
       @action = args.fetch(:action)
@@ -15,17 +22,14 @@ module Parsbank
 
     def call
       response = send_request
+      log_response(response)
 
-      Rails.logger.info("Received response with status: #{response.status}, body: #{response.body.inspect}")
-
-      if response.success?
-        response
+      if response.is_a?(Net::HTTPSuccess)
+        parse_response(response)
       else
         log_and_raise_error(response)
       end
-    rescue Faraday::ConnectionFailed => e
-      handle_error("Connection failed: #{e.message}", e)
-    rescue Faraday::TimeoutError => e
+    rescue Timeout::Error => e
       handle_error("Request timed out: #{e.message}", e)
     rescue StandardError => e
       handle_error("An unexpected error occurred: #{e.message}", e)
@@ -33,103 +37,146 @@ module Parsbank
 
     private
 
-    def webhook(_message)
-     webhook_url = Parsbank.configuration.webhook
-
-     webhook_url.gsub!('MESSAGE', _message) if Parsbank.configuration.webhook_method == :get
-     webhook_url.gsub!('TITLE', "Webhook of Connection Error at #{Time.now}") if Parsbank.configuration.webhook_method == :get
-
-      connection = Faraday.new() do |conn|
-        conn.request :json if @response_type == :json # Automatically converts payload to JSON
-        conn.response :json if @response_type == :json # Automatically parses JSON response
-        conn.adapter Faraday.default_adapter
-        conn.request :retry, max: 3, interval: 0.05,
-                             interval_randomness: 0.5, backoff_factor: 2,
-                             exceptions: [Faraday::TimeoutError, Faraday::ConnectionFailed]
-        conn.use FaradayMiddleware::FollowRedirects
-      end
-
-      case Parsbank.configuration.webhook_method
-      when :post
-        connection.post('&parsbank') do |req|
-          req.headers = headers
-          req.body = {}
-        end
+    def setup_connection
+      @uri = URI.parse(@endpoint)
+      @connection = Net::HTTP.new(@uri.host, @uri.port)
+      @connection.use_ssl = true if @uri.scheme == 'https'
 
-      when :get
-        connection.get('&parsbank')
-      end
-    rescue Faraday::ConnectionFailed => e
-      Rails.logger.error("Webhook Connection failed: #{e.message}", e)
-    rescue Faraday::TimeoutError => e
-      Rails.logger.error("Webhook Request timed out: #{e.message}", e)
-    rescue StandardError => e
-      Rails.logger.error("Webhook An unexpected error occurred: #{e.message}", e)
+      # Setting timeouts
+      @connection.open_timeout = 10 # Time to wait for the connection to open
+      @connection.read_timeout = 10 # Time to wait for a response
     end
 
-    def setup_connection
-      @connection = Faraday.new(@endpoint) do |conn|
-        conn.request :json if @response_type == :json # Automatically converts payload to JSON
-        conn.response :json if @response_type == :json # Automatically parses JSON response
-        conn.adapter Faraday.default_adapter
-        conn.request :retry, max: 3, interval: 0.05,
-                             interval_randomness: 0.5, backoff_factor: 2,
-                             exceptions: [Faraday::TimeoutError, Faraday::ConnectionFailed]
-        conn.use FaradayMiddleware::FollowRedirects
+    def send_request
+      retries = 0
+      begin
+        request = build_request
+        @connection.start do
+          response = @connection.request(request)
+
+          # Handling redirects manually (max 5 redirects)
+          handle_redirects(response)
+          
+          return response
+        end
+      rescue Timeout::Error => e
+        retries += 1
+        if retries < MAX_RETRIES
+          log_to_rails("Timeout occurred. Retrying... (#{retries}/#{MAX_RETRIES})", :warn)
+          sleep(RETRY_INTERVAL)
+          retry
+        else
+          raise "Request timed out after #{MAX_RETRIES} retries: #{e.message}"
+        end
+      rescue StandardError => e
+        log_to_rails("Request failed: #{e.message}", :error)
+        raise e
       end
     end
 
-    def send_request
-      headers = default_headers.merge(@headers)
-
+    def build_request
       case @http_method
       when :post
-        perform_post(headers)
+        build_post_request
       when :get
-        perform_get(headers)
+        build_get_request
       when :options
-        perform_options(headers)
+        build_options_request
       else
         raise ArgumentError, "HTTP Method Not Allowed: #{@http_method}"
       end
     end
 
-    def perform_post(headers)
-      @connection.post(@action) do |req|
-        req.headers = headers
-        req.body = @request_message
-      end
+    def build_post_request
+      request = Net::HTTP::Post.new(@action, default_headers)
+      request.body = @request_message.to_json if @request_message.any?
+      request
     end
 
-    def perform_get(headers)
-      @connection.get(@action) do |req|
-        req.headers = headers
-        req.params = @request_message
-      end
+    def build_get_request
+      request = Net::HTTP::Get.new(@action, default_headers)
+      request.set_form_data(@request_message) if @request_message.any?
+      request
     end
 
-    def perform_options(headers)
-      @connection.options(@action) do |req|
-        req.headers = headers
-      end
+    def build_options_request
+      Net::HTTP::Options.new(@action, default_headers)
     end
 
     def default_headers
       {
         'Content-Type' => 'application/json',
         'Parsbank-RubyGem' => Parsbank::VERSION
-      }
+      }.merge(@headers)
+    end
+
+    def log_response(response)
+      log_to_rails("Received response with status: #{response.code}, body: #{response.body.inspect}", :info)
+    end
+
+    def parse_response(response)
+      return response.body if @response_type == :raw
+
+      case @response_type
+      when :json
+        JSON.parse(response.body)
+      else
+        response.body
+      end
     end
 
     def log_and_raise_error(response)
-      Rails.logger.error("Request to #{@endpoint}/#{@action} failed with status: #{response.status}, error: #{response.body.inspect}")
-      raise "API request failed with status #{response.status}: #{response.body}"
+      log_to_rails("Request to #{@endpoint}/#{@action} failed with status: #{response.code}, error: #{response.body.inspect}", :error)
+      raise "API request failed with status #{response.code}: #{response.body}"
     end
 
     def handle_error(message, exception)
-      Rails.logger.error(message)
+      log_to_rails(message, :error)
       webhook(message) if Parsbank.configuration.webhook.present?
       raise exception
     end
+
+    def log_to_rails(message, level = :info)
+      case level
+      when :error
+        Rails.logger.error(message) if defined?(Rails)
+      when :warn
+        Rails.logger.warn(message) if defined?(Rails)
+      else
+        Rails.logger.info(message) if defined?(Rails)
+      end
+    end
+
+    def webhook(message)
+      webhook_url = Parsbank.configuration.webhook
+      webhook_url.gsub!('MESSAGE', message) if Parsbank.configuration.webhook_method == :get
+      webhook_url.gsub!('TITLE', "Webhook of Connection Error at #{Time.now}") if Parsbank.configuration.webhook_method == :get
+
+      uri = URI.parse(webhook_url)
+      connection = Net::HTTP.new(uri.host, uri.port)
+      connection.use_ssl = uri.scheme == 'https'
+
+      case Parsbank.configuration.webhook_method
+      when :post
+        request = Net::HTTP::Post.new(uri.path, default_headers)
+        request.body = {}.to_json
+        connection.request(request)
+      when :get
+        request = Net::HTTP::Get.new(uri.path, default_headers)
+        connection.request(request)
+      end
+    rescue StandardError => e
+      log_to_rails("Webhook Error: #{e.message}", :error)
+    end
+
+    def handle_redirects(response)
+      if response.is_a?(Net::HTTPRedirection)
+        location = response['Location']
+        log_to_rails("Redirecting to: #{location}", :warn)
+        redirect_uri = URI.parse(location)
+        request = Net::HTTP::Get.new(redirect_uri)
+        @connection.request(request)
+      end
+    end
   end
 end

data/lib/parsbank/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Parsbank
-  VERSION = '0.0.4'
+  VERSION = '0.0.5'
 end

data/lib/parsbank.rb

@@ -2,6 +2,8 @@
 
 require 'yaml'
 require 'savon'
+require 'uri'
+require 'active_support'
 require 'parsbank/version'
 require 'parsbank/restfull'
 require 'parsbank/bsc-bitcoin/bsc-bitcoin'
@@ -14,88 +16,8 @@ require 'configuration'
 module Parsbank
   class Error < StandardError; end
 
-  $SUPPORTED_PSP = [
-    'asanpardakht': {
-      'name': 'Asan Pardakht CO.',
-      'website': 'http://asanpardakht.ir',
-      'tags': %w[iranian-psp ir rial]
-    },
-    'damavand': {
-      'name': 'Electronic Card Damavand CO.',
-      'website': 'http://ecd-co.ir',
-      'tags': %w[iranian-psp ir rial]
-    },
-    'mellat': {
-      'name': 'Behpardakht Mellat CO.',
-      'website': 'http://behpardakht.com',
-      'tags': %w[iranian-psp ir rial]
-    },
-    'pep': {
-      'name': 'Pasargad CO.',
-      'website': 'http://pep.co.ir',
-      'tags': %w[iranian-psp ir rial]
-    },
-
-    'sep': {
-      'name': 'Saman Bank CO.',
-      'website': 'http://sep.ir',
-      'tags': %w[iranian-psp ir rial]
-    },
-    'pna': {
-      'name': 'Pardakht Novin Arian CO.',
-      'website': 'http://pna.co.ir',
-      'tags': %w[iranian-psp ir rial]
-    },
-    'pec': {
-      'name': 'Parsian Bank CO.',
-      'website': 'http://pec.ir',
-      'tags': %w[iranian-psp ir rial]
-    },
-
-    'sadad': {
-      'name': 'Sadad Bank CO.',
-      'website': 'http://sadadco.‌com',
-      'tags': %w[iranian-psp ir rial]
-    },
-    'sayan': {
-      'name': 'Sayan Card CO.',
-      'website': 'http://sayancard.ir',
-      'tags': %w[iranian-psp ir rial]
-    },
-
-    'fanava': {
-      'name': 'Fan Ava Card CO.',
-      'website': 'http://fanavacard.com',
-      'tags': %w[iranian-psp ir rial]
-    },
-    'kiccc': {
-      'name': 'IranKish CO.',
-      'website': 'http://kiccc.com',
-      'tags': %w[iranian-psp ir rial]
-    },
-
-    'sepehr': {
-      'name': 'Sepehr Bank CO.',
-      'website': 'http://www.sepehrpay.com',
-      'tags': %w[iranian-psp ir rial]
-    },
-
-    'zarinpal': {
-      'name': 'Zarinpal',
-      'website': 'http://www.sepehrpay.com',
-      'tags': %w[iranian-psp ir rial]
-    },
-    'zibal': {
-      'name': 'Zibal',
-      'website': 'http://zibal.ir',
-      'tags': %w[iranian-psp ir rial]
-    },
-    'bscbitcoin': {
-      'name': 'Binance Bitcoin',
-      'website': 'https://bitcoin.org',
-      'tags': %w[btc bitcoin binance bsc crypto]
-    }
-  ]
+  $SUPPORTED_PSP = JSON.parse(File.read(File.join(__dir__, 'psp.json')))
+  
   class << self
     attr_accessor :configuration
   end
@@ -114,41 +36,146 @@ module Parsbank
   end
 
 
-  def self.redirect_to_gateway(args = {})
-    amount = args.fetch(:amount)
-    bank = args.fetch(:bank, 'random-irr-gates')
-    description = args.fetch(:description, '')
+  def self.initialize_in_rails
+    return unless defined?(Rails)
+
+    ActiveSupport.on_load(:after_initialize) do
+      Parsbank.initialize!
+    end
+  end
+
+  def self.initialize!
+    if Parsbank.configuration.database_url.present?
+      establish_connection
+    else
+      puts "\033[31mParsBank ERROR: database_url not set, Transaction history not stored on database\033[0m"
+    end
+  end
+
+  def self.establish_connection
+    database_url = Parsbank.configuration.database_url
+    model = Parsbank.configuration.model
+    raise "DATABASE_URL environment variable is not set" if database_url.nil?
+
+    supported_databases = {
+      'postgresql' => 'pg',
+      'mysql2' => 'mysql2',
+      'sqlite3' => 'sqlite3',
+      'nulldb' => 'nulldb'
+      }.freeze
+
+    uri = URI.parse(database_url)
+
+    gem_name = supported_databases[uri.scheme]
+    unless gem_name
+      raise "Unsupported database adapter: #{uri.scheme}. Supported adapters: #{supported_databases.keys.join(', ')}"
+    end
+
+    begin
+      require gem_name
+    rescue LoadError
+      raise "Missing required gem for #{uri.scheme}. Please add `gem '#{gem_name}'` to your Gemfile."
+    end
+
+    begin
+      ActiveRecord::Base.establish_connection(database_url)
+      unless ActiveRecord::Base.connection.table_exists?(model.tableize)
+        puts 'Create Transaction Table'
+        ActiveRecord::Base.connection.create_table model.tableize do |t|
+          t.string :gateway
+          t.string :amount
+          t.string :unit
+          t.string :track_id
+          t.string :local_id
+          t.string :ip
+          t.integer :user_id
+          t.integer :cart_id
+          t.text :description
+          t.string :callback_url
+          t.text :gateway_verify_response
+          t.text :gateway_response
+          t.string :status
+          t.timestamps
+        end
+      end
+
+      unless Object.const_defined?(model)
+        Object.const_set(model, Class.new(ActiveRecord::Base) do
+          self.table_name = model.tableize
+        end)
+      end
+
+    rescue => e
+      raise "Failed to connect to the database: #{e.message}"
+    end
 
+  end
+
+  def self.redirect_to_gateway(args = {})
+    bank = args.fetch(:bank, available_gateways_list.keys.sample)
     selected_bank = available_gateways_list.select { |k| k == bank }
-    raise "Bank not enabled or not exists on bank_secrets.yml: #{bank}" unless selected_bank.present?
+    unless selected_bank.present?
+      raise "Bank not enabled or not exists in #{Parsbank.configuration.secrets_path}: #{bank}"
+    end
+
+    description = args.fetch(:description)
+    default_callback = "#{selected_bank[bank.to_s]['callback_url'] || Parsbank.configuration.callback_url}&bank_name=#{bank}"
 
-    default_callback = Parsbank.configuration.callback_url + "&bank_name=#{bank}"
+    crypto_amount = args.fetch(:crypto_amount, nil)
+    fiat_amount = args.fetch(:fiat_amount, nil)
+    real_amount = args.fetch(:real_amount, nil)
+
+    if crypto_amount.nil? && fiat_amount.nil? && real_amount.nil?
+      raise 'Amount fileds is emptey: crypto_amount OR fiat_amount OR real_amount'
+    end
+
+    if $SUPPORTED_PSP[bank]['tags'].include?('crypto') && crypto_amount.nil? && real_amount.nil?
+      raise "#{bank} needs crypto_amount or real_amount"
+    end
+
+    if $SUPPORTED_PSP[bank]['tags'].include?('rial') && fiat_amount.nil? && real_amount.nil?
+      raise "#{bank} needs fiat_amount or real_amount"
+    end
+
+    transaction = Object.const_get(Parsbank.configuration.model).create(
+      description: description,
+      amount: fiat_amount || crypto_amount,
+      gateway: bank,
+      callback_url: default_callback,
+      status: 'start',
+      user_id: args.fetch(:user_id, nil),
+      cart_id: args.fetch(:cart_id, nil),
+      local_id: args.fetch(:local_id, nil),
+      ip: args.fetch(:ip, nil)
+      ) if Parsbank.configuration.database_url.present?
 
     case bank
     when 'mellat'
       mellat_klass = Parsbank::Mellat.new(
-        amount: amount,
+        amount: fiat_amount,
         additional_data: description,
-        callback_url: selected_bank['mellat']['callback_url'] || default_callback,
-        orderId: rand(1...9999)
+        callback_url: default_callback,
+        orderId: transaction.id
       )
       mellat_klass.call
+      transaction.update!(gateway_response: mellat_klass.response, unit: 'irr')
       result = mellat_klass.redirect_form
 
     when 'zarinpal'
       zarinpal_klass = Parsbank::Zarinpal.new(
-        amount: amount,
+        amount: fiat_amount,
         additional_data: description,
-        callback_url: selected_bank['zarinpal']['callback_url'] || default_callback
+        callback_url: default_callback
       )
       zarinpal_klass.call
+      transaction.update!(gateway_response: zarinpal_klass.response,track_id: zarinpal_klass.ref_id, unit: 'irt') if transaction.present?
       result = zarinpal_klass.redirect_form
 
     when 'zibal'
       Parsbank::Zibal.new(
-        amount: amount,
+        amount: fiat_amount,
         additional_data: description,
-        callback_url: selected_bank['zibal']['callback_url'] || default_callback
+        callback_url: default_callback
       )
       zarinpal_klass.call
       result = zarinpal_klass.redirect_form
@@ -156,7 +183,10 @@ module Parsbank
       bscbitcoin_klass = Parsbank::BscBitcoin.new(
         additional_data: description
       )
+      convert_real_amount_to_assets if crypto_amount.nil? && args.key?(:real_amount)
       result = bscbitcoin_klass.generate_payment_address(amount: amount)
+      transaction.update!(gateway_response: result, unit: 'bitcoin') if transaction.present?
+
     end
 
     result
@@ -170,10 +200,10 @@ module Parsbank
       raise "Error: Invalid format in #{Parsbank.configuration.secrets_path}. Expected a hash of bank secrets."
     end
 
-    supported_banks = $SUPPORTED_PSP[0].keys
+    supported_banks = $SUPPORTED_PSP.keys
 
     secrets.each_key do |bank_key|
-      unless supported_banks.include?(bank_key.to_sym)
+      unless supported_banks.include?(bank_key.to_s)
         raise "#{bank_key.capitalize} in #{Parsbank.configuration.secrets_path} is not supported by ParsBank. \nSupported Banks: #{supported_banks.join(', ')}"
       end
     end
@@ -185,23 +215,32 @@ module Parsbank
     raise "Error: YAML syntax issue in #{Parsbank.configuration.secrets_path}: #{e.message}"
   end
 
-
   def self.gateways_list_shortcode
     banks_list = available_gateways_list.keys.map { |bank| render_bank_list_item(bank) }.join
     "<ul class='parsbank_selector'>#{banks_list}</ul>"
   end
 
-  private 
   def self.render_bank_list_item(bank)
-    bank_klass=Object.const_get("Parsbank::#{bank.capitalize}")
-    status, headers, body = bank_klass.logo rescue nil
+    bank_klass = Object.const_get("Parsbank::#{bank.capitalize}")
+    _, _, body = begin
+      bank_klass.logo
+    rescue StandardError
+      nil
+    end
     <<~HTML
       <li class='parsbank_radio_wrapper #{bank}_wrapper'>
-        
+      #{'  '}
         <input type='radio' id='#{bank}' name='bank' value='#{bank}' />
-        <label for='#{bank}'>#{File.read(body) rescue ''} #{bank.upcase}</label>
+        <label for='#{bank}'>#{begin
+          File.read(body)
+        rescue StandardError
+          ''
+        end} #{bank.upcase}</label>
       </li>
     HTML
   end
-
 end
+
+
+
+Parsbank.initialize_in_rails

data/lib/psp.json

@@ -0,0 +1,78 @@
+{
+    "asanpardakht": {
+      "name": "Asan Pardakht CO.",
+      "website": "http://asanpardakht.ir",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "damavand": {
+      "name": "Electronic Card Damavand CO.",
+      "website": "http://ecd-co.ir",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "mellat": {
+      "name": "Behpardakht Mellat CO.",
+      "website": "http://behpardakht.com",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "pep": {
+      "name": "Pasargad CO.",
+      "website": "http://pep.co.ir",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "sep": {
+      "name": "Saman Bank CO.",
+      "website": "http://sep.ir",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "pna": {
+      "name": "Pardakht Novin Arian CO.",
+      "website": "http://pna.co.ir",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "pec": {
+      "name": "Parsian Bank CO.",
+      "website": "http://pec.ir",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "sadad": {
+      "name": "Sadad Bank CO.",
+      "website": "http://sadadco.‌com",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "sayan": {
+      "name": "Sayan Card CO.",
+      "website": "http://sayancard.ir",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "fanava": {
+      "name": "Fan Ava Card CO.",
+      "website": "http://fanavacard.com",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "kiccc": {
+      "name": "IranKish CO.",
+      "website": "http://kiccc.com",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "sepehr": {
+      "name": "Sepehr Bank CO.",
+      "website": "http://www.sepehrpay.com",
+      "tags": ["iranian-psp", "ir", "rial"]
+    },
+    "zarinpal": {
+      "name": "Zarinpal",
+      "website": "http://www.sepehrpay.com",
+      "tags": ["iranian-psp", "irt", "rial"]
+    },
+    "zibal": {
+      "name": "Zibal",
+      "website": "http://zibal.ir",
+      "tags": ["iranian-psp", "irt", "rial"]
+    },
+    "bscbitcoin": {
+      "name": "Binance Bitcoin",
+      "website": "https://bitcoin.org",
+      "tags": ["btc", "bitcoin", "binance", "bsc", "crypto"]
+    }
+  }
+  

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parsbank
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Mohammad Mahmoodi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-01-08 00:00:00.000000000 Z
+date: 2025-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -24,34 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: faraday
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: faraday_middleware
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: savon
   requirement: !ruby/object:Gem::Requirement
@@ -66,7 +38,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Focus on your ecommerce we handle your payments.
+description: Focus on your ecommerce we handle your gateways.
 email:
 - mm580486@gmail.com
 executables: []
@@ -88,6 +60,7 @@ files:
 - lib/parsbank/zarinpal/zarinpal.rb
 - lib/parsbank/zibal/logo.svg
 - lib/parsbank/zibal/zibal.rb
+- lib/psp.json
 - sig/parsbank.rbs
 homepage: https://github.com/Abrfanet
 licenses: