p24 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fe475892d3ce9320eda7573e4fbbf8b7296708d5505700ad80300bcae324f4c4
+  data.tar.gz: fcae282e5de5d184b27d24456aa53a2cd4996808fa9b76910597d4ba67156b66
+SHA512:
+  metadata.gz: 1890ad413b885b269ad7db9afd04b795a27208c8c6d629539ffaaca431611c8a81fa3a94524146128375673ff392eda9823bae7a5bdb51f8d0375005e56a3813
+  data.tar.gz: 5875fbd4044a7f9e34dbdc0090a7a14e44dba89ab64072b92aaf6dcee83eb8c316bfc4abd9f771b6e01eee305295892c8c4770d424bc7b4845c92d005dc54831

data/.rubocop.yml

@@ -0,0 +1,33 @@
+require:
+  - rubocop-minitest
+  - rubocop-rake
+Style/Documentation:
+  Enabled: false
+AllCops:
+  TargetRubyVersion: 3.2
+  NewCops: disable
+  Exclude:
+    - "bin/**/*"
+    - "vendor/**/*"
+Metrics/MethodLength:
+  Enabled: false
+Metrics/BlockLength:
+  Exclude:
+    - 'config/environments/**/*'
+Security/MarshalLoad:
+  Enabled: false
+Lint/MissingSuper:
+  Enabled: false
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+Metrics/ClassLength:
+  Max: 150
+  Exclude:
+    - 'test/**/*'
+Layout/LineLength:
+  Max: 150
+Metrics/ParameterLists:
+  Enabled: false
+Metrics/AbcSize:
+  Enabled: false

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Konrad Makowski
+
+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/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Konrad Makowski
+
+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,203 @@
+# P24 == Przelewy24
+
+A Ruby gem for integrating with Przelewy24 (P24), a popular Polish payment gateway. This library provides a simple and intuitive interface for handling online payments through the Przelewy24 API v1.
+
+## Features
+
+- Transaction registration and verification
+- Payment method discovery
+- Transaction notification handling with signature verification
+- Support for both sandbox and production environments
+- Built-in authentication and request signing
+- Comprehensive error handling
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'p24'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install p24
+```
+
+## Configuration
+
+Initialize the client with your Przelewy24 credentials:
+
+```ruby
+client = P24::Client.new(
+  user: 'your_merchant_id',
+  secret_id: 'your_api_secret',
+  crc: 'your_crc_key',
+  base_url: 'https://sandbox.przelewy24.pl/api/v1', # Use production URL for live transactions
+  timeout: 30,
+  encoding: 'UTF-8',
+  debug: false
+)
+
+# Alternatively, you can use the Przelewy24 alias
+client = Przelewy24.new(
+  user: 'your_merchant_id',
+  secret_id: 'your_api_secret',
+  crc: 'your_crc_key'
+)
+```
+
+### Configuration Options
+
+- `user` (required): Your Przelewy24 merchant ID
+- `secret_id` (required): Your API secret/password
+- `crc` (required): Your CRC key for request signing
+- `base_url` (optional): API endpoint URL (defaults to sandbox)
+- `timeout` (optional): Request timeout in seconds (default: 30)
+- `encoding` (optional): Character encoding (default: 'UTF-8')
+- `debug` (optional): Enable debug output (default: false)
+
+## Usage
+
+### Test API Access
+
+Verify your credentials and API connectivity:
+
+```ruby
+response = client.test_access
+puts response.error_code # Should be 0 for successful connection
+```
+
+### Register a Transaction
+
+Create a new payment transaction:
+
+```ruby
+response = client.transaction_register(
+  merchant_id: 12345,
+  pos_id: 12345,
+  session_id: 'unique_session_id',
+  amount: 1000, # Amount in grosze (1000 = 10.00 PLN)
+  currency: 'PLN',
+  description: 'Order #123',
+  email: 'customer@example.com',
+  country: 'PL',
+  language: 'pl',
+  url_return: 'https://yoursite.com/payment/return',
+  url_status: 'https://yoursite.com/payment/status'
+)
+
+# Get the payment token
+token = response.token
+
+# Redirect user to payment page
+redirect_url = client.redirect_url(token)
+# => "https://sandbox.przelewy24.pl/trnRequest/{token}"
+```
+
+### Verify a Transaction
+
+Verify transaction status after payment:
+
+```ruby
+response = client.transaction_verify(
+  merchant_id: 12345,
+  pos_id: 12345,
+  session_id: 'unique_session_id',
+  amount: 1000,
+  currency: 'PLN',
+  order_id: 98765 # Received from P24 notification
+)
+
+puts response.error_code # 0 means successful verification
+```
+
+### Handle Payment Notifications
+
+Verify incoming payment notifications from Przelewy24:
+
+```ruby
+# In your webhook/callback endpoint
+is_valid = client.transaction_notification(
+  merchant_id: params[:merchantId],
+  pos_id: params[:posId],
+  session_id: params[:sessionId],
+  amount: params[:amount],
+  origin_amount: params[:originAmount],
+  currency: params[:currency],
+  order_id: params[:orderId],
+  method_id: params[:methodId],
+  statement: params[:statement],
+  sign: params[:sign]
+)
+
+if is_valid
+  # Process successful payment
+else
+  # Invalid signature - potential fraud attempt
+end
+```
+
+### Get Available Payment Methods
+
+Retrieve available payment methods for your customers:
+
+```ruby
+methods = client.payment_methods(
+  'pl', # Language
+  amount: 1000, # Optional: filter by amount
+  currency: 'PLN' # Optional: filter by currency
+)
+
+methods.each do |method|
+  puts "#{method.name} - #{method.status}"
+end
+```
+
+## API Reference
+
+### Client Methods
+
+#### `transaction_register(**kwargs)`
+Registers a new transaction and returns a token for payment redirection.
+
+#### `transaction_verify(**kwargs)`
+Verifies a completed transaction.
+
+#### `transaction_notification(**kwargs)`
+Validates the signature of a payment notification from P24.
+
+#### `payment_methods(lang, amount: nil, currency: nil)`
+Retrieves available payment methods.
+
+#### `test_access`
+Tests API credentials and connectivity.
+
+#### `redirect_url(token)`
+Generates the payment page URL for a given token.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/DeVeLo/p24.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Resources
+
+- [Przelewy24 Official Documentation](https://www.przelewy24.pl/do-pobrania#dokumentacja-techniczna)
+- [Przelewy24 API v1 Reference](https://developers.przelewy24.pl/)

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'minitest/test_task'
+
+Minitest::TestTask.create
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/lib/p24/api/v1/request/transaction_register.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module P24
+  module Api
+    module V1
+      module Request
+        class TransactionRegister
+          attr_reader :merchant_id, :pos_id, :session_id, :amount, :currency, :description, :email,
+                      :client, :address, :zip, :city, :country, :phone, :language, :method, :url_return,
+                      :url_status, :time_limit, :channel, :wait_for_result, :regulation_accept, :shipping,
+                      :transfer_label, :mobile_lib, :sdk_version, :encoding, :method_ref_id, :crc
+
+          def initialize(merchant_id:, pos_id:, session_id:, amount:, currency:, description:, email:,
+                         country:, language:, url_return:, crc:, client: nil, address: nil, zip: nil, city: nil,
+                         phone: nil, method: nil, url_status: nil, time_limit: nil, channel: nil,
+                         wait_for_result: nil, regulation_accept: nil, shipping: nil, transfer_label: nil,
+                         mobile_lib: nil, sdk_version: nil, encoding: nil, method_ref_id: nil)
+            @merchant_id = merchant_id
+            @pos_id = pos_id
+            @session_id = session_id
+            @amount = amount
+            @currency = currency
+            @description = description
+            @email = email
+            @client = client
+            @address = address
+            @zip = zip
+            @city = city
+            @country = country
+            @phone = phone
+            @language = language
+            @method = method
+            @url_return = url_return
+            @url_status = url_status
+            @time_limit = time_limit
+            @channel = channel
+            @wait_for_result = wait_for_result
+            @regulation_accept = regulation_accept
+            @shipping = shipping
+            @transfer_label = transfer_label
+            @mobile_lib = mobile_lib
+            @sdk_version = sdk_version
+            @encoding = encoding
+            @method_ref_id = method_ref_id
+            @crc = crc
+          end
+
+          def to_json(*_args)
+            {
+              merchantId: merchant_id,
+              posId: pos_id,
+              sessionId: session_id,
+              amount:,
+              currency:,
+              description:,
+              email:,
+              client:,
+              address:,
+              zip:,
+              city:,
+              country:,
+              phone:,
+              language:,
+              method:,
+              urlReturn: url_return,
+              urlStatus: url_status,
+              timeLimit: time_limit,
+              channel:,
+              waitForResult: wait_for_result,
+              regulationAccept: regulation_accept,
+              shipping:,
+              transferLabel: transfer_label,
+              mobileLib: mobile_lib,
+              sdkVersion: sdk_version,
+              sign:,
+              encoding:,
+              methodRefId: method_ref_id
+            }.compact.to_json
+          end
+
+          private
+
+          def sign_params
+            {
+              sessionId: session_id,
+              merchantId: merchant_id,
+              amount:,
+              currency:,
+              crc:
+            }
+          end
+
+          def sign
+            Digest::SHA384.hexdigest sign_params.to_json
+          end
+        end
+      end
+    end
+  end
+end

data/lib/p24/api/v1/request/transaction_verify.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module P24
+  module Api
+    module V1
+      module Request
+        class TransactionVerify
+          attr_reader :merchant_id, :pos_id, :session_id, :amount, :currency, :order_id, :crc
+
+          def initialize(merchant_id:, pos_id:, session_id:, amount:, currency:, order_id:, crc:)
+            @merchant_id = merchant_id
+            @pos_id = pos_id
+            @session_id = session_id
+            @amount = amount
+            @currency = currency
+            @order_id = order_id
+            @crc = crc
+          end
+
+          def to_json(*_args)
+            {
+              merchantId: merchant_id,
+              posId: pos_id,
+              orderId: order_id,
+              sessionId: session_id,
+              amount:,
+              currency:,
+              sign:
+            }.compact.to_json
+          end
+
+          private
+
+          def sign_params
+            {
+              sessionId: session_id,
+              orderId: order_id,
+              amount:,
+              currency:,
+              crc:
+            }
+          end
+
+          def sign
+            Digest::SHA384.hexdigest sign_params.to_json
+          end
+        end
+      end
+    end
+  end
+end

data/lib/p24/api/v1/response/payment_method/availability_hours.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module P24
+  module Api
+    module V1
+      module Response
+        module PaymentMethod
+          class AvailabilityHours
+            attr_reader :monday_to_friday, :saturday, :sunday
+
+            def initialize(monday_to_friday:, saturday:, sunday:)
+              @monday_to_friday = monday_to_friday
+              @saturday = saturday
+              @sunday = sunday
+            end
+
+            def to_json(options = {})
+              { monday_to_friday:, saturday:, sunday: }.to_json(options)
+            end
+
+            class << self
+              def from_json(json)
+                new(
+                  monday_to_friday: json['mondayToFriday'],
+                  saturday: json['saturday'],
+                  sunday: json['sunday']
+                )
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/p24/api/v1/response/payment_method/data.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module P24
+  module Api
+    module V1
+      module Response
+        module PaymentMethod
+          class Data
+            attr_reader :name, :id, :group, :subgroup, :status, :img_url,
+                        :mobile_img_url, :mobile, :availability_hours
+
+            def initialize(name:, id:, group:, subgroup:, status:, img_url:,
+                           mobile_img_url:, mobile:, availability_hours:)
+              @name = name
+              @id = id
+              @group = group
+              @subgroup = subgroup
+              @status = status
+              @img_url = img_url
+              @mobile_img_url = mobile_img_url
+              @mobile = mobile
+              @availability_hours = AvailabilityHours.from_json(availability_hours)
+            end
+
+            def to_json(options = {})
+              { name:, id:, group:, subgroup:, status:, img_url:,
+                mobile_img_url:, mobile:, availability_hours: }.to_json(options)
+            end
+
+            class << self
+              def from_json(json)
+                new(
+                  name: json['name'],
+                  id: json['id'],
+                  group: json['group'],
+                  subgroup: json['subgroup'],
+                  status: json['status'],
+                  img_url: json['imgUrl'],
+                  mobile_img_url: json['mobileImgUrl'],
+                  mobile: json['mobile'],
+                  availability_hours: json['availabilityHours']
+                )
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/p24/api/v1/response/payment_methods.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module P24
+  module Api
+    module V1
+      module Response
+        class PaymentMethods
+          attr_reader :data, :agreements, :response_code
+
+          def initialize(data:, agreements:, response_code:)
+            @data = data.map { |d| PaymentMethod::Data.from_json(d) }
+            @agreements = agreements
+            @response_code = response_code
+          end
+
+          def to_json(options = {})
+            { data:, agreements:, response_code: }.to_json(options)
+          end
+
+          class << self
+            def from_json(json)
+              new(
+                data: json['data'],
+                agreements: json['agreements'],
+                response_code: json['responseCode']
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/p24/api/v1/response/test_access.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module P24
+  module Api
+    module V1
+      module Response
+        class TestAccess
+          attr_reader :data, :error
+
+          def initialize(data:, error:)
+            @data = data
+            @error = error
+          end
+
+          def to_json(options = {})
+            { data:, error: }.to_json(options)
+          end
+
+          class << self
+            def from_json(json)
+              new(
+                data: json['data'],
+                error: json['error']
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/p24/api/v1/response/transaction_register.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module P24
+  module Api
+    module V1
+      module Response
+        class TransactionRegister
+          attr_reader :data, :response_code
+
+          Data = Struct.new(:token)
+
+          def initialize(data:, response_code:)
+            @data = Data.new(data['token'])
+            @response_code = response_code
+          end
+
+          def to_json(options = {})
+            { data: data.to_h, response_code: }.to_json(options)
+          end
+
+          class << self
+            def from_json(json)
+              new(
+                data: json['data'],
+                response_code: json['responseCode']
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/p24/api/v1/response/transaction_verify.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module P24
+  module Api
+    module V1
+      module Response
+        class TransactionVerify
+          attr_reader :data, :response_code
+
+          Data = Struct.new(:status)
+
+          def initialize(data:, response_code:)
+            @data = Data.new(data['status'])
+            @response_code = response_code
+          end
+
+          def to_json(options = {})
+            { data: data.to_h, response_code: }.to_json(options)
+          end
+
+          class << self
+            def from_json(json)
+              new(
+                data: json['data'],
+                response_code: json['responseCode']
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/p24/api/v1/transaction_notification.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module P24
+  module Api
+    module V1
+      class TransactionNotification
+        attr_reader :merchant_id, :pos_id, :session_id, :amount, :origin_amount, :currency,
+                    :order_id, :method_id, :statement, :crc, :sign
+
+        def initialize(merchant_id:, pos_id:, session_id:, amount:, origin_amount:, currency:,
+                       order_id:, method_id:, statement:, crc:, sign: nil)
+          @merchant_id = merchant_id
+          @pos_id = pos_id
+          @session_id = session_id
+          @amount = amount
+          @origin_amount = origin_amount
+          @currency = currency
+          @order_id = order_id
+          @method_id = method_id
+          @statement = statement
+          @sign = sign
+          @crc = crc
+        end
+
+        def to_json(*_args)
+          {
+            merchantId: merchant_id,
+            posId: pos_id,
+            sessionId: session_id,
+            amount:,
+            originAmount: origin_amount,
+            currency:,
+            orderId: order_id,
+            methodId: method_id,
+            statement:,
+            sign:
+          }.compact.to_json
+        end
+
+        def from_json(json, crc)
+          new(
+            merchant_id: json['merchantId'],
+            pos_id: json['posId'],
+            session_id: json['sessionId'],
+            amount: ['amount'],
+            origin_amount: json['originAmount'],
+            currency: json['currency'],
+            order_id: json['orderId'],
+            method_id: json['methodId'],
+            statement: json['statement'],
+            sign: json['sign'],
+            crc:
+          )
+        end
+
+        def correct?
+          sign == Digest::SHA384.hexdigest(sign_params.to_json)
+        end
+
+        private
+
+        def sign_params
+          {
+            merchantId: merchant_id,
+            posId: pos_id,
+            sessionId: session_id,
+            amount:,
+            originAmount: origin_amount,
+            currency:,
+            orderId: order_id,
+            methodId: method_id,
+            statement:,
+            crc:
+          }
+        end
+      end
+    end
+  end
+end

data/lib/p24/client.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+module P24
+  class Client
+    attr_reader :user, :secret_id, :crc, :base_url, :timeout, :debug, :encoding
+
+    def initialize(user:, secret_id:, crc:, base_url: 'https://sandbox.przelewy24.pl/api/v1', timeout: 30,
+                   encoding: 'UTF-8', debug: false)
+      @user = user
+      @secret_id = secret_id
+      @crc = crc
+      @timeout = timeout
+      @base_url = base_url
+      @debug = debug
+      @encoding = encoding
+    end
+
+    def transaction_register(**kwargs)
+      generic_post_json(
+        endpoint('/transaction/register'),
+        Api::V1::Request::TransactionRegister.new(**kwargs.merge({ crc:, encoding: })).to_json,
+        Api::V1::Response::TransactionRegister
+      )
+    end
+
+    def transaction_verify(**kwargs)
+      generic_put_json(
+        endpoint('/transaction/verify'),
+        Api::V1::Request::TransactionVerify.new(**kwargs.merge({ crc: })).to_json,
+        Api::V1::Response::TransactionVerify
+      )
+    end
+
+    def transaction_notification(**kwargs)
+      Api::V1::TransactionNotification.new(**kwargs.merge({ crc: })).correct?
+    end
+
+    def payment_methods(lang, amount: nil, currency: nil)
+      generic_json endpoint(
+        "/payment/methods/#{lang}",
+        **keyword_args(__method__, binding)
+      ), Api::V1::Response::PaymentMethods
+    end
+
+    def test_access
+      generic_json endpoint(
+        '/testAccess'
+      ), Api::V1::Response::TestAccess
+    end
+
+    def redirect_url(token)
+      "#{uri(base_url)}/trnRequest/#{token}"
+    end
+
+    private
+
+    def endpoint(url, *_args, **params)
+      uri = URI "#{base_url}#{url}"
+      uri.query = URI.encode_www_form(convert_keys_to_camelcase(params)).gsub('%2C', ',')
+      uri.to_s
+    end
+
+    def generic_json(uri, type)
+      response = HTTParty.get(uri, timeout:, basic_auth:, headers:, debug_output: debug ? $stdout : false)
+      handle_response(uri, response, type)
+    end
+
+    def generic_post_json(uri, body, type)
+      response = HTTParty.post(uri, timeout:, basic_auth:, headers:, body:, debug_output: debug ? $stdout : false)
+      handle_response(uri, response, type)
+    end
+
+    def generic_put_json(uri, body, type)
+      response = HTTParty.put(uri, timeout:, basic_auth:, headers:, body:, debug_output: debug ? $stdout : false)
+      handle_response(uri, response, type)
+    end
+
+    def handle_response(uri, response, type)
+      if response.success?
+        json_response = JSON.parse(response.body)
+        response_container = json_response.is_a?(Array) ? json_response : json_response['response']
+        if response_container.is_a?(Array)
+          response_container.map do |response_json|
+            type.from_json(response_json)
+          end
+        else
+          type.from_json(json_response)
+        end
+      else
+        raise_error(response, uri)
+      end
+    end
+
+    def raise_error(response, uri)
+      raise "Invalid HTTP response code: #{response.code}; " \
+            "Response body: #{response.body}; " \
+            "Request URI: #{uri};"
+    end
+
+    def convert_keys_to_camelcase(hash)
+      hash.transform_keys { |key| camelcase(key.to_s) }
+    end
+
+    def basic_auth
+      { username: user, password: secret_id }
+    end
+
+    def headers
+      { 'Content-Type' => 'application/json' }
+    end
+
+    def pids(array)
+      return if array.count.zero?
+
+      array.join(',')
+    end
+
+    def handle_args(arg)
+      case arg
+      when Array
+        pids(arg)
+      else
+        arg
+      end
+    end
+
+    def camelcase(str)
+      str.split('_').inject([]) { |buffer, e| buffer.push(buffer.empty? ? e : e.capitalize) }.join
+    end
+
+    def keyword_args(meth, bind)
+      method(meth).parameters.select { |type, _| %i[key keyreq].include? type }.map do |_, name|
+        [name, handle_args(bind.local_variable_get(name))]
+      end.to_h.compact
+    end
+
+    def uri(url)
+      purl = URI.parse(url)
+      "#{purl.scheme}://#{purl.host}"
+    end
+  end
+end

data/lib/p24/version.rb

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

data/lib/p24.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'uri'
+require 'httparty'
+require 'digest'
+
+require_relative 'p24/version'
+require_relative 'p24/client'
+
+require_relative 'przelewy24'
+
+require_relative 'p24/api/v1/response/test_access'
+
+require_relative 'p24/api/v1/request/transaction_register'
+
+require_relative 'p24/api/v1/response/payment_methods'
+require_relative 'p24/api/v1/response/payment_method/data'
+require_relative 'p24/api/v1/response/payment_method/availability_hours'
+require_relative 'p24/api/v1/response/transaction_register'
+
+require_relative 'p24/api/v1/request/transaction_verify'
+require_relative 'p24/api/v1/response/transaction_verify'
+
+require_relative 'p24/api/v1/transaction_notification'
+
+module P24
+end

data/lib/przelewy24.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+Przelewy24 = P24::Client

data/sig/p24.rbs

@@ -0,0 +1,4 @@
+module P24
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: p24
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Konrad Makowski
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  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'
+description: A Ruby gem for integrating with Przelewy24 (P24), a popular Polish payment
+  gateway. Provides transaction registration, verification, payment method discovery,
+  and notification handling with signature verification.
+email:
+- konrad@snopkow.eu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- LICENSE
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/p24.rb
+- lib/p24/api/v1/request/transaction_register.rb
+- lib/p24/api/v1/request/transaction_verify.rb
+- lib/p24/api/v1/response/payment_method/availability_hours.rb
+- lib/p24/api/v1/response/payment_method/data.rb
+- lib/p24/api/v1/response/payment_methods.rb
+- lib/p24/api/v1/response/test_access.rb
+- lib/p24/api/v1/response/transaction_register.rb
+- lib/p24/api/v1/response/transaction_verify.rb
+- lib/p24/api/v1/transaction_notification.rb
+- lib/p24/client.rb
+- lib/p24/version.rb
+- lib/przelewy24.rb
+- sig/p24.rbs
+homepage: https://github.com/DeVeLo/p24
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/DeVeLo/p24
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.4
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.0
+specification_version: 4
+summary: Ruby client for Przelewy24 payment gateway API
+test_files: []