billingio 1.0.0 → 2.0.0

data/lib/billingio/resources/payout_intents.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module BillingIO
+  # Provides access to payout intent endpoints.
+  #
+  #   client.payout_intents.create(amount_usd: 500.00, chain: "tron", token: "USDT", destination: "T...")
+  #   client.payout_intents.list
+  #   client.payout_intents.update("po_abc123", metadata: { "ref" => "inv_001" })
+  #   client.payout_intents.execute("po_abc123")
+  class PayoutIntents
+    # @api private
+    def initialize(http_client)
+      @http = http_client
+    end
+
+    # Create a new payout intent.
+    #
+    # @param amount_usd  [Float]       payout amount in USD
+    # @param chain       [String]      blockchain network
+    # @param token       [String]      stablecoin token
+    # @param destination [String]      destination wallet address
+    # @param metadata    [Hash, nil]   arbitrary key-value pairs
+    # @return [BillingIO::PayoutIntent]
+    # @raise [BillingIO::Error]
+    def create(amount_usd:, chain:, token:, destination:, metadata: nil)
+      body = {
+        "amount_usd"  => amount_usd,
+        "chain"       => chain,
+        "token"       => token,
+        "destination" => destination
+      }
+      body["metadata"] = metadata if metadata
+
+      data = @http.post("/payouts", body)
+      PayoutIntent.from_hash(data)
+    end
+
+    # List payout intents with cursor-based pagination.
+    #
+    # @param cursor [String, nil] opaque cursor for the next page
+    # @param limit  [Integer]     items per page (1..100, default 25)
+    # @param status [String, nil] filter by payout status
+    # @return [BillingIO::PaginatedList<BillingIO::PayoutIntent>]
+    # @raise [BillingIO::Error]
+    def list(cursor: nil, limit: 25, status: nil)
+      params = { limit: limit }
+      params[:cursor] = cursor if cursor
+      params[:status] = status if status
+
+      data = @http.get("/payouts", params)
+      PaginatedList.from_hash(data, PayoutIntent)
+    end
+
+    # Update an existing payout intent.
+    #
+    # @param payout_id [String]    payout identifier (prefixed +po_+)
+    # @param metadata  [Hash, nil] new metadata (replaces existing)
+    # @return [BillingIO::PayoutIntent]
+    # @raise [BillingIO::Error]
+    def update(payout_id, metadata: nil)
+      body = {}
+      body["metadata"] = metadata if metadata
+
+      data = @http.patch("/payouts/#{payout_id}", body)
+      PayoutIntent.from_hash(data)
+    end
+
+    # Execute a payout intent (trigger the on-chain transfer).
+    #
+    # @param payout_id [String] payout identifier (prefixed +po_+)
+    # @return [BillingIO::PayoutIntent]
+    # @raise [BillingIO::Error]
+    def execute(payout_id)
+      data = @http.post("/payouts/#{payout_id}/execute")
+      PayoutIntent.from_hash(data)
+    end
+  end
+end

data/lib/billingio/resources/revenue_events.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module BillingIO
+  # Provides access to revenue event and accounting endpoints.
+  #
+  #   client.revenue_events.list(type: "payment")
+  #   client.revenue_events.accounting(period_start: "2025-01-01", period_end: "2025-01-31")
+  class RevenueEvents
+    # @api private
+    def initialize(http_client)
+      @http = http_client
+    end
+
+    # List revenue events with cursor-based pagination.
+    #
+    # @param cursor      [String, nil] opaque cursor for the next page
+    # @param limit       [Integer]     items per page (1..100, default 25)
+    # @param type        [String, nil] filter by event type
+    # @param customer_id [String, nil] filter by customer
+    # @return [BillingIO::PaginatedList<BillingIO::RevenueEvent>]
+    # @raise [BillingIO::Error]
+    def list(cursor: nil, limit: 25, type: nil, customer_id: nil)
+      params = { limit: limit }
+      params[:cursor]      = cursor      if cursor
+      params[:type]        = type        if type
+      params[:customer_id] = customer_id if customer_id
+
+      data = @http.get("/revenue/events", params)
+      PaginatedList.from_hash(data, RevenueEvent)
+    end
+
+    # Retrieve an accounting summary report.
+    #
+    # @param period_start [String, nil] ISO-8601 period start date
+    # @param period_end   [String, nil] ISO-8601 period end date
+    # @return [BillingIO::AccountingReport]
+    # @raise [BillingIO::Error]
+    def accounting(period_start: nil, period_end: nil)
+      params = {}
+      params[:period_start] = period_start if period_start
+      params[:period_end]   = period_end   if period_end
+
+      data = @http.get("/revenue/accounting", params)
+      AccountingReport.from_hash(data)
+    end
+  end
+end

data/lib/billingio/resources/settlements.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module BillingIO
+  # Provides access to payout settlement endpoints.
+  #
+  #   client.settlements.list
+  #   client.settlements.list(payout_id: "po_abc123")
+  class Settlements
+    # @api private
+    def initialize(http_client)
+      @http = http_client
+    end
+
+    # List settlements with cursor-based pagination.
+    #
+    # @param cursor    [String, nil] opaque cursor for the next page
+    # @param limit     [Integer]     items per page (1..100, default 25)
+    # @param payout_id [String, nil] filter by payout intent
+    # @return [BillingIO::PaginatedList<BillingIO::Settlement>]
+    # @raise [BillingIO::Error]
+    def list(cursor: nil, limit: 25, payout_id: nil)
+      params = { limit: limit }
+      params[:cursor]    = cursor    if cursor
+      params[:payout_id] = payout_id if payout_id
+
+      data = @http.get("/payouts/settlements", params)
+      PaginatedList.from_hash(data, Settlement)
+    end
+  end
+end

data/lib/billingio/resources/subscription_plans.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module BillingIO
+  # Provides access to subscription plan management endpoints.
+  #
+  #   client.subscription_plans.create(name: "Pro", amount_usd: 29.99, interval: "monthly")
+  #   client.subscription_plans.list
+  #   client.subscription_plans.update("plan_abc123", name: "Pro Plus")
+  class SubscriptionPlans
+    # @api private
+    def initialize(http_client)
+      @http = http_client
+    end
+
+    # Create a new subscription plan.
+    #
+    # @param name           [String]      human-readable plan name
+    # @param amount_usd     [Float]       recurring amount in USD
+    # @param interval       [String]      billing interval (e.g. "monthly", "yearly")
+    # @param interval_count [Integer]     number of intervals between billings (default 1)
+    # @param chain          [String, nil] blockchain network
+    # @param token          [String, nil] stablecoin token
+    # @param metadata       [Hash, nil]   arbitrary key-value pairs
+    # @return [BillingIO::SubscriptionPlan]
+    # @raise [BillingIO::Error]
+    def create(name:, amount_usd:, interval:, interval_count: 1, chain: nil, token: nil, metadata: nil)
+      body = {
+        "name"           => name,
+        "amount_usd"     => amount_usd,
+        "interval"       => interval,
+        "interval_count" => interval_count
+      }
+      body["chain"]    = chain    if chain
+      body["token"]    = token    if token
+      body["metadata"] = metadata if metadata
+
+      data = @http.post("/subscriptions/plans", body)
+      SubscriptionPlan.from_hash(data)
+    end
+
+    # List subscription plans with cursor-based pagination.
+    #
+    # @param cursor [String, nil] opaque cursor for the next page
+    # @param limit  [Integer]     items per page (1..100, default 25)
+    # @return [BillingIO::PaginatedList<BillingIO::SubscriptionPlan>]
+    # @raise [BillingIO::Error]
+    def list(cursor: nil, limit: 25)
+      params = { limit: limit }
+      params[:cursor] = cursor if cursor
+
+      data = @http.get("/subscriptions/plans", params)
+      PaginatedList.from_hash(data, SubscriptionPlan)
+    end
+
+    # Update an existing subscription plan.
+    #
+    # @param plan_id  [String]      plan identifier (prefixed +plan_+)
+    # @param name     [String, nil] new plan name
+    # @param metadata [Hash, nil]   new metadata (replaces existing)
+    # @return [BillingIO::SubscriptionPlan]
+    # @raise [BillingIO::Error]
+    def update(plan_id, name: nil, metadata: nil)
+      body = {}
+      body["name"]     = name     if name
+      body["metadata"] = metadata if metadata
+
+      data = @http.patch("/subscriptions/plans/#{plan_id}", body)
+      SubscriptionPlan.from_hash(data)
+    end
+  end
+end

data/lib/billingio/resources/subscription_renewals.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module BillingIO
+  # Provides access to subscription renewal endpoints.
+  #
+  #   client.subscription_renewals.list(subscription_id: "sub_abc123")
+  #   client.subscription_renewals.retry("ren_abc123")
+  class SubscriptionRenewals
+    # @api private
+    def initialize(http_client)
+      @http = http_client
+    end
+
+    # List subscription renewals with cursor-based pagination.
+    #
+    # @param cursor          [String, nil] opaque cursor for the next page
+    # @param limit           [Integer]     items per page (1..100, default 25)
+    # @param subscription_id [String, nil] filter by subscription
+    # @param status          [String, nil] filter by renewal status
+    # @return [BillingIO::PaginatedList<BillingIO::SubscriptionRenewal>]
+    # @raise [BillingIO::Error]
+    def list(cursor: nil, limit: 25, subscription_id: nil, status: nil)
+      params = { limit: limit }
+      params[:cursor]          = cursor          if cursor
+      params[:subscription_id] = subscription_id if subscription_id
+      params[:status]          = status          if status
+
+      data = @http.get("/subscriptions/renewals", params)
+      PaginatedList.from_hash(data, SubscriptionRenewal)
+    end
+
+    # Retry a failed renewal.
+    #
+    # @param renewal_id [String] renewal identifier (prefixed +ren_+)
+    # @return [BillingIO::SubscriptionRenewal]
+    # @raise [BillingIO::Error]
+    def retry(renewal_id)
+      data = @http.post("/subscriptions/renewals/#{renewal_id}/retry")
+      SubscriptionRenewal.from_hash(data)
+    end
+  end
+end

data/lib/billingio/resources/subscriptions.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module BillingIO
+  # Provides access to subscription management endpoints.
+  #
+  #   client.subscriptions.create(customer_id: "cus_abc123", plan_id: "plan_abc123")
+  #   client.subscriptions.list
+  #   client.subscriptions.update("sub_abc123", metadata: { "tier" => "premium" })
+  class Subscriptions
+    # @api private
+    def initialize(http_client)
+      @http = http_client
+    end
+
+    # Create a new subscription.
+    #
+    # @param customer_id [String]    customer identifier
+    # @param plan_id     [String]    plan identifier
+    # @param metadata    [Hash, nil] arbitrary key-value pairs
+    # @return [BillingIO::Subscription]
+    # @raise [BillingIO::Error]
+    def create(customer_id:, plan_id:, metadata: nil)
+      body = {
+        "customer_id" => customer_id,
+        "plan_id"     => plan_id
+      }
+      body["metadata"] = metadata if metadata
+
+      data = @http.post("/subscriptions", body)
+      Subscription.from_hash(data)
+    end
+
+    # List subscriptions with cursor-based pagination.
+    #
+    # @param cursor      [String, nil] opaque cursor for the next page
+    # @param limit       [Integer]     items per page (1..100, default 25)
+    # @param customer_id [String, nil] filter by customer
+    # @param status      [String, nil] filter by subscription status
+    # @return [BillingIO::PaginatedList<BillingIO::Subscription>]
+    # @raise [BillingIO::Error]
+    def list(cursor: nil, limit: 25, customer_id: nil, status: nil)
+      params = { limit: limit }
+      params[:cursor]      = cursor      if cursor
+      params[:customer_id] = customer_id if customer_id
+      params[:status]      = status      if status
+
+      data = @http.get("/subscriptions", params)
+      PaginatedList.from_hash(data, Subscription)
+    end
+
+    # Update an existing subscription.
+    #
+    # @param subscription_id [String]      subscription identifier (prefixed +sub_+)
+    # @param status          [String, nil] new status (e.g. "canceled")
+    # @param metadata        [Hash, nil]   new metadata (replaces existing)
+    # @return [BillingIO::Subscription]
+    # @raise [BillingIO::Error]
+    def update(subscription_id, status: nil, metadata: nil)
+      body = {}
+      body["status"]   = status   if status
+      body["metadata"] = metadata if metadata
+
+      data = @http.patch("/subscriptions/#{subscription_id}", body)
+      Subscription.from_hash(data)
+    end
+  end
+end

data/lib/billingio/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BillingIO
-  VERSION = "1.0.0"
+  VERSION = "2.0.0"
 end

data/lib/billingio.rb

@@ -15,11 +15,35 @@ require_relative "billingio/models/webhook_endpoint"
 require_relative "billingio/models/event"
 require_relative "billingio/models/health_response"
 require_relative "billingio/models/paginated_list"
+require_relative "billingio/models/customer"
+require_relative "billingio/models/payment_method"
+require_relative "billingio/models/payment_link"
+require_relative "billingio/models/subscription_plan"
+require_relative "billingio/models/subscription"
+require_relative "billingio/models/subscription_renewal"
+require_relative "billingio/models/entitlement"
+require_relative "billingio/models/entitlement_check"
+require_relative "billingio/models/payout_intent"
+require_relative "billingio/models/settlement"
+require_relative "billingio/models/revenue_event"
+require_relative "billingio/models/accounting_report"
+require_relative "billingio/models/adjustment"
 
 # Resources
 require_relative "billingio/resources/checkouts"
 require_relative "billingio/resources/webhooks"
 require_relative "billingio/resources/events"
 require_relative "billingio/resources/health"
+require_relative "billingio/resources/customers"
+require_relative "billingio/resources/payment_methods"
+require_relative "billingio/resources/payment_links"
+require_relative "billingio/resources/subscription_plans"
+require_relative "billingio/resources/subscriptions"
+require_relative "billingio/resources/subscription_renewals"
+require_relative "billingio/resources/entitlements"
+require_relative "billingio/resources/payout_intents"
+require_relative "billingio/resources/settlements"
+require_relative "billingio/resources/revenue_events"
+require_relative "billingio/resources/adjustments"
 
 require_relative "billingio/client"

metadata

@@ -1,18 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: billingio
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.0.0
 platform: ruby
 authors:
 - billing.io
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-30 00:00:00.000000000 Z
+date: 2026-02-03 00:00:00.000000000 Z
 dependencies: []
-description: Official Ruby client for billing.io -- non-custodial crypto payment checkouts
-  with stablecoin settlement. Create checkouts, manage webhooks, verify signatures,
-  and query event history.
+description: Official Ruby client for billing.io -- non-custodial crypto payments
+  with stablecoin settlement. Manage customers, checkouts, subscriptions, payouts,
+  revenue tracking, entitlements, webhooks, and more.
 email:
 - support@billing.io
 executables: []
@@ -26,15 +26,39 @@ files:
 - lib/billingio/client.rb
 - lib/billingio/errors.rb
 - lib/billingio/http_client.rb
+- lib/billingio/models/accounting_report.rb
+- lib/billingio/models/adjustment.rb
 - lib/billingio/models/checkout.rb
 - lib/billingio/models/checkout_status.rb
+- lib/billingio/models/customer.rb
+- lib/billingio/models/entitlement.rb
+- lib/billingio/models/entitlement_check.rb
 - lib/billingio/models/event.rb
 - lib/billingio/models/health_response.rb
 - lib/billingio/models/paginated_list.rb
+- lib/billingio/models/payment_link.rb
+- lib/billingio/models/payment_method.rb
+- lib/billingio/models/payout_intent.rb
+- lib/billingio/models/revenue_event.rb
+- lib/billingio/models/settlement.rb
+- lib/billingio/models/subscription.rb
+- lib/billingio/models/subscription_plan.rb
+- lib/billingio/models/subscription_renewal.rb
 - lib/billingio/models/webhook_endpoint.rb
+- lib/billingio/resources/adjustments.rb
 - lib/billingio/resources/checkouts.rb
+- lib/billingio/resources/customers.rb
+- lib/billingio/resources/entitlements.rb
 - lib/billingio/resources/events.rb
 - lib/billingio/resources/health.rb
+- lib/billingio/resources/payment_links.rb
+- lib/billingio/resources/payment_methods.rb
+- lib/billingio/resources/payout_intents.rb
+- lib/billingio/resources/revenue_events.rb
+- lib/billingio/resources/settlements.rb
+- lib/billingio/resources/subscription_plans.rb
+- lib/billingio/resources/subscription_renewals.rb
+- lib/billingio/resources/subscriptions.rb
 - lib/billingio/resources/webhooks.rb
 - lib/billingio/version.rb
 - lib/billingio/webhook.rb
@@ -66,5 +90,5 @@ requirements: []
 rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
-summary: Ruby SDK for the billing.io crypto checkout API
+summary: Ruby SDK for the billing.io payments platform
 test_files: []