tappay_ruby 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d18643889a68b9dab0c275a18940d220af312803ee0d7099d67c0b6a9444d32e
-  data.tar.gz: 13d363e73d4e0626054c1114fb3d4ca8c2e99cdce1801726322734b6fe4cd9e7
+  metadata.gz: e47e2732e236d1bca9d0daa16466fbff08b9c43e044ccb9020e2a505632fcf2a
+  data.tar.gz: af086bf4adf1a925fc1beb1cfc25dc3903421592b80c73e3efc8007c8a463d75
 SHA512:
-  metadata.gz: 92b2a1264def50c34cb1ad8c970bc04d9b0c1784096e0afe1968923603158415ece5469f8242fa9a8968c0574a9e56586c24b71dcd1abc9059a2d85554eca1a2
-  data.tar.gz: cb67371f349e6e378fbbe93723ef7926db7bc49f5eb1a96fea0ea00a3af65c0a173aab1bf2aeb8b6772398d8ad7702c5058ff046a3015190f2fd7ad06f37e1e2
+  metadata.gz: 93ab78ddbcbd031929a051fe085cd7c8b63d289e88f0defc9eb5299924795692b35145680e373c87503f893403077d0e439339cdec4b50efb9ca9d339f9e9fc9
+  data.tar.gz: 94023de9c35c2ac47265f3abf9f2beeee0659fd2c977a5ce7cc3962cdc55867b5313c115327b3f2a2b17340f737c59d42f08747e5dd722f3ad4ef5f9c0e6adf4

data/README.md

@@ -12,6 +12,7 @@ A Ruby library for integrating with TapPay payment services. This gem provides a
   - Credit card payments (one-time and tokenized)
   - Instalment payments (3 to 24 months)
   - Line Pay
+  - JKO Pay
 - Refund processing
 - Transaction status queries
 - Comprehensive error handling
@@ -64,6 +65,7 @@ Tappay.configure do |config|
   # Payment-specific merchant IDs
   config.instalment_merchant_id = 'your_instalment_merchant_id'.freeze
   config.line_pay_merchant_id = 'your_line_pay_merchant_id'.freeze
+  config.jko_pay_merchant_id = 'your_jko_pay_merchant_id'.freeze
 
   config.currency = 'TWD'.freeze
   config.vat_number = 'your_vat_number'.freeze
@@ -81,6 +83,7 @@ The gem supports flexible merchant ID configuration:
 2. Payment-specific merchant IDs:
    - `instalment_merchant_id`: Specific merchant ID for instalment payments
    - `line_pay_merchant_id`: Specific merchant ID for Line Pay transactions
+   - `jko_pay_merchant_id`: Specific merchant ID for JKO Pay transactions
 
 Merchant ID Priority:
 1. Payment options merchant ID (if provided in the payment call)
@@ -126,6 +129,7 @@ Tappay.configure do |config|
   config.merchant_id = ENV['TAPPAY_MERCHANT_ID'].freeze
   config.line_pay_merchant_id = ENV['TAPPAY_LINE_PAY_MERCHANT_ID'].freeze
   config.instalment_merchant_id = ENV['TAPPAY_INSTALMENT_MERCHANT_ID'].freeze
+  config.jko_pay_merchant_id = ENV['TAPPAY_JKO_PAY_MERCHANT_ID'].freeze
   # ... other configurations
 end
 ```
@@ -174,6 +178,35 @@ result = Tappay::LinePay::Pay.new(
 ).execute
 ```
 
+### JKO Pay
+
+#### Configuration
+
+```ruby
+Tappay.configure do |config|
+  config.partner_key = 'YOUR_PARTNER_KEY'
+  config.merchant_id = 'YOUR_MERCHANT_ID'
+  config.jko_pay_merchant_id = 'YOUR_JKO_PAY_MERCHANT_ID' # Optional, falls back to merchant_id if not set
+  config.sandbox = true # Set to false for production
+end
+```
+
+#### Processing a JKO Pay Payment
+
+```ruby
+payment_options = {
+  prime: 'jko_pay_prime',
+  merchant_id: 'YOUR_MERCHANT_ID',
+  amount: 1000,
+  details: 'Some item',
+  frontend_redirect_url: 'https://your-site.com/jko_pay/result',
+  backend_notify_url: 'https://your-site.com/jko_pay/notify'
+}
+
+payment = Tappay::JkoPay::Pay.new(payment_options)
+result = payment.execute
+```
+
 ### Error Handling
 
 The gem provides comprehensive error handling:

data/lib/tappay/configuration.rb

@@ -3,7 +3,7 @@
 module Tappay
   class Configuration
     attr_accessor :partner_key, :merchant_id, :merchant_group_id, :instalment_merchant_id,
-                 :line_pay_merchant_id, :app_id, :currency, :vat_number
+                 :line_pay_merchant_id, :jko_pay_merchant_id, :app_id, :currency, :vat_number
     attr_writer :api_version
 
     def initialize
@@ -33,5 +33,10 @@ module Tappay
     def mode
       @mode ||= :sandbox
     end
+
+    def validate!
+      raise ValidationError, 'partner_key is required' if partner_key.nil?
+      raise ValidationError, 'merchant_id is required' if merchant_id.nil?
+    end
   end
 end

data/lib/tappay/jko_pay/pay.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Tappay
+  module JkoPay
+    class Pay < PaymentBase
+      def initialize(options = {})
+        super
+        validate_jko_pay_options!
+      end
+
+      def endpoint_url
+        Endpoints::Payment.pay_by_prime_url
+      end
+
+      private
+
+      def get_merchant_id
+        Tappay.configuration.jko_pay_merchant_id || super
+      end
+
+      def validate_jko_pay_options!
+        validate_result_urls!
+      end
+
+      def validate_result_urls!
+        raise ValidationError, 'frontend_redirect_url is required for JKO Pay' if options[:frontend_redirect_url].nil?
+        raise ValidationError, 'backend_notify_url is required for JKO Pay' if options[:backend_notify_url].nil?
+      end
+
+      def payment_data
+        data = super
+        data[:result_url] = {
+          frontend_redirect_url: options[:frontend_redirect_url],
+          backend_notify_url: options[:backend_notify_url]
+        }
+        data[:prime] = options[:prime]
+        data[:remember] = options[:remember] || false
+        data
+      end
+    end
+  end
+end

data/lib/tappay/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tappay
-  VERSION = "0.8.0"
+  VERSION = "0.9.0"
 end

data/lib/tappay.rb

@@ -1,9 +1,15 @@
 # frozen_string_literal: true
 
+require 'csv'
+require 'json'
+require 'net/http'
+require 'uri'
+
 require_relative "tappay/version"
 require_relative "tappay/configuration"
 require_relative "tappay/client"
 require_relative "tappay/errors"
+require_relative "tappay/payment_base"
 require_relative "tappay/card_holder"
 require_relative "tappay/endpoints"
 require_relative "tappay/transaction/query"
@@ -11,20 +17,26 @@ require_relative "tappay/credit_card/pay"
 require_relative "tappay/credit_card/refund"
 require_relative "tappay/credit_card/instalment"
 require_relative "tappay/line_pay/pay"
+require_relative "tappay/jko_pay/pay"
 
 module Tappay
   class Error < StandardError; end
+  class ValidationError < Error; end
 
   class << self
-    attr_accessor :configuration
-  end
+    attr_writer :configuration
 
-  def self.configure
-    self.configuration ||= Configuration.new
-    yield(configuration) if block_given?
-  end
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration) if block_given?
+    end
 
-  def self.reset
-    self.configuration = Configuration.new
+    def reset
+      self.configuration = Configuration.new
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tappay_ruby
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Zac
@@ -83,6 +83,7 @@ files:
 - lib/tappay/credit_card/refund.rb
 - lib/tappay/endpoints.rb
 - lib/tappay/errors.rb
+- lib/tappay/jko_pay/pay.rb
 - lib/tappay/line_pay/pay.rb
 - lib/tappay/payment_base.rb
 - lib/tappay/transaction/query.rb