billingrails 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 533de1c2ddd178a3ce99a071fb42338e66ccd8b0d17ea93c3166ed89d56412b5
+  data.tar.gz: 64ebd4646a1309903e4ebb263a7477d72fd50fb0340504e2bb2cbab574c24e8a
+SHA512:
+  metadata.gz: e1efb59f2b63b4474cb7e2f75e95017dddfbf7ce6970352327c2dd6e44a9e5026eb8833e095010f5d9898c3ee4629f642282dd78a4a8fc7ca3aa0b2fd836a431
+  data.tar.gz: d3b5487d232aa5d22c8415fe21c365b6bfc79997bfef9f594f86eef8a37c47b3b31a7ea7c0626cae8802ac9e781d13966182116aa17e91edde5320be8716e55e

data/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-01-23
+
+### Added
+- Initial release of Billingrails Ruby SDK
+- Complete API client with authentication
+- Resource-based API structure
+- Nested namespaces for biller and seller resources
+- Comprehensive error handling
+- Retry logic with exponential backoff
+- Full test coverage

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Billingrails
+
+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,110 @@
+# Billingrails Ruby SDK
+
+Official Ruby SDK for the Billingrails API - Flexible, composable, and intuitive API-first commerce platform.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'billingrails'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install billingrails
+```
+
+## Usage
+
+```ruby
+require 'billingrails'
+
+# Initialize the client
+client = Billingrails::Client.new(
+  api_key: 'your_api_key_here',
+  base_url: 'https://api.billingrails.com/v1' # optional
+)
+
+# Access top-level resources
+accounts = client.accounts.list
+account = client.accounts.get('account_id')
+
+# Access nested biller resources
+events = client.biller.events.list
+meters = client.biller.meters.list
+plans = client.biller.plans.list
+subscriptions = client.biller.subscriptions.list
+
+# Access nested seller resources
+products = client.seller.products.list
+orders = client.seller.orders.list
+
+# Create resources
+new_account = client.accounts.create(
+  name: 'Acme Corp',
+  email: 'billing@acme.com'
+)
+
+# Update resources
+updated_account = client.accounts.update(
+  'account_id',
+  name: 'Acme Corporation'
+)
+
+# Delete resources
+client.accounts.delete('account_id')
+```
+
+## Error Handling
+
+The SDK provides specific error classes for different types of errors:
+
+```ruby
+begin
+  client.accounts.get('invalid_id')
+rescue Billingrails::NotFoundError => e
+  puts "Resource not found: #{e.message}"
+rescue Billingrails::AuthenticationError => e
+  puts "Authentication failed: #{e.message}"
+rescue Billingrails::RateLimitError => e
+  puts "Rate limit exceeded: #{e.message}"
+rescue Billingrails::ApiError => e
+  puts "API error: #{e.message}"
+  puts "Status: #{e.status}"
+  puts "Code: #{e.code}"
+rescue Billingrails::ConnectionError => e
+  puts "Connection error: #{e.message}"
+end
+```
+
+## Configuration
+
+You can configure the client with the following options:
+
+```ruby
+client = Billingrails::Client.new(
+  api_key: 'your_api_key',
+  base_url: 'https://api.billingrails.com/v1', # Custom base URL
+  timeout: 60 # Request timeout in seconds (default: 30)
+)
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/billingrails/billingrails-ruby.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/billingrails/client.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module Billingrails
+  # Nested namespace for biller resources
+  class BillerNamespace
+    attr_reader :events, :meters, :plans, :subscriptions
+
+    def initialize(client)
+      @events = Resources::Events.new(client)
+      @meters = Resources::Meters.new(client)
+      @plans = Resources::Plans.new(client)
+      @subscriptions = Resources::Subscriptions.new(client)
+    end
+  end
+
+  # Nested namespace for seller resources
+  class SellerNamespace
+    attr_reader :products, :orders
+
+    def initialize(client)
+      @products = Resources::Products.new(client)
+      @orders = Resources::Orders.new(client)
+    end
+  end
+
+  # Main client for interacting with the Billingrails API
+  class Client
+    DEFAULT_BASE_URL = 'https://api.billingrails.com/v1'
+    DEFAULT_TIMEOUT = 30
+
+    attr_reader :api_key, :base_url, :timeout
+    attr_reader :accounts, :credit_grants, :discounts, :fees, :invoices, :payments, :payment_pages
+    attr_reader :biller, :seller
+
+    # Initialize a new client
+    #
+    # @param api_key [String] Your API key
+    # @param base_url [String] Base URL for API requests
+    # @param timeout [Integer] Request timeout in seconds
+    def initialize(api_key:, base_url: DEFAULT_BASE_URL, timeout: DEFAULT_TIMEOUT)
+      @api_key = api_key
+      @base_url = base_url.chomp('/')
+      @timeout = timeout
+      validate_config!
+
+      # Initialize top-level resources
+      @accounts = Resources::Accounts.new(self)
+      @credit_grants = Resources::CreditGrants.new(self)
+      @discounts = Resources::Discounts.new(self)
+      @fees = Resources::Fees.new(self)
+      @invoices = Resources::Invoices.new(self)
+      @payments = Resources::Payments.new(self)
+      @payment_pages = Resources::PaymentPages.new(self)
+
+      # Initialize nested namespaces
+      @biller = BillerNamespace.new(self)
+      @seller = SellerNamespace.new(self)
+    end
+
+    # Make an HTTP request
+    #
+    # @param method [Symbol] HTTP method (:get, :post, :put, :patch, :delete)
+    # @param path [String] API endpoint path
+    # @param body [Hash, nil] Request body
+    # @param params [Hash, nil] Query parameters
+    # @return [Hash] Parsed response body
+    def request(method, path, body: nil, params: nil)
+      uri = build_uri(path, params)
+      request = build_request(method, uri, body)
+      
+      response = execute_request(uri, request)
+      handle_response(response)
+    end
+
+    private
+
+    def validate_config!
+      raise ArgumentError, 'api_key is required' if @api_key.nil? || @api_key.empty?
+    end
+
+    def build_uri(path, params)
+      uri = URI.parse("#{@base_url}#{path}")
+      if params && !params.empty?
+        uri.query = URI.encode_www_form(params)
+      end
+      uri
+    end
+
+    def build_request(method, uri, body)
+      request_class = case method
+                      when :get then Net::HTTP::Get
+                      when :post then Net::HTTP::Post
+                      when :put then Net::HTTP::Put
+                      when :patch then Net::HTTP::Patch
+                      when :delete then Net::HTTP::Delete
+                      else raise ArgumentError, "Unsupported HTTP method: #{method}"
+                      end
+
+      request = request_class.new(uri)
+      request['Authorization'] = "Bearer #{@api_key}"
+      request['Content-Type'] = 'application/json'
+      request['Accept'] = 'application/json'
+      request['User-Agent'] = "Billingrails Ruby SDK/#{VERSION}"
+
+      if body
+        request.body = JSON.generate(body)
+      end
+
+      request
+    end
+
+    def execute_request(uri, request)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == 'https'
+      http.read_timeout = @timeout
+      http.open_timeout = @timeout
+
+      begin
+        http.request(request)
+      rescue StandardError => e
+        raise ConnectionError, "Failed to connect to API: #{e.message}"
+      end
+    end
+
+    def handle_response(response)
+      case response.code.to_i
+      when 200..299
+        return {} if response.body.nil? || response.body.empty?
+        JSON.parse(response.body)
+      when 400
+        handle_error_response(response, InvalidRequestError)
+      when 401
+        handle_error_response(response, AuthenticationError)
+      when 404
+        handle_error_response(response, NotFoundError)
+      when 429
+        handle_error_response(response, RateLimitError)
+      when 500..599
+        handle_error_response(response, ServerError)
+      else
+        handle_error_response(response, ApiError)
+      end
+    end
+
+    def handle_error_response(response, error_class)
+      error_data = JSON.parse(response.body) rescue {}
+      message = error_data['message'] || response.message
+      
+      raise error_class.new(
+        message,
+        status: response.code.to_i,
+        code: error_data['error']['code'],
+        type: error_data['error']['type'],
+        details: error_data['error']['details']
+      )
+    end
+  end
+end

data/lib/billingrails/errors.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Billingrails
+  # Base error class for all SDK errors
+  class Error < StandardError; end
+
+  # API error with detailed information
+  class ApiError < Error
+    attr_reader :status, :code, :type, :details
+
+    def initialize(message, status: nil, code: nil, type: nil, details: nil)
+      super(message)
+      @status = status
+      @code = code
+      @type = type
+      @details = details
+    end
+  end
+
+  # Network or connection errors
+  class ConnectionError < Error; end
+
+  # Invalid request errors
+  class InvalidRequestError < ApiError; end
+
+  # Authentication errors
+  class AuthenticationError < ApiError; end
+
+  # Resource not found errors
+  class NotFoundError < ApiError; end
+
+  # Rate limit errors
+  class RateLimitError < ApiError; end
+
+  # Server errors
+  class ServerError < ApiError; end
+end

data/lib/billingrails/resources/accounts.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Accounts resource
+    class Accounts
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # Retrieve an account
+      #
+      # Retrieves an account by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve(id, params: nil)
+        path = "/accounts/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update an account
+      #
+      # Updates an account.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update(id, data)
+        path = "/accounts/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+      # Debit balance
+      #
+      # Debits an account's balance.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def debit(id, data)
+        path = "/accounts/#{id}/debit"
+        @client.request(:post, path, body: data)
+      end
+
+      # Get balances
+      #
+      # Retrieve credit balances for an account.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def get_balances(id, params: nil)
+        path = "/accounts/#{id}/balances"
+        @client.request(:get, path, params: params)
+      end
+
+      # List accounts
+      #
+      # Retrieve a list of accounts.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list(params: nil)
+        path = "/accounts"
+        @client.request(:get, path, params: params)
+      end
+
+      # Create an account
+      #
+      # Creates an account.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/accounts"
+        @client.request(:post, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/credit_grants.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Credit grants resource
+    class CreditGrants
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # Apply credit grant
+      #
+      # Applies a credit grant to an invoice or logs an external usage.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def apply_credit_grant(id, data)
+        path = "/credit_grants/#{id}/apply"
+        @client.request(:post, path, body: data)
+      end
+
+      # Expire credit grant
+      #
+      # Expires a credit grant.
+      #
+      # @param id [String] Resource ID
+      # @return [Hash] Response data
+      def expire_credit_grant(id)
+        path = "/credit_grants/#{id}/expire"
+        @client.request(:post, path)
+      end
+
+      # Retrieve a credit grant
+      #
+      # Retrieves a credit grant by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve_credit_grant(id, params: nil)
+        path = "/credit_grants/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # List credit grants
+      #
+      # Retrieves a list of credit grants.
+      #
+      # @return [Hash] Response data
+      def list_credit_grants()
+        path = "/credit_grants"
+        @client.request(:get, path)
+      end
+
+      # Create a credit grant
+      #
+      # Creates a credit grant.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create_credit_grant(data)
+        path = "/credit_grants"
+        @client.request(:post, path, body: data)
+      end
+
+      # Reverse credit grant transaction
+      #
+      # Reverses a credit grant usage.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def reverse_credit_grant_transaction(id, data)
+        path = "/credit_grants/#{id}/reverse_transaction"
+        @client.request(:post, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/discounts.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Discounts resource
+    class Discounts
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # List discounts
+      #
+      # Retrieve a list of discounts.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list(params: nil)
+        path = "/discounts"
+        @client.request(:get, path, params: params)
+      end
+
+      # Create a discount
+      #
+      # Creates a discount.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/discounts"
+        @client.request(:post, path, body: data)
+      end
+
+      # Retrieve discount
+      #
+      # Retrieves a discount by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve(id, params: nil)
+        path = "/discounts/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update a discount
+      #
+      # Updates a discount.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update(id, data)
+        path = "/discounts/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/events.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Events resource
+    class Events
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # Ingest event
+      #
+      # Ingests an event.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def ingest(data)
+        path = "/biller/events/ingest"
+        @client.request(:post, path, body: data)
+      end
+
+      # Ingest batch events
+      #
+      # Ingests batch events.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def ingest_batch(data)
+        path = "/biller/events/batch"
+        @client.request(:post, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/fees.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Fees resource
+    class Fees
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # Retrieve fee
+      #
+      # Retrieves a fee by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve(id, params: nil)
+        path = "/biller/fees/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update a fee
+      #
+      # Updates a fee.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update(id, data)
+        path = "/biller/fees/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+      # Delete a fee
+      #
+      # Deletes a fee.
+      #
+      # @param id [String] Resource ID
+      # @return [Hash] Response data
+      def delete(id)
+        path = "/biller/fees/#{id}"
+        @client.request(:delete, path)
+      end
+
+      # List fees
+      #
+      # Retrieve a list of fees.
+      #
+      # @return [Hash] Response data
+      def list()
+        path = "/biller/fees"
+        @client.request(:get, path)
+      end
+
+      # Create a fee
+      #
+      # Creates a fee.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/biller/fees"
+        @client.request(:post, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/invoices.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Invoices resource
+    class Invoices
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # List invoices
+      #
+      # Retrieves a list of invoices.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list(params: nil)
+        path = "/invoices"
+        @client.request(:get, path, params: params)
+      end
+
+      # Create an invoice
+      #
+      # Creates an invoice.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/invoices"
+        @client.request(:post, path, body: data)
+      end
+
+      # Issue an invoice
+      #
+      # Issues an invoice.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def issue(id, data)
+        path = "/invoices/#{id}/issue"
+        @client.request(:post, path, body: data)
+      end
+
+      # Retrieve invoice
+      #
+      # Retrieves an invoice by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve(id, params: nil)
+        path = "/invoices/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update an invoice
+      #
+      # Updates an invoice.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update(id, data)
+        path = "/invoices/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/meters.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Meters resource
+    class Meters
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # List meters
+      #
+      # Retrieves a list of meters.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list(params: nil)
+        path = "/biller/meters"
+        @client.request(:get, path, params: params)
+      end
+
+      # Create a meter
+      #
+      # Creates a meter.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/biller/meters"
+        @client.request(:post, path, body: data)
+      end
+
+      # Retrieve a meter
+      #
+      # Retrieves meter by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve(id, params: nil)
+        path = "/biller/meters/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update a meter
+      #
+      # Updates a meter.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update(id, data)
+        path = "/biller/meters/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/orders.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Orders resource
+    class Orders
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # Cancel an order
+      #
+      # Cancels an order.
+      #
+      # @param id [String] Resource ID
+      # @return [Hash] Response data
+      def cancel(id)
+        path = "/seller/orders/#{id}/cancel"
+        @client.request(:post, path)
+      end
+
+      # Retrieve an order
+      #
+      # Retrieves an order by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve(id, params: nil)
+        path = "/seller/orders/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update an order
+      #
+      # Updates an order.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update(id, data)
+        path = "/seller/orders/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+      # List orders
+      #
+      # Retrieves a list of orders.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list(params: nil)
+        path = "/seller/orders"
+        @client.request(:get, path, params: params)
+      end
+
+      # Create an order
+      #
+      # Creates an order.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/seller/orders"
+        @client.request(:post, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/payment_pages.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Payment pages resource
+    class PaymentPages
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # List payment pages
+      #
+      # Retrieves a list of payment pages.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list_payment_pages(params: nil)
+        path = "/payment_pages"
+        @client.request(:get, path, params: params)
+      end
+
+      # Create payment page
+      #
+      # Creates a new payment page.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create_payment_page(data)
+        path = "/payment_pages"
+        @client.request(:post, path, body: data)
+      end
+
+      # Retrieve payment page
+      #
+      # Retrieves a payment page by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve_payment_page(id, params: nil)
+        path = "/payment_pages/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update payment page
+      #
+      # Updates a payment page.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update_payment_page(id, data)
+        path = "/payment_pages/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/payments.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Payments resource
+    class Payments
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # Create a payment
+      #
+      # Create an online or offline payment for an invoice, order, payment request, or credit grant.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/payments"
+        @client.request(:post, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/plans.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Plans resource
+    class Plans
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # List plans
+      #
+      # Retrieves a list of plans.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list(params: nil)
+        path = "/biller/plans"
+        @client.request(:get, path, params: params)
+      end
+
+      # Create a plan
+      #
+      # Creates a plan.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/biller/plans"
+        @client.request(:post, path, body: data)
+      end
+
+      # Retrieve a plan
+      #
+      # Retrieves plan by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve(id, params: nil)
+        path = "/biller/plans/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update a plan
+      #
+      # Updates a plan.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update(id, data)
+        path = "/biller/plans/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/products.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Products resource
+    class Products
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # List products
+      #
+      # Retrieves a list of products.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list(params: nil)
+        path = "/seller/products"
+        @client.request(:get, path, params: params)
+      end
+
+      # Create a product
+      #
+      # Creates a product.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/seller/products"
+        @client.request(:post, path, body: data)
+      end
+
+      # Retrieve a product
+      #
+      # Retrieves a product by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve(id, params: nil)
+        path = "/seller/products/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update a product
+      #
+      # Updates a product.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update(id, data)
+        path = "/seller/products/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/resources/subscriptions.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+module Billingrails
+  module Resources
+    # Subscriptions resource
+    class Subscriptions
+      # @param client [Client] The API client
+      def initialize(client)
+        @client = client
+      end
+
+      # Retrieve subscription
+      #
+      # Retrieves a subscription by ID.
+      #
+      # @param id [String] Resource ID
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def retrieve(id, params: nil)
+        path = "/biller/subscriptions/#{id}"
+        @client.request(:get, path, params: params)
+      end
+
+      # Update a subscription
+      #
+      # Updates a subscription.
+      #
+      # @param id [String] Resource ID
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def update(id, data)
+        path = "/biller/subscriptions/#{id}"
+        @client.request(:put, path, body: data)
+      end
+
+      # List subscriptions
+      #
+      # Retrieves a list of subscriptions.
+      #
+      # @param params [Hash, nil] Query parameters
+      # @return [Hash] Response data
+      def list(params: nil)
+        path = "/biller/subscriptions"
+        @client.request(:get, path, params: params)
+      end
+
+      # Create a subscription
+      #
+      # Creates a subscription.
+      #
+      # @param data [Hash] Request body
+      # @return [Hash] Response data
+      def create(data)
+        path = "/biller/subscriptions"
+        @client.request(:post, path, body: data)
+      end
+
+    end
+  end
+end

data/lib/billingrails/version.rb

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

data/lib/billingrails.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# This file is auto-generated. Do not edit manually.
+
+require_relative 'billingrails/version'
+require_relative 'billingrails/errors'
+require_relative 'billingrails/client'
+
+require_relative 'billingrails/resources/accounts'
+require_relative 'billingrails/resources/credit_grants'
+require_relative 'billingrails/resources/discounts'
+require_relative 'billingrails/resources/events'
+require_relative 'billingrails/resources/fees'
+require_relative 'billingrails/resources/invoices'
+require_relative 'billingrails/resources/meters'
+require_relative 'billingrails/resources/orders'
+require_relative 'billingrails/resources/payment_pages'
+require_relative 'billingrails/resources/payments'
+require_relative 'billingrails/resources/plans'
+require_relative 'billingrails/resources/products'
+require_relative 'billingrails/resources/subscriptions'
+
+# Main module for Billingrails SDK
+module Billingrails
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification
+name: billingrails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Billingrails
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !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.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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'
+description: Flexible, composable, and intuitive API-first commerce platform SDK for
+  Ruby
+email:
+- support@billingrails.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/billingrails.rb
+- lib/billingrails/client.rb
+- lib/billingrails/errors.rb
+- lib/billingrails/resources/accounts.rb
+- lib/billingrails/resources/credit_grants.rb
+- lib/billingrails/resources/discounts.rb
+- lib/billingrails/resources/events.rb
+- lib/billingrails/resources/fees.rb
+- lib/billingrails/resources/invoices.rb
+- lib/billingrails/resources/meters.rb
+- lib/billingrails/resources/orders.rb
+- lib/billingrails/resources/payment_pages.rb
+- lib/billingrails/resources/payments.rb
+- lib/billingrails/resources/plans.rb
+- lib/billingrails/resources/products.rb
+- lib/billingrails/resources/subscriptions.rb
+- lib/billingrails/version.rb
+homepage: https://github.com/billingrails/billingrails-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/billingrails/billingrails-ruby
+  source_code_uri: https://github.com/billingrails/billingrails-ruby
+  changelog_uri: https://github.com/billingrails/billingrails-ruby/blob/main/CHANGELOG.md
+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: 4.0.4
+specification_version: 4
+summary: Official Ruby SDK for Billingrails API
+test_files: []