dk_payment_gateway 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1adb745b88e5764958d079bc263f64a4053f2ceb29be5e4b8ebc46263665144d
-  data.tar.gz: b8f28758e6253f0a6d62088297361b9dbfd873fa2d3a8c91a26099947587b5a7
+  metadata.gz: 870dfb0045a54e93075e048fdfc328e54e4386bba4c159feae71df0f0deea86a
+  data.tar.gz: d9d0b197757af3f2e6317b2ad888c0dad06870d093b1a07fe624c742970855f4
 SHA512:
-  metadata.gz: 3eec783de887096d8b1390667c8e28a39832285bb408a806f1e911e38400c06d58e5b8cc2037fc55f5208bd42a886494876f9ea953ce57d5bf7fd185c394b351
-  data.tar.gz: 5347fc6912607f342e00a4b4c3d9b922cb50ad1e76ddbad6d9de5fc247a06f02784875fe3a654cf1d6b0d6e313907b54cfaca2968e5919c5626cbd80fd615036
+  metadata.gz: 2a72ab18fa11e482260d218100febc0f3a91c9e6b28e802e957ccd1b2c1fea7d089e779c2182f0ef233a5adde60cef200d118b29c4f24863dea5a2e12a8d5ce0
+  data.tar.gz: d4770b2f045bfc9947b713940f104dd2c0b6011c1f052ca5156af868d55250c8d24d07229464860bd03b2b7ddb9f47a02a733d08094f8f74d09cab53eb891c15

data/DEVELOPMENT.md

@@ -90,7 +90,7 @@ bundle exec rubocop -a
 Create a `.env.test` file:
 
 ```bash
-DK_BASE_URL=http://internal-gateway.uat.digitalkidu.bt/api/dkpg
+DK_BASE_URL=https://internal-gateway.uat.digitalkidu.bt/api/dkpg
 DK_API_KEY=your_test_api_key
 DK_USERNAME=your_test_username
 DK_PASSWORD=your_test_password
@@ -206,7 +206,7 @@ def sign_request(request_body, timestamp, nonce)
   puts "Request Body: #{request_body.inspect}"
   puts "Timestamp: #{timestamp}"
   puts "Nonce: #{nonce}"
-  
+
   # ... rest of method
 end
 ```
@@ -252,11 +252,13 @@ gem push dk_payment_gateway-0.1.0.gem
 ### Issue: Authentication Fails
 
 **Check:**
+
 - Credentials are correct
 - API key is valid
 - Network connectivity to API endpoint
 
 **Debug:**
+
 ```ruby
 begin
   client.authenticate!
@@ -269,11 +271,13 @@ end
 ### Issue: Signature Validation Fails
 
 **Check:**
+
 - Private key is correctly fetched
 - Request body is properly serialized
 - Timestamp is in correct format
 
 **Debug:**
+
 ```ruby
 # Enable signature debugging
 signature = DkPaymentGateway::Signature.new(private_key)
@@ -338,7 +342,7 @@ RSpec.describe "Payment" do
     stub_request(:post, /.*\/v1\/account_auth\/pull-payment/)
       .to_return(status: 200, body: mock_response.to_json)
   end
-  
+
   it "processes payment" do
     # Test implementation
   end
@@ -374,7 +378,7 @@ Use environment variables for sensitive data:
 ## Support
 
 For development questions or issues:
+
 - Check existing issues on GitHub
 - Review documentation
 - Contact the development team
-

data/EXAMPLES.md

@@ -19,7 +19,7 @@ This document provides comprehensive examples for all API operations supported b
 require 'dk_payment_gateway'
 
 DkPaymentGateway.configure do |config|
-  config.base_url = "http://internal-gateway.uat.digitalkidu.bt/api/dkpg"
+  config.base_url = "https://internal-gateway.uat.digitalkidu.bt/api/dkpg"
   config.api_key = "98cf3639-df33-4587-9d36-dae9d2bb974c"
   config.username = "your_username"
   config.password = "your_password"
@@ -46,7 +46,7 @@ client.authenticate!
 # export DK_CLIENT_SECRET="your_client_secret"
 
 DkPaymentGateway.configure do |config|
-  config.base_url = ENV['DK_BASE_URL'] || "http://internal-gateway.uat.digitalkidu.bt/api/dkpg"
+  config.base_url = ENV['DK_BASE_URL'] || "https://internal-gateway.uat.digitalkidu.bt/api/dkpg"
   config.api_key = ENV['DK_API_KEY']
   config.username = ENV['DK_USERNAME']
   config.password = ENV['DK_PASSWORD']
@@ -82,18 +82,18 @@ begin
     remitter_account_name: "Customer Name",
     remitter_bank_id: "1040"
   )
-  
+
   puts "Authorization successful!"
   puts "Transaction ID: #{auth_response['bfs_txn_id']}"
   puts "STAN: #{auth_response['stan_number']}"
-  
+
   # Store the transaction ID for the debit request
   bfs_txn_id = auth_response['bfs_txn_id']
-  
+
   # Step 3: Customer receives OTP and provides it
   # In a real application, you would collect this from the user
   otp = "123456" # Customer's OTP
-  
+
   # Step 4: Complete the payment with OTP
   debit_response = client.pull_payment.debit(
     request_id: "REQ_#{Time.now.to_i}_#{SecureRandom.hex(4)}",
@@ -101,7 +101,7 @@ begin
     bfs_remitter_otp: otp,
     bfs_order_no: "ORD123456"
   )
-  
+
   if debit_response['code'] == '00'
     puts "Payment completed successfully!"
     puts "Transaction ID: #{debit_response['bfs_txn_id']}"
@@ -109,7 +109,7 @@ begin
   else
     puts "Payment failed: #{debit_response['description']}"
   end
-  
+
 rescue DkPaymentGateway::TransactionError => e
   puts "Transaction error: #{e.message}"
   puts "Error code: #{e.response_code}"
@@ -148,14 +148,14 @@ begin
     source_account_name: "Rinzin Jamtsho",
     source_account_number: "100100365856"
   )
-  
+
   puts "Account inquiry successful!"
   puts "Inquiry ID: #{inquiry_response['inquiry_id']}"
   puts "Beneficiary Name: #{inquiry_response['account_name']}"
-  
+
   # Step 2: Proceed with fund transfer
   inquiry_id = inquiry_response['inquiry_id']
-  
+
   transfer_response = client.intra_transaction.fund_transfer(
     request_id: "TXN_#{Time.now.to_i}_#{SecureRandom.hex(4)}",
     inquiry_id: inquiry_id,
@@ -170,10 +170,10 @@ begin
     bene_bank_code: "1060",
     narration: "Salary payment for October 2025"
   )
-  
+
   puts "Transfer initiated successfully!"
   puts "Transaction Status ID: #{transfer_response['txn_status_id']}"
-  
+
 rescue DkPaymentGateway::TransactionError => e
   puts "Transfer failed: #{e.message}"
   puts "Error code: #{e.response_code}"
@@ -203,7 +203,7 @@ transfers.each do |transfer|
       bene_account_number: transfer[:account],
       source_account_number: "100100365856"
     )
-    
+
     # Step 2: Fund transfer
     result = client.intra_transaction.fund_transfer(
       request_id: "TXN_#{Time.now.to_i}_#{SecureRandom.hex(4)}",
@@ -218,15 +218,15 @@ transfers.each do |transfer|
       bene_bank_code: "1060",
       narration: transfer[:narration]
     )
-    
+
     results << { account: transfer[:account], status: "success", txn_id: result['txn_status_id'] }
     puts "✓ Transfer to #{transfer[:account]}: Success"
-    
+
   rescue DkPaymentGateway::Error => e
     results << { account: transfer[:account], status: "failed", error: e.message }
     puts "✗ Transfer to #{transfer[:account]}: Failed - #{e.message}"
   end
-  
+
   # Add delay between requests to avoid rate limiting
   sleep 1
 end
@@ -251,12 +251,12 @@ begin
     mcc_code: "5411", # Grocery store
     remarks: "Payment to Merchant Store"
   )
-  
+
   # Save QR code image
   filename = "static_qr_#{Time.now.to_i}.png"
   client.qr_payment.save_qr_image(qr_response['image'], filename)
   puts "Static QR code saved to #{filename}"
-  
+
 rescue DkPaymentGateway::Error => e
   puts "QR generation failed: #{e.message}"
 end
@@ -275,13 +275,13 @@ begin
     mcc_code: "5812", # Restaurant
     remarks: "Invoice #INV-2025-001"
   )
-  
+
   # Save QR code image
   filename = "invoice_qr_#{Time.now.to_i}.png"
   client.qr_payment.save_qr_image(qr_response['image'], filename)
   puts "Dynamic QR code saved to #{filename}"
   puts "Amount: BTN 250.50"
-  
+
 rescue DkPaymentGateway::Error => e
   puts "QR generation failed: #{e.message}"
 end
@@ -298,14 +298,14 @@ begin
     transaction_id: "test_txn_update23567",
     bene_account_number: "100100365856"
   )
-  
+
   puts "Transaction Status:"
   puts "Status: #{status['status']['status_desc']}"
   puts "Amount: BTN #{status['status']['amount']}"
   puts "Timestamp: #{status['status']['txn_ts']}"
   puts "Debit Account: #{status['status']['debit_account']}"
   puts "Credit Account: #{status['status']['credit_account']}"
-  
+
 rescue DkPaymentGateway::TransactionError => e
   puts "Status check failed: #{e.message}"
 end
@@ -321,7 +321,7 @@ begin
     transaction_date: "2025-09-18",
     bene_account_number: "100100365856"
   )
-  
+
   if status.is_a?(Array)
     status.each do |txn|
       puts "Transaction found:"
@@ -330,7 +330,7 @@ begin
       puts "  Date: #{txn['txn_ts']}"
     end
   end
-  
+
 rescue DkPaymentGateway::TransactionError => e
   puts "Status check failed: #{e.message}"
 end
@@ -346,11 +346,11 @@ class PaymentProcessor
     @client = DkPaymentGateway.client
     @client.authenticate!
   end
-  
+
   def process_order_payment(order)
     # Step 1: Initiate payment authorization
     stan = DkPaymentGateway::PullPayment.generate_stan("0201")
-    
+
     auth_response = @client.pull_payment.authorize(
       transaction_datetime: Time.now.utc.strftime("%Y-%m-%dT%H:%M:%SZ"),
       stan_number: stan,
@@ -365,14 +365,14 @@ class PaymentProcessor
       remitter_account_name: order[:customer_name],
       remitter_bank_id: order[:customer_bank_id]
     )
-    
+
     # Store transaction ID
     order[:bfs_txn_id] = auth_response['bfs_txn_id']
-    
+
     # Return transaction ID to customer for OTP entry
     auth_response
   end
-  
+
   def complete_payment(order, otp)
     debit_response = @client.pull_payment.debit(
       request_id: "ORD_#{order[:order_id]}_#{Time.now.to_i}",
@@ -380,7 +380,7 @@ class PaymentProcessor
       bfs_remitter_otp: otp,
       bfs_order_no: order[:order_id]
     )
-    
+
     if debit_response['code'] == '00'
       # Payment successful - update order status
       update_order_status(order[:order_id], 'paid')
@@ -392,26 +392,26 @@ class PaymentProcessor
       false
     end
   end
-  
+
   private
-  
+
   def calculate_fee(amount)
     # Example fee calculation
     [amount * 0.01, 5.0].max # 1% with minimum 5 BTN
   end
-  
+
   def merchant_account
     "110158212197"
   end
-  
+
   def merchant_name
     "My E-commerce Store"
   end
-  
+
   def update_order_status(order_id, status)
     # Update in database
   end
-  
+
   def send_confirmation_email(order)
     # Send email
   end
@@ -451,22 +451,22 @@ end
 def safe_payment_operation
   client = DkPaymentGateway.client
   client.authenticate!
-  
+
   # Your payment logic here
-  
+
 rescue DkPaymentGateway::ConfigurationError => e
   log_error("Configuration issue", e)
   notify_admin("Payment gateway configuration error: #{e.message}")
-  
+
 rescue DkPaymentGateway::AuthenticationError => e
   log_error("Authentication failed", e)
   # Retry authentication or notify admin
-  
+
 rescue DkPaymentGateway::InvalidParameterError => e
   log_error("Invalid parameters", e)
   # Return user-friendly error message
   { error: "Invalid payment details", details: e.response_detail }
-  
+
 rescue DkPaymentGateway::TransactionError => e
   log_error("Transaction failed", e)
   # Handle based on error code
@@ -478,14 +478,13 @@ rescue DkPaymentGateway::TransactionError => e
   else
     { error: "Transaction failed", code: e.response_code }
   end
-  
+
 rescue DkPaymentGateway::NetworkError => e
   log_error("Network error", e)
   # Retry logic or queue for later
-  
+
 rescue DkPaymentGateway::Error => e
   log_error("General payment gateway error", e)
   { error: "Payment processing error" }
 end
 ```
-

data/Gemfile

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in dk_payment_gateway.gemspec
 gemspec
 
-gem "rake", "~> 13.0"
-gem "rspec", "~> 3.0"
-gem "webmock", "~> 3.18"
-gem "vcr", "~> 6.1"
-gem "rubocop", "~> 1.21"
-
+gem 'dotenv', '>= 3.1.8'
+gem 'rake', '~> 13.0'
+gem 'rspec', '~> 3.0'
+gem 'rubocop', '~> 1.21'
+gem 'vcr', '~> 6.1'
+gem 'webmock', '~> 3.18'

data/Gemfile.lock

@@ -0,0 +1,100 @@
+PATH
+  remote: .
+  specs:
+    dk_payment_gateway (1.0.1)
+      faraday (~> 2.0)
+      jwt (~> 2.7)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (3.3.1)
+    crack (1.0.1)
+      bigdecimal
+      rexml
+    diff-lcs (1.6.2)
+    dotenv (3.1.8)
+    faraday (2.14.0)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.1)
+      net-http (>= 0.5.0)
+    hashdiff (1.2.1)
+    json (2.15.2)
+    jwt (2.10.2)
+      base64
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    net-http (0.7.0)
+      uri
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.6.0)
+    public_suffix (6.0.2)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.6)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    rubocop (1.81.7)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.47.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+    uri (1.1.0)
+    vcr (6.3.1)
+      base64
+    webmock (3.26.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  dk_payment_gateway!
+  dotenv (>= 3.1.8)
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.21)
+  vcr (~> 6.1)
+  webmock (~> 3.18)
+
+BUNDLED WITH
+   2.7.2

data/INSTALLATION.md

@@ -426,7 +426,7 @@ end
 ```ruby
 # config/environments/development.rb
 DkPaymentGateway.configure do |config|
-  config.base_url = "http://internal-gateway.uat.digitalkidu.bt/api/dkpg"
+  config.base_url = "https://internal-gateway.uat.digitalkidu.bt/api/dkpg"
   # ... UAT credentials
 end
 ```

data/QUICK_START.md

@@ -21,7 +21,7 @@ require 'dk_payment_gateway'
 
 # Configure
 DkPaymentGateway.configure do |config|
-  config.base_url = "http://internal-gateway.uat.digitalkidu.bt/api/dkpg"
+  config.base_url = "https://internal-gateway.uat.digitalkidu.bt/api/dkpg"
   config.api_key = "your_api_key"
   config.username = "your_username"
   config.password = "your_password"
@@ -149,7 +149,7 @@ end
 Create a `.env` file:
 
 ```bash
-DK_BASE_URL=http://internal-gateway.uat.digitalkidu.bt/api/dkpg
+DK_BASE_URL=https://internal-gateway.uat.digitalkidu.bt/api/dkpg
 DK_API_KEY=your_api_key
 DK_USERNAME=your_username
 DK_PASSWORD=your_password
@@ -183,4 +183,3 @@ end
 ## Support
 
 For issues and questions, please refer to the documentation or contact support.
-

data/README.md

@@ -33,7 +33,7 @@ Configure the gem with your API credentials:
 
 ```ruby
 DkPaymentGateway.configure do |config|
-  config.base_url = "http://internal-gateway.uat.digitalkidu.bt/api/dkpg"
+  config.base_url = "https://internal-gateway.uat.digitalkidu.bt/api/dkpg"
   config.api_key = "98cf3639-df33-4587-9d36-dae9d2bb974c"
   config.username = "your_username"
   config.password = "your_password"
@@ -293,4 +293,3 @@ Bug reports and pull requests are welcome on GitHub.
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-

data/dk_payment_gateway.gemspec

@@ -1,22 +1,22 @@
 # frozen_string_literal: true
 
-require_relative "lib/dk_payment_gateway/version"
+require_relative 'lib/dk_payment_gateway/version'
 
 Gem::Specification.new do |spec|
-  spec.name = "dk_payment_gateway"
+  spec.name = 'dk_payment_gateway'
   spec.version = DkPaymentGateway::VERSION
-  spec.authors = ["Tashi Dendup"]
-  spec.email = ["tashii.dendupp@gmail.com"]
+  spec.authors = ['Tashi Dendup']
+  spec.email = ['tashii.dendupp@gmail.com']
 
-  spec.summary = "Ruby client for DK Payment Gateway API"
-  spec.description = "A Ruby gem for integrating with Digital Kidu Payment Gateway API, supporting pull payments, intra-bank transactions, QR generation, and transaction status verification."
-  spec.homepage = "https://github.com/dcplbt/dk_payment_gateway"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.7.0"
+  spec.summary = 'Ruby client for DK Payment Gateway API'
+  spec.description = 'A Ruby gem for integrating with Digital Kidu Payment Gateway API, supporting pull payments, intra-bank transactions, QR generation, and transaction status verification.'
+  spec.homepage = 'https://github.com/dcplbt/dk_payment_gateway'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.7.0'
 
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/dcplbt/dk_payment_gateway"
-  spec.metadata["changelog_uri"] = "https://github.com/dcplbt/dk_payment_gateway/blob/main/CHANGELOG.md"
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/dcplbt/dk_payment_gateway'
+  spec.metadata['changelog_uri'] = 'https://github.com/dcplbt/dk_payment_gateway/blob/main/CHANGELOG.md'
 
   # Specify which files should be added to the gem when it is released.
   spec.files = Dir.chdir(__dir__) do
@@ -24,17 +24,18 @@ Gem::Specification.new do |spec|
       (File.expand_path(f) == __FILE__) || f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor])
     end
   end
-  spec.bindir = "exe"
+  spec.bindir = 'exe'
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
   # Runtime dependencies
-  spec.add_dependency "faraday", "~> 2.0"
-  spec.add_dependency "jwt", "~> 2.7"
+  spec.add_dependency 'faraday', '~> 2.0'
+  spec.add_dependency 'jwt', '~> 2.7'
 
   # Development dependencies
-  spec.add_development_dependency "rake", "~> 13.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "webmock", "~> 3.18"
-  spec.add_development_dependency "vcr", "~> 6.1"
+  spec.add_development_dependency 'dotenv', '>= 3.1.8'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'vcr', '~> 6.1'
+  spec.add_development_dependency 'webmock', '~> 3.18'
 end