pushpay-ruby 0.2.0

data/spec/pushpay/organization_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe PushPay::Organization do
+  let(:orgs) { described_class.new(PushPay.client) }
+  let(:base_url) { "https://api.pushpay.io" }
+
+  describe "#find" do
+    it "gets an organization by key" do
+      stub_request(:get, "#{base_url}/v1/organization/org_123")
+        .to_return(status: 200, body: { key: "org_123", name: "Test Org" }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = orgs.find("org_123")
+      expect(result["name"]).to eq("Test Org")
+    end
+  end
+
+  describe "#in_scope" do
+    it "lists accessible organizations" do
+      stub_request(:get, "#{base_url}/v1/organizations/in-scope")
+        .to_return(status: 200, body: { items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = orgs.in_scope
+      expect(result["items"]).to eq([])
+    end
+  end
+
+  describe "#campuses" do
+    it "lists campuses for the configured organization" do
+      stub_request(:get, "#{base_url}/v1/organization/test_org_key/campuses")
+        .to_return(status: 200, body: { items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = orgs.campuses
+      expect(result["items"]).to eq([])
+    end
+  end
+end

data/spec/pushpay/payment_spec.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe PushPay::Payment do
+  let(:payments) { described_class.new(PushPay.client) }
+  let(:base_url) { "https://api.pushpay.io" }
+
+  describe "#find" do
+    it "gets a payment by token" do
+      stub_request(:get, "#{base_url}/v1/merchant/test_merchant_key/payment/pay_123")
+        .to_return(status: 200, body: { paymentToken: "pay_123", status: "Success" }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = payments.find("pay_123")
+      expect(result["paymentToken"]).to eq("pay_123")
+    end
+
+    it "uses a custom merchant key" do
+      stub_request(:get, "#{base_url}/v1/merchant/custom_key/payment/pay_123")
+        .to_return(status: 200, body: { paymentToken: "pay_123" }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      payments.find("pay_123", merchant_key: "custom_key")
+    end
+  end
+
+  describe "#list" do
+    it "lists merchant payments" do
+      stub_request(:get, "#{base_url}/v1/merchant/test_merchant_key/payments")
+        .to_return(status: 200, body: { page: 0, pageSize: 25, items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = payments.list
+      expect(result["items"]).to eq([])
+    end
+
+    it "passes filter params" do
+      stub_request(:get, "#{base_url}/v1/merchant/test_merchant_key/payments")
+        .with(query: { status: "Success", pageSize: "10" })
+        .to_return(status: 200, body: { items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      payments.list(status: "Success", pageSize: "10")
+    end
+  end
+
+  describe "#list_for_organization" do
+    it "lists payments across an organization" do
+      stub_request(:get, "#{base_url}/v1/organization/test_org_key/payments")
+        .to_return(status: 200, body: { items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = payments.list_for_organization
+      expect(result["items"]).to eq([])
+    end
+  end
+end

data/spec/pushpay/recurring_payment_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe PushPay::RecurringPayment do
+  let(:recurring) { described_class.new(PushPay.client) }
+  let(:base_url) { "https://api.pushpay.io" }
+
+  describe "#find" do
+    it "gets a recurring payment by token" do
+      stub_request(:get, "#{base_url}/v1/merchant/test_merchant_key/recurringpayment/rp_123")
+        .to_return(status: 200, body: { paymentToken: "rp_123" }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = recurring.find("rp_123")
+      expect(result["paymentToken"]).to eq("rp_123")
+    end
+  end
+
+  describe "#list" do
+    it "lists merchant recurring payments" do
+      stub_request(:get, "#{base_url}/v1/merchant/test_merchant_key/recurringpayments")
+        .to_return(status: 200, body: { items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = recurring.list
+      expect(result["items"]).to eq([])
+    end
+  end
+
+  describe "#payments" do
+    it "lists payments linked to a recurring schedule" do
+      stub_request(:get, "#{base_url}/v1/merchant/test_merchant_key/recurringpayment/rp_123/payments")
+        .to_return(status: 200, body: { items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = recurring.payments("rp_123")
+      expect(result["items"]).to eq([])
+    end
+  end
+end

data/spec/pushpay/settlement_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe PushPay::Settlement do
+  let(:settlements) { described_class.new(PushPay.client) }
+  let(:base_url) { "https://api.pushpay.io" }
+
+  describe "#find" do
+    it "gets a settlement by key" do
+      stub_request(:get, "#{base_url}/v1/settlement/set_123")
+        .to_return(status: 200, body: { key: "set_123", name: "March Settlement" }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = settlements.find("set_123")
+      expect(result["name"]).to eq("March Settlement")
+    end
+  end
+
+  describe "#list" do
+    it "lists settlements for a merchant" do
+      stub_request(:get, "#{base_url}/v1/merchant/test_merchant_key/settlements")
+        .to_return(status: 200, body: { items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = settlements.list
+      expect(result["items"]).to eq([])
+    end
+  end
+
+  describe "#payments" do
+    it "lists payments within a settlement" do
+      stub_request(:get, "#{base_url}/v1/settlement/set_123/payments")
+        .to_return(status: 200, body: { items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = settlements.payments("set_123")
+      expect(result["items"]).to eq([])
+    end
+  end
+end

data/spec/pushpay/webhook_spec.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe PushPay::Webhook do
+  let(:webhooks) { described_class.new(PushPay.client) }
+  let(:base_url) { "https://api.pushpay.io" }
+
+  describe "#find" do
+    it "gets a webhook by token" do
+      stub_request(:get, "#{base_url}/v1/merchant/test_merchant_key/webhook/wh_123")
+        .to_return(status: 200, body: { token: "wh_123" }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = webhooks.find("wh_123")
+      expect(result["token"]).to eq("wh_123")
+    end
+  end
+
+  describe "#list" do
+    it "lists webhooks for a merchant" do
+      stub_request(:get, "#{base_url}/v1/merchant/test_merchant_key/webhooks")
+        .to_return(status: 200, body: { items: [] }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = webhooks.list
+      expect(result["items"]).to eq([])
+    end
+  end
+
+  describe "#create" do
+    it "creates a webhook" do
+      params = { target: "https://example.com/webhook", eventTypes: ["payment_created"] }
+
+      stub_request(:post, "#{base_url}/v1/merchant/test_merchant_key/webhooks")
+        .with(body: params.to_json)
+        .to_return(status: 201, body: { token: "wh_new" }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      result = webhooks.create(params)
+      expect(result["token"]).to eq("wh_new")
+    end
+  end
+
+  describe "#update" do
+    it "updates a webhook" do
+      stub_request(:put, "#{base_url}/v1/merchant/test_merchant_key/webhook/wh_123")
+        .to_return(status: 200, body: { token: "wh_123" }.to_json,
+                   headers: { "Content-Type" => "application/json" })
+
+      webhooks.update("wh_123", { target: "https://example.com/new" })
+    end
+  end
+
+  describe "#delete" do
+    it "deletes a webhook" do
+      stub_request(:delete, "#{base_url}/v1/merchant/test_merchant_key/webhook/wh_123")
+        .to_return(status: 204, body: nil)
+
+      webhooks.delete("wh_123")
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "pushpay"
+require "webmock/rspec"
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+  config.filter_run_when_matching :focus
+  config.example_status_persistence_file_path = "spec/examples.txt"
+  config.disable_monkey_patching!
+  config.warnings = true
+
+  if config.files_to_run.one?
+    config.default_formatter = "doc"
+  end
+
+  config.order = :random
+  Kernel.srand config.seed
+
+  config.before(:each) do
+    WebMock.disable_net_connect!
+    PushPay.reset!
+    PushPay.configure do |c|
+      c.client_id = "test_client_id"
+      c.client_secret = "test_client_secret"
+      c.merchant_key = "test_merchant_key"
+      c.organization_key = "test_org_key"
+    end
+
+    stub_request(:post, "https://auth.pushpay.com/pushpay/oauth/token")
+      .to_return(
+        status: 200,
+        body: { access_token: "test_token", token_type: "bearer", expires_in: 3600 }.to_json,
+        headers: { "Content-Type" => "application/json" }
+      )
+  end
+
+  config.after(:each) do
+    WebMock.reset!
+  end
+end

metadata

@@ -0,0 +1,191 @@
+--- !ruby/object:Gem::Specification
+name: pushpay-ruby
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Eduardo Souza
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  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: '2.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.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.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+description: Ruby gem for integrating with the PushPay payment processing API. Supports
+  payments, recurring payments, anticipated payments, funds, merchants, organizations,
+  settlements, batches, and webhooks.
+email:
+- eduardo@eduardosouza.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/pushpay.rb
+- lib/pushpay/anticipated_payment.rb
+- lib/pushpay/base.rb
+- lib/pushpay/batch.rb
+- lib/pushpay/client.rb
+- lib/pushpay/configuration.rb
+- lib/pushpay/errors.rb
+- lib/pushpay/fund.rb
+- lib/pushpay/merchant.rb
+- lib/pushpay/organization.rb
+- lib/pushpay/payment.rb
+- lib/pushpay/recurring_payment.rb
+- lib/pushpay/settlement.rb
+- lib/pushpay/version.rb
+- lib/pushpay/webhook.rb
+- spec/examples.txt
+- spec/pushpay/anticipated_payment_spec.rb
+- spec/pushpay/batch_spec.rb
+- spec/pushpay/client_spec.rb
+- spec/pushpay/configuration_spec.rb
+- spec/pushpay/fund_spec.rb
+- spec/pushpay/merchant_spec.rb
+- spec/pushpay/organization_spec.rb
+- spec/pushpay/payment_spec.rb
+- spec/pushpay/recurring_payment_spec.rb
+- spec/pushpay/settlement_spec.rb
+- spec/pushpay/webhook_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/esouza/pushpay-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/esouza/pushpay-ruby
+  source_code_uri: https://github.com/esouza/pushpay-ruby
+  changelog_uri: https://github.com/esouza/pushpay-ruby/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.21
+signing_key:
+specification_version: 4
+summary: Ruby gem for PushPay payment API integration
+test_files: []