airwallex-ruby 0.1.0

data/lib/airwallex/resources/payment_intents.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Airwallex
+  module Resources
+    class PaymentIntents < BaseResource
+      def create(params = {}, idempotency_key: nil)
+        validate_params!(params)
+        post("/pa/payment_intents/create", params, {}, idempotency_key: idempotency_key)
+      end
+
+      def retrieve(id)
+        validate_id!(id)
+        get("/pa/payment_intents/#{id}")
+      end
+
+      def update(id, params = {}, idempotency_key: nil)
+        validate_id!(id)
+        validate_params!(params)
+        post("/pa/payment_intents/#{id}/update", params, {}, idempotency_key: idempotency_key)
+      end
+
+      def cancel(id, idempotency_key: nil)
+        validate_id!(id)
+        post("/pa/payment_intents/#{id}/cancel", {}, {}, idempotency_key: idempotency_key)
+      end
+
+      def list(params = {})
+        validate_params!(params)
+        get("/pa/payment_intents", params)
+      end
+    end
+  end
+end

data/lib/airwallex/resources/refunds.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Airwallex
+  module Resources
+    class Refunds < BaseResource
+      def create(params = {}, idempotency_key: nil)
+        validate_params!(params)
+        post("/pa/refunds/create", params, {}, idempotency_key: idempotency_key)
+      end
+
+      def retrieve(id)
+        validate_id!(id)
+        get("/pa/refunds/#{id}")
+      end
+
+      def list(params = {})
+        validate_params!(params)
+        get("/pa/refunds", params)
+      end
+    end
+  end
+end

data/lib/airwallex/version.rb

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

data/lib/airwallex/webhook.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require "json"
+require "openssl"
+
+module Airwallex
+  module Webhook
+    MILLISECONDS_THRESHOLD = 1_000_000_000_000
+
+    module_function
+
+    def construct_event(payload:, signature:, timestamp:, secret:, tolerance: 300)
+      verify_signature!(
+        payload: payload,
+        signature: signature,
+        timestamp: timestamp,
+        secret: secret,
+        tolerance: tolerance
+      )
+
+      JSON.parse(payload)
+    rescue JSON::ParserError
+      raise InvalidResponseError, "Invalid webhook payload"
+    end
+
+    def verify_signature(payload:, signature:, timestamp:, secret:, tolerance: 300)
+      verify_signature!(
+        payload: payload,
+        signature: signature,
+        timestamp: timestamp,
+        secret: secret,
+        tolerance: tolerance
+      )
+
+      true
+    end
+
+    def verify_signature!(payload:, signature:, timestamp:, secret:, tolerance: 300)
+      validate_inputs!(payload, signature, timestamp, secret, tolerance)
+
+      normalized_timestamp = normalize_timestamp!(timestamp)
+      validate_timestamp_tolerance!(normalized_timestamp, tolerance)
+
+      expected_signature = compute_signature(timestamp, payload, secret)
+
+      raise WebhookSignatureError, "Invalid signature" unless secure_compare(expected_signature, signature.to_s)
+
+      true
+    end
+
+    def secure_compare(a, b)
+      return false unless a.bytesize == b.bytesize
+
+      l = a.unpack "C#{a.bytesize}"
+      res = 0
+      b.each_byte { |byte| res |= byte ^ l.shift }
+      res.zero?
+    end
+
+    def validate_inputs!(payload, signature, timestamp, secret, tolerance)
+      raise WebhookSignatureError, "Missing payload" if payload.nil? || payload.to_s.empty?
+      raise WebhookSignatureError, "Missing signature" if signature.nil? || signature.to_s.empty?
+      raise WebhookSignatureError, "Missing timestamp" if timestamp.nil? || timestamp.to_s.empty?
+      raise WebhookSignatureError, "Missing secret" if secret.nil? || secret.to_s.empty?
+      raise WebhookSignatureError, "Invalid tolerance" unless tolerance.is_a?(Integer) && tolerance.positive?
+    end
+
+    def normalize_timestamp!(timestamp)
+      ts = Integer(timestamp)
+      ts /= 1000 if ts > MILLISECONDS_THRESHOLD
+      ts
+    rescue ::ArgumentError, ::TypeError
+      raise WebhookSignatureError, "Invalid timestamp"
+    end
+
+    def validate_timestamp_tolerance!(timestamp, tolerance)
+      return if (Time.now.to_i - timestamp).abs <= tolerance
+
+      raise WebhookSignatureError, "Timestamp outside tolerance"
+    end
+
+    def compute_signature(timestamp, payload, secret)
+      value_to_digest = timestamp.to_s + payload.to_s
+
+      OpenSSL::HMAC.hexdigest(
+        "SHA256",
+        secret,
+        value_to_digest
+      )
+    end
+
+    private_class_method :validate_inputs!, :normalize_timestamp!, :validate_timestamp_tolerance!, :compute_signature
+  end
+end

data/lib/airwallex.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "airwallex/version"
+require_relative "airwallex/errors"
+require_relative "airwallex/configuration"
+require_relative "airwallex/client"
+require_relative "airwallex/resources/base_resource"
+require_relative "airwallex/resources/authentication"
+require_relative "airwallex/resources/payment_intents"
+require_relative "airwallex/resources/refunds"
+require_relative "airwallex/webhook"
+require_relative "airwallex/railtie" if defined?(Rails::Railtie)
+
+module Airwallex
+  module Resources
+  end
+
+  class << self
+    def configure
+      yield(configuration) if block_given?
+      @client = nil
+      configuration
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+      @client = nil
+    end
+
+    def client
+      @client ||= Client.new
+    end
+  end
+end

data/lib/generators/airwallex/install/install_generator.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Airwallex
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      def copy_initializer
+        template "airwallex.rb", "config/initializers/airwallex.rb"
+      end
+    end
+  end
+end

data/lib/generators/airwallex/install/templates/airwallex.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+Airwallex.configure do |config|
+  config.client_id = Rails.application.credentials.dig(:airwallex, :client_id) || ENV["AIRWALLEX_CLIENT_ID"]
+  config.api_key = Rails.application.credentials.dig(:airwallex, :api_key) || ENV["AIRWALLEX_API_KEY"]
+  config.login_as = Rails.application.credentials.dig(:airwallex, :login_as) || ENV["AIRWALLEX_LOGIN_AS"]
+  config.environment = Rails.env.production? ? :production : :demo
+  config.timeout = 30
+  config.open_timeout = 10
+end

metadata

@@ -0,0 +1,195 @@
+--- !ruby/object:Gem::Specification
+name: airwallex-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- James Martin Dela Cruz
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.75'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.75'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.23'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.23'
+description: An unofficial Ruby client library for Airwallex payment, payout, and
+  treasury APIs.
+email:
+- delacruzjamesmartin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- airwallex-ruby.gemspec
+- docs/airwallex-research.md
+- docs/release.md
+- examples/basic_configuration.rb
+- examples/payment_intent_create.rb
+- examples/rails_webhook_controller.rb
+- examples/refund_create.rb
+- examples/webhook_verification.rb
+- lib/airwallex.rb
+- lib/airwallex/client.rb
+- lib/airwallex/configuration.rb
+- lib/airwallex/errors.rb
+- lib/airwallex/railtie.rb
+- lib/airwallex/resources/authentication.rb
+- lib/airwallex/resources/base_resource.rb
+- lib/airwallex/resources/payment_intents.rb
+- lib/airwallex/resources/refunds.rb
+- lib/airwallex/version.rb
+- lib/airwallex/webhook.rb
+- lib/generators/airwallex/install/install_generator.rb
+- lib/generators/airwallex/install/templates/airwallex.rb
+homepage: https://github.com/delacruzjames/airwallex-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/delacruzjames/airwallex-ruby
+  source_code_uri: https://github.com/delacruzjames/airwallex-ruby
+  changelog_uri: https://github.com/delacruzjames/airwallex-ruby/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Unofficial Ruby SDK for Airwallex APIs
+test_files: []