perata-sdk 0.2.0 → 0.3.0

data/lib/perata/models.rb

@@ -3,14 +3,86 @@
 # Code generated by sdk/generator. DO NOT EDIT.
 
 module Perata
+  # Benefit is a resource of Peráta's API.
+  class Benefit < Model
+    MEMBERS = %i[created_at description id metadata modified_at name properties status type visibility].freeze
+
+    # @return [String]
+    attr_reader :created_at
+
+    # @return [String]
+    attr_reader :description
+
+    # @return [String]
+    attr_reader :id
+
+    # Metadados do lojista: pares chave e valor (texto, número ou booleano); no tipo feature_flag, os valores da flag.
+    # @return [Hash{String => Object}]
+    attr_reader :metadata
+
+    # @return [String]
+    attr_reader :modified_at
+
+    # Como o benefício aparece nos produtos e para o cliente.
+    # @return [String]
+    attr_reader :name
+
+    # Os campos do tipo do benefício.
+    # @return [Hash{String => Object}]
+    attr_reader :properties
+
+    # @return [String ("active", "archived")]
+    attr_reader :status
+
+    # @return [String ("custom", "license_key", "downloadable", "feature_flag", "meter_credit", "discord", "github_repository")]
+    attr_reader :type
+
+    # @return [String ("public", "private")]
+    attr_reader :visibility
+
+    def initialize(created_at:, description:, id:, metadata:, modified_at:, name:, properties:, status:, type:, visibility:)
+      @created_at = created_at
+      @description = description
+      @id = id
+      @metadata = metadata
+      @modified_at = modified_at
+      @name = name
+      @properties = properties
+      @status = status
+      @type = type
+      @visibility = visibility
+      freeze
+    end
+
+    # Builds a Benefit from the API's JSON.
+    def self.from_hash(data)
+      new(
+        created_at: data.fetch("created_at"),
+        description: data.fetch("description"),
+        id: data.fetch("id"),
+        metadata: data.fetch("metadata"),
+        modified_at: data.fetch("modified_at"),
+        name: data.fetch("name"),
+        properties: data.fetch("properties"),
+        status: data.fetch("status"),
+        type: data.fetch("type"),
+        visibility: data.fetch("visibility")
+      )
+    end
+  end
+
   # BenefitGrant is a resource of Peráta's API.
   class BenefitGrant < Model
-    MEMBERS = %i[benefit_id benefit_type created_at customer_id granted_at id is_granted is_revoked revoked_at status].freeze
+    MEMBERS = %i[benefit_id benefit_metadata benefit_type created_at customer_id granted_at id is_granted is_revoked properties revoked_at status].freeze
 
     # @return [String]
     attr_reader :benefit_id
 
-    # @return [String]
+    # Os metadados do benefício: os valores de uma feature flag.
+    # @return [Hash{String => Object}]
+    attr_reader :benefit_metadata
+
+    # @return [String ("custom", "license_key", "downloadable", "feature_flag", "meter_credit", "discord", "github_repository")]
     attr_reader :benefit_type
 
     # @return [String]
@@ -31,14 +103,19 @@ module Perata
     # @return [Boolean]
     attr_reader :is_revoked
 
+    # O que a concessão informa, conforme o tipo, sem credenciais.
+    # @return [Hash{String => Object}]
+    attr_reader :properties
+
     # @return [String, nil]
     attr_reader :revoked_at
 
     # @return [String ("granted", "revoked")]
     attr_reader :status
 
-    def initialize(benefit_id:, benefit_type:, created_at:, customer_id:, granted_at:, id:, is_granted:, is_revoked:, revoked_at:, status:)
+    def initialize(benefit_id:, benefit_metadata:, benefit_type:, created_at:, customer_id:, granted_at:, id:, is_granted:, is_revoked:, properties:, revoked_at:, status:)
       @benefit_id = benefit_id
+      @benefit_metadata = benefit_metadata
       @benefit_type = benefit_type
       @created_at = created_at
       @customer_id = customer_id
@@ -46,6 +123,7 @@ module Perata
       @id = id
       @is_granted = is_granted
       @is_revoked = is_revoked
+      @properties = properties
       @revoked_at = revoked_at
       @status = status
       freeze
@@ -55,6 +133,7 @@ module Perata
     def self.from_hash(data)
       new(
         benefit_id: data.fetch("benefit_id"),
+        benefit_metadata: data.fetch("benefit_metadata"),
         benefit_type: data.fetch("benefit_type"),
         created_at: data.fetch("created_at"),
         customer_id: data.fetch("customer_id"),
@@ -62,12 +141,66 @@ module Perata
         id: data.fetch("id"),
         is_granted: data.fetch("is_granted"),
         is_revoked: data.fetch("is_revoked"),
+        properties: data.fetch("properties"),
         revoked_at: data["revoked_at"],
         status: data.fetch("status")
       )
     end
   end
 
+  # BillingAddress is a resource of Peráta's API.
+  class BillingAddress < Model
+    MEMBERS = %i[city country district line1 line2 postal_code state].freeze
+
+    # @return [String]
+    attr_reader :city
+
+    # @return [String]
+    attr_reader :country
+
+    # Bairro.
+    # @return [String]
+    attr_reader :district
+
+    # @return [String]
+    attr_reader :line1
+
+    # @return [String]
+    attr_reader :line2
+
+    # CEP, só dígitos.
+    # @return [String]
+    attr_reader :postal_code
+
+    # UF.
+    # @return [String]
+    attr_reader :state
+
+    def initialize(city:, country:, district:, line1:, line2:, postal_code:, state:)
+      @city = city
+      @country = country
+      @district = district
+      @line1 = line1
+      @line2 = line2
+      @postal_code = postal_code
+      @state = state
+      freeze
+    end
+
+    # Builds a BillingAddress from the API's JSON.
+    def self.from_hash(data)
+      new(
+        city: data.fetch("city"),
+        country: data.fetch("country"),
+        district: data.fetch("district"),
+        line1: data.fetch("line1"),
+        line2: data.fetch("line2"),
+        postal_code: data.fetch("postal_code"),
+        state: data.fetch("state")
+      )
+    end
+  end
+
   # Card is a resource of Peráta's API.
   class Card < Model
     MEMBERS = %i[brand exp_month exp_year last4].freeze
@@ -105,25 +238,58 @@ module Perata
 
   # Checkout is a resource of Peráta's API.
   class Checkout < Model
-    MEMBERS = %i[id price_id product_id url].freeze
+    MEMBERS = %i[cancel_url created_at expires_at id label price_id product_id quantity status success_url url].freeze
+
+    # Endereço https para onde o comprador volta se desistir; vazio sem ele.
+    # @return [String]
+    attr_reader :cancel_url
+
+    # @return [String]
+    attr_reader :created_at
+
+    # Quando o checkout deixa de abrir sessões; nulo sem prazo.
+    # @return [String, nil]
+    attr_reader :expires_at
 
     # @return [String]
     attr_reader :id
 
+    # Como o lojista chama o checkout nas próprias telas; o comprador não vê.
+    # @return [String]
+    attr_reader :label
+
     # @return [String]
     attr_reader :price_id
 
     # @return [String]
     attr_reader :product_id
 
+    # @return [Integer]
+    attr_reader :quantity
+
+    # active abre sessões de compra; archived saiu de circulação.
+    # @return [String ("active", "archived")]
+    attr_reader :status
+
+    # Endereço https para onde o comprador volta depois de pagar; vazio sem ele.
+    # @return [String]
+    attr_reader :success_url
+
     # Endereço para onde o comprador é enviado.
     # @return [String]
     attr_reader :url
 
-    def initialize(id:, price_id:, product_id:, url:)
+    def initialize(cancel_url:, created_at:, expires_at:, id:, label:, price_id:, product_id:, quantity:, status:, success_url:, url:)
+      @cancel_url = cancel_url
+      @created_at = created_at
+      @expires_at = expires_at
       @id = id
+      @label = label
       @price_id = price_id
       @product_id = product_id
+      @quantity = quantity
+      @status = status
+      @success_url = success_url
       @url = url
       freeze
     end
@@ -131,14 +297,180 @@ module Perata
     # Builds a Checkout from the API's JSON.
     def self.from_hash(data)
       new(
+        cancel_url: data.fetch("cancel_url"),
+        created_at: data.fetch("created_at"),
+        expires_at: data["expires_at"],
+        id: data.fetch("id"),
+        label: data.fetch("label"),
+        price_id: data.fetch("price_id"),
+        product_id: data.fetch("product_id"),
+        quantity: data.fetch("quantity"),
+        status: data.fetch("status"),
+        success_url: data.fetch("success_url"),
+        url: data.fetch("url")
+      )
+    end
+  end
+
+  # CheckoutLink is a resource of Peráta's API.
+  class CheckoutLink < Model
+    MEMBERS = %i[allow_discount_codes cancel_url capture_mode created_at discount_id expires_at id label max_installments metadata modified_at price_id product_id products quantity require_billing_address status success_url trial_interval trial_interval_count url].freeze
+
+    # Se o comprador pode digitar um código de desconto.
+    # @return [Boolean]
+    attr_reader :allow_discount_codes
+
+    # Endereço https para onde o comprador volta se desistir; vazio sem ele.
+    # @return [String]
+    attr_reader :cancel_url
+
+    # manual segura a venda no cartão para o lojista capturar depois.
+    # @return [String ("automatic", "manual")]
+    attr_reader :capture_mode
+
+    # @return [String]
+    attr_reader :created_at
+
+    # O desconto fixado no link; nulo sem ele.
+    # @return [String, nil]
+    attr_reader :discount_id
+
+    # Quando o link deixa de abrir checkouts; nulo sem prazo.
+    # @return [String, nil]
+    attr_reader :expires_at
+
+    # @return [String]
+    attr_reader :id
+
+    # Como o lojista chama o link nas próprias telas; o comprador não vê.
+    # @return [String]
+    attr_reader :label
+
+    # O máximo de parcelas no cartão de crédito; 0 segue o que a organização definiu.
+    # @return [Integer]
+    attr_reader :max_installments
+
+    # Metadados do lojista: pares chave e valor (texto, número ou booleano); objeto vazio quando não há.
+    # @return [Hash{String => Object}]
+    attr_reader :metadata
+
+    # @return [String]
+    attr_reader :modified_at
+
+    # O preço do primeiro produto.
+    # @return [String]
+    attr_reader :price_id
+
+    # O primeiro produto do link.
+    # @return [String]
+    attr_reader :product_id
+
+    # Os produtos que o link vende, na ordem em que o comprador os vê.
+    # @return [Array<CheckoutLinkProduct>]
+    attr_reader :products
+
+    # @return [Integer]
+    attr_reader :quantity
+
+    # @return [Boolean]
+    attr_reader :require_billing_address
+
+    # @return [String ("active", "archived")]
+    attr_reader :status
+
+    # Endereço https para onde o comprador volta depois de pagar; vazio sem ele.
+    # @return [String]
+    attr_reader :success_url
+
+    # O período de teste gratuito do link, no lugar do produto; nulo mantém o do produto.
+    # @return [String ("day", "week", "month", "year"), nil]
+    attr_reader :trial_interval
+
+    # @return [Integer, nil]
+    attr_reader :trial_interval_count
+
+    # Endereço para onde o comprador é enviado.
+    # @return [String]
+    attr_reader :url
+
+    def initialize(allow_discount_codes:, cancel_url:, capture_mode:, created_at:, discount_id:, expires_at:, id:, label:, max_installments:, metadata:, modified_at:, price_id:, product_id:, products:, quantity:, require_billing_address:, status:, success_url:, trial_interval:, trial_interval_count:, url:)
+      @allow_discount_codes = allow_discount_codes
+      @cancel_url = cancel_url
+      @capture_mode = capture_mode
+      @created_at = created_at
+      @discount_id = discount_id
+      @expires_at = expires_at
+      @id = id
+      @label = label
+      @max_installments = max_installments
+      @metadata = metadata
+      @modified_at = modified_at
+      @price_id = price_id
+      @product_id = product_id
+      @products = products
+      @quantity = quantity
+      @require_billing_address = require_billing_address
+      @status = status
+      @success_url = success_url
+      @trial_interval = trial_interval
+      @trial_interval_count = trial_interval_count
+      @url = url
+      freeze
+    end
+
+    # Builds a CheckoutLink from the API's JSON.
+    def self.from_hash(data)
+      new(
+        allow_discount_codes: data.fetch("allow_discount_codes"),
+        cancel_url: data.fetch("cancel_url"),
+        capture_mode: data.fetch("capture_mode"),
+        created_at: data.fetch("created_at"),
+        discount_id: data["discount_id"],
+        expires_at: data["expires_at"],
         id: data.fetch("id"),
+        label: data.fetch("label"),
+        max_installments: data.fetch("max_installments"),
+        metadata: data.fetch("metadata"),
+        modified_at: data.fetch("modified_at"),
         price_id: data.fetch("price_id"),
         product_id: data.fetch("product_id"),
+        products: data.fetch("products").map { |item| CheckoutLinkProduct.from_hash(item) },
+        quantity: data.fetch("quantity"),
+        require_billing_address: data.fetch("require_billing_address"),
+        status: data.fetch("status"),
+        success_url: data.fetch("success_url"),
+        trial_interval: data["trial_interval"],
+        trial_interval_count: data["trial_interval_count"],
         url: data.fetch("url")
       )
     end
   end
 
+  # CheckoutLinkProduct is a resource of Peráta's API.
+  class CheckoutLinkProduct < Model
+    MEMBERS = %i[price_id product_id].freeze
+
+    # @return [String]
+    attr_reader :price_id
+
+    # @return [String]
+    attr_reader :product_id
+
+    def initialize(price_id:, product_id:)
+      @price_id = price_id
+      @product_id = product_id
+      freeze
+    end
+
+    # Builds a CheckoutLinkProduct from the API's JSON.
+    def self.from_hash(data)
+      new(
+        price_id: data.fetch("price_id"),
+        product_id: data.fetch("product_id")
+      )
+    end
+  end
+
   # Customer is a resource of Peráta's API.
   class Customer < Model
     MEMBERS = %i[created_at email external_id id name status].freeze
@@ -216,69 +548,762 @@ module Perata
     end
   end
 
-  # Order is a resource of Peráta's API.
-  class Order < Model
-    MEMBERS = %i[amount_cents currency customer_id id installment_interest_cents installments paid_at price_id product_id status].freeze
+  # CustomerState is a resource of Peráta's API.
+  class CustomerState < Model
+    MEMBERS = %i[active_subscriptions created_at email external_id granted_benefits id name status].freeze
 
-    # @return [Integer]
-    attr_reader :amount_cents
+    # As assinaturas ativas ou em teste do cliente.
+    # @return [Array<Subscription>]
+    attr_reader :active_subscriptions
 
-    # @return [String ("BRL")]
-    attr_reader :currency
+    # @return [String]
+    attr_reader :created_at
 
     # @return [String]
-    attr_reader :customer_id
+    attr_reader :email
+
+    # @return [String]
+    attr_reader :external_id
+
+    # Os benefícios que o cliente tem agora.
+    # @return [Array<CustomerStateBenefitGrant>]
+    attr_reader :granted_benefits
 
     # @return [String]
     attr_reader :id
 
-    # Juros do parcelamento pagos pelo comprador, cobrados além de amount_cents.
-    # @return [Integer]
-    attr_reader :installment_interest_cents
+    # @return [String]
+    attr_reader :name
 
-    # Em quantas parcelas o cartão de crédito foi cobrado; 1 à vista.
-    # @return [Integer]
-    attr_reader :installments
+    # @return [String ("active", "archived")]
+    attr_reader :status
+
+    def initialize(active_subscriptions:, created_at:, email:, external_id:, granted_benefits:, id:, name:, status:)
+      @active_subscriptions = active_subscriptions
+      @created_at = created_at
+      @email = email
+      @external_id = external_id
+      @granted_benefits = granted_benefits
+      @id = id
+      @name = name
+      @status = status
+      freeze
+    end
+
+    # Builds a CustomerState from the API's JSON.
+    def self.from_hash(data)
+      new(
+        active_subscriptions: data.fetch("active_subscriptions").map { |item| Subscription.from_hash(item) },
+        created_at: data.fetch("created_at"),
+        email: data.fetch("email"),
+        external_id: data.fetch("external_id"),
+        granted_benefits: data.fetch("granted_benefits").map { |item| CustomerStateBenefitGrant.from_hash(item) },
+        id: data.fetch("id"),
+        name: data.fetch("name"),
+        status: data.fetch("status")
+      )
+    end
+  end
+
+  # CustomerStateBenefitGrant is a resource of Peráta's API.
+  class CustomerStateBenefitGrant < Model
+    MEMBERS = %i[benefit_id benefit_metadata benefit_type granted_at id properties].freeze
+
+    # @return [String]
+    attr_reader :benefit_id
+
+    # Os metadados do benefício: os valores de uma feature flag.
+    # @return [Hash{String => Object}]
+    attr_reader :benefit_metadata
+
+    # @return [String ("custom", "license_key", "downloadable", "feature_flag", "meter_credit", "discord", "github_repository")]
+    attr_reader :benefit_type
+
+    # @return [String]
+    attr_reader :granted_at
+
+    # A concessão.
+    # @return [String]
+    attr_reader :id
+
+    # O que a concessão informa, conforme o tipo.
+    # @return [Hash{String => Object}]
+    attr_reader :properties
+
+    def initialize(benefit_id:, benefit_metadata:, benefit_type:, granted_at:, id:, properties:)
+      @benefit_id = benefit_id
+      @benefit_metadata = benefit_metadata
+      @benefit_type = benefit_type
+      @granted_at = granted_at
+      @id = id
+      @properties = properties
+      freeze
+    end
+
+    # Builds a CustomerStateBenefitGrant from the API's JSON.
+    def self.from_hash(data)
+      new(
+        benefit_id: data.fetch("benefit_id"),
+        benefit_metadata: data.fetch("benefit_metadata"),
+        benefit_type: data.fetch("benefit_type"),
+        granted_at: data.fetch("granted_at"),
+        id: data.fetch("id"),
+        properties: data.fetch("properties")
+      )
+    end
+  end
+
+  # Discount is a resource of Peráta's API.
+  class Discount < Model
+    MEMBERS = %i[amount_cents basis_points code created_at currency duration duration_in_months ends_at id max_redemptions max_redemptions_per_customer modified_at name product_ids redemptions_count starts_at status type].freeze
+
+    # O valor fixo em centavos; 0 em um desconto percentual.
+    # @return [Integer]
+    attr_reader :amount_cents
+
+    # O percentual em centésimos de ponto percentual, 10000 é 100%; 0 em um desconto fixo.
+    # @return [Integer]
+    attr_reader :basis_points
+
+    # O código que o cliente digita no checkout; nulo quando o desconto só se aplica por um link de checkout ou pela API.
+    # @return [String, nil]
+    attr_reader :code
+
+    # @return [String]
+    attr_reader :created_at
+
+    # @return [String ("BRL")]
+    attr_reader :currency
+
+    # Em uma assinatura: só na primeira fatura, por duration_in_months meses ou para sempre.
+    # @return [String ("once", "repeating", "forever")]
+    attr_reader :duration
+
+    # Os meses de um desconto repeating; 0 nos outros.
+    # @return [Integer]
+    attr_reader :duration_in_months
+
+    # Depois de quando deixa de valer; nulo sem fim.
+    # @return [String, nil]
+    attr_reader :ends_at
+
+    # @return [String]
+    attr_reader :id
+
+    # Quantas vezes o desconto pode ser usado no total; nulo sem limite.
+    # @return [Integer, nil]
+    attr_reader :max_redemptions
+
+    # Quantas vezes um mesmo cliente pode usá-lo, de 1 a 100; nulo sem limite.
+    # @return [Integer, nil]
+    attr_reader :max_redemptions_per_customer
+
+    # @return [String]
+    attr_reader :modified_at
+
+    # Mostrado ao cliente quando o desconto é aplicado.
+    # @return [String]
+    attr_reader :name
+
+    # Os produtos a que o desconto se aplica; vazio, todos os do catálogo.
+    # @return [Array<String>]
+    attr_reader :product_ids
+
+    # @return [Integer]
+    attr_reader :redemptions_count
+
+    # A partir de quando o desconto vale.
+    # @return [String]
+    attr_reader :starts_at
+
+    # @return [String ("active", "expired", "exhausted")]
+    attr_reader :status
+
+    # @return [String ("percentage", "fixed")]
+    attr_reader :type
+
+    def initialize(amount_cents:, basis_points:, code:, created_at:, currency:, duration:, duration_in_months:, ends_at:, id:, max_redemptions:, max_redemptions_per_customer:, modified_at:, name:, product_ids:, redemptions_count:, starts_at:, status:, type:)
+      @amount_cents = amount_cents
+      @basis_points = basis_points
+      @code = code
+      @created_at = created_at
+      @currency = currency
+      @duration = duration
+      @duration_in_months = duration_in_months
+      @ends_at = ends_at
+      @id = id
+      @max_redemptions = max_redemptions
+      @max_redemptions_per_customer = max_redemptions_per_customer
+      @modified_at = modified_at
+      @name = name
+      @product_ids = product_ids
+      @redemptions_count = redemptions_count
+      @starts_at = starts_at
+      @status = status
+      @type = type
+      freeze
+    end
+
+    # Builds a Discount from the API's JSON.
+    def self.from_hash(data)
+      new(
+        amount_cents: data.fetch("amount_cents"),
+        basis_points: data.fetch("basis_points"),
+        code: data["code"],
+        created_at: data.fetch("created_at"),
+        currency: data.fetch("currency"),
+        duration: data.fetch("duration"),
+        duration_in_months: data.fetch("duration_in_months"),
+        ends_at: data["ends_at"],
+        id: data.fetch("id"),
+        max_redemptions: data["max_redemptions"],
+        max_redemptions_per_customer: data["max_redemptions_per_customer"],
+        modified_at: data.fetch("modified_at"),
+        name: data.fetch("name"),
+        product_ids: data.fetch("product_ids"),
+        redemptions_count: data.fetch("redemptions_count"),
+        starts_at: data.fetch("starts_at"),
+        status: data.fetch("status"),
+        type: data.fetch("type")
+      )
+    end
+  end
+
+  # Dispute is a resource of Peráta's API.
+  class Dispute < Model
+    MEMBERS = %i[amount_cents currency customer_id decided_at due_by id invoice_id opened_at order_id payment_id provider_dispute_id provider_reason reason source status].freeze
+
+    # Valor contestado, em centavos.
+    # @return [Integer]
+    attr_reader :amount_cents
+
+    # @return [String ("BRL")]
+    attr_reader :currency
+
+    # @return [String, nil]
+    attr_reader :customer_id
+
+    # @return [String, nil]
+    attr_reader :decided_at
+
+    # Prazo da defesa.
+    # @return [String, nil]
+    attr_reader :due_by
+
+    # @return [String]
+    attr_reader :id
+
+    # @return [String, nil]
+    attr_reader :invoice_id
+
+    # @return [String]
+    attr_reader :opened_at
+
+    # O pedido que a venda contestada pagou; nulo quando não é de um checkout.
+    # @return [String, nil]
+    attr_reader :order_id
+
+    # O PaymentId da venda contestada na Cielo.
+    # @return [String]
+    attr_reader :payment_id
+
+    # O número do caso na Cielo.
+    # @return [String]
+    attr_reader :provider_dispute_id
+
+    # O motivo nas palavras da Cielo.
+    # @return [String]
+    attr_reader :provider_reason
+
+    # Motivo, do conjunto fechado; unknown quando a adquirente não informou.
+    # @return [String]
+    attr_reader :reason
+
+    # @return [String ("operator", "cielo_chargeback")]
+    attr_reader :source
+
+    # @return [String ("opened", "needs_evidence", "submitted", "under_review", "won", "lost", "closed")]
+    attr_reader :status
+
+    def initialize(amount_cents:, currency:, customer_id:, decided_at:, due_by:, id:, invoice_id:, opened_at:, order_id:, payment_id:, provider_dispute_id:, provider_reason:, reason:, source:, status:)
+      @amount_cents = amount_cents
+      @currency = currency
+      @customer_id = customer_id
+      @decided_at = decided_at
+      @due_by = due_by
+      @id = id
+      @invoice_id = invoice_id
+      @opened_at = opened_at
+      @order_id = order_id
+      @payment_id = payment_id
+      @provider_dispute_id = provider_dispute_id
+      @provider_reason = provider_reason
+      @reason = reason
+      @source = source
+      @status = status
+      freeze
+    end
+
+    # Builds a Dispute from the API's JSON.
+    def self.from_hash(data)
+      new(
+        amount_cents: data.fetch("amount_cents"),
+        currency: data.fetch("currency"),
+        customer_id: data["customer_id"],
+        decided_at: data["decided_at"],
+        due_by: data["due_by"],
+        id: data.fetch("id"),
+        invoice_id: data["invoice_id"],
+        opened_at: data.fetch("opened_at"),
+        order_id: data["order_id"],
+        payment_id: data.fetch("payment_id"),
+        provider_dispute_id: data.fetch("provider_dispute_id"),
+        provider_reason: data.fetch("provider_reason"),
+        reason: data.fetch("reason"),
+        source: data.fetch("source"),
+        status: data.fetch("status")
+      )
+    end
+  end
+
+  # Event is a resource of Peráta's API.
+  class Event < Model
+    MEMBERS = %i[cached_tokens cost_currency cost_micro_cents customer_id external_id id input_tokens llm_model llm_vendor name output_tokens parent_id received_at source_id timestamp].freeze
+
+    # @return [Integer]
+    attr_reader :cached_tokens
+
+    # @return [String]
+    attr_reader :cost_currency
+
+    # O custo da chamada em milionésimos de centavo.
+    # @return [Integer]
+    attr_reader :cost_micro_cents
+
+    # @return [String]
+    attr_reader :customer_id
+
+    # O identificador do evento no sistema da origem.
+    # @return [String]
+    attr_reader :external_id
+
+    # @return [String]
+    attr_reader :id
+
+    # @return [Integer]
+    attr_reader :input_tokens
+
+    # @return [String]
+    attr_reader :llm_model
+
+    # @return [String]
+    attr_reader :llm_vendor
+
+    # @return [String ("token_usage")]
+    attr_reader :name
+
+    # @return [Integer]
+    attr_reader :output_tokens
+
+    # O evento de que este é filho; nulo na raiz.
+    # @return [String, nil]
+    attr_reader :parent_id
+
+    # @return [String]
+    attr_reader :received_at
+
+    # A origem que enviou o evento.
+    # @return [String]
+    attr_reader :source_id
+
+    # Quando o evento aconteceu.
+    # @return [String]
+    attr_reader :timestamp
+
+    def initialize(cached_tokens:, cost_currency:, cost_micro_cents:, customer_id:, external_id:, id:, input_tokens:, llm_model:, llm_vendor:, name:, output_tokens:, parent_id:, received_at:, source_id:, timestamp:)
+      @cached_tokens = cached_tokens
+      @cost_currency = cost_currency
+      @cost_micro_cents = cost_micro_cents
+      @customer_id = customer_id
+      @external_id = external_id
+      @id = id
+      @input_tokens = input_tokens
+      @llm_model = llm_model
+      @llm_vendor = llm_vendor
+      @name = name
+      @output_tokens = output_tokens
+      @parent_id = parent_id
+      @received_at = received_at
+      @source_id = source_id
+      @timestamp = timestamp
+      freeze
+    end
+
+    # Builds a Event from the API's JSON.
+    def self.from_hash(data)
+      new(
+        cached_tokens: data.fetch("cached_tokens"),
+        cost_currency: data.fetch("cost_currency"),
+        cost_micro_cents: data.fetch("cost_micro_cents"),
+        customer_id: data.fetch("customer_id"),
+        external_id: data.fetch("external_id"),
+        id: data.fetch("id"),
+        input_tokens: data.fetch("input_tokens"),
+        llm_model: data.fetch("llm_model"),
+        llm_vendor: data.fetch("llm_vendor"),
+        name: data.fetch("name"),
+        output_tokens: data.fetch("output_tokens"),
+        parent_id: data["parent_id"],
+        received_at: data.fetch("received_at"),
+        source_id: data.fetch("source_id"),
+        timestamp: data.fetch("timestamp")
+      )
+    end
+  end
+
+  # Meter is a resource of Peráta's API.
+  class Meter < Model
+    MEMBERS = %i[aggregation archived_at created_at filter id modified_at name unit].freeze
+
+    # @return [MeterAggregation]
+    attr_reader :aggregation
+
+    # Quando o medidor foi arquivado; nulo se está ativo.
+    # @return [String, nil]
+    attr_reader :archived_at
+
+    # @return [String]
+    attr_reader :created_at
+
+    # Os eventos que o medidor conta: grupos de condições, em conjunction and ou or, sobre name, timestamp ou metadata.<chave>.
+    # @return [Hash{String => Object}]
+    attr_reader :filter
+
+    # @return [String]
+    attr_reader :id
+
+    # @return [String]
+    attr_reader :modified_at
+
+    # @return [String]
+    attr_reader :name
+
+    # @return [MeterUnit]
+    attr_reader :unit
+
+    def initialize(aggregation:, archived_at:, created_at:, filter:, id:, modified_at:, name:, unit:)
+      @aggregation = aggregation
+      @archived_at = archived_at
+      @created_at = created_at
+      @filter = filter
+      @id = id
+      @modified_at = modified_at
+      @name = name
+      @unit = unit
+      freeze
+    end
+
+    # Builds a Meter from the API's JSON.
+    def self.from_hash(data)
+      new(
+        aggregation: MeterAggregation.from_hash(data.fetch("aggregation")),
+        archived_at: data["archived_at"],
+        created_at: data.fetch("created_at"),
+        filter: data.fetch("filter"),
+        id: data.fetch("id"),
+        modified_at: data.fetch("modified_at"),
+        name: data.fetch("name"),
+        unit: MeterUnit.from_hash(data.fetch("unit"))
+      )
+    end
+  end
+
+  # MeterAggregation is a resource of Peráta's API.
+  class MeterAggregation < Model
+    MEMBERS = %i[func property].freeze
+
+    # @return [String ("count", "sum", "avg", "min", "max", "unique")]
+    attr_reader :func
+
+    # A propriedade do evento que as funções, menos count, leem; vazia no count.
+    # @return [String]
+    attr_reader :property
+
+    def initialize(func:, property:)
+      @func = func
+      @property = property
+      freeze
+    end
+
+    # Builds a MeterAggregation from the API's JSON.
+    def self.from_hash(data)
+      new(
+        func: data.fetch("func"),
+        property: data.fetch("property")
+      )
+    end
+  end
+
+  # MeterUnit is a resource of Peráta's API.
+  class MeterUnit < Model
+    MEMBERS = %i[label multiplier type].freeze
+
+    # @return [String]
+    attr_reader :label
+
+    # Por quantas unidades o preço é mostrado.
+    # @return [Integer]
+    attr_reader :multiplier
+
+    # @return [String ("scalar", "token", "custom")]
+    attr_reader :type
+
+    def initialize(label:, multiplier:, type:)
+      @label = label
+      @multiplier = multiplier
+      @type = type
+      freeze
+    end
+
+    # Builds a MeterUnit from the API's JSON.
+    def self.from_hash(data)
+      new(
+        label: data.fetch("label"),
+        multiplier: data.fetch("multiplier"),
+        type: data.fetch("type")
+      )
+    end
+  end
+
+  # Order is a resource of Peráta's API.
+  class Order < Model
+    MEMBERS = %i[amount_cents currency customer_id id installment_interest_cents installments paid_at price_id product_id status].freeze
+
+    # @return [Integer]
+    attr_reader :amount_cents
+
+    # @return [String ("BRL")]
+    attr_reader :currency
+
+    # @return [String]
+    attr_reader :customer_id
+
+    # @return [String]
+    attr_reader :id
+
+    # Juros do parcelamento pagos pelo comprador, cobrados além de amount_cents.
+    # @return [Integer]
+    attr_reader :installment_interest_cents
+
+    # Em quantas parcelas o cartão de crédito foi cobrado; 1 à vista.
+    # @return [Integer]
+    attr_reader :installments
+
+    # @return [String, nil]
+    attr_reader :paid_at
+
+    # @return [String]
+    attr_reader :price_id
+
+    # @return [String]
+    attr_reader :product_id
+
+    # @return [String ("open", "confirmed", "succeeded", "failed", "expired")]
+    attr_reader :status
+
+    def initialize(amount_cents:, currency:, customer_id:, id:, installment_interest_cents:, installments:, paid_at:, price_id:, product_id:, status:)
+      @amount_cents = amount_cents
+      @currency = currency
+      @customer_id = customer_id
+      @id = id
+      @installment_interest_cents = installment_interest_cents
+      @installments = installments
+      @paid_at = paid_at
+      @price_id = price_id
+      @product_id = product_id
+      @status = status
+      freeze
+    end
+
+    # Builds a Order from the API's JSON.
+    def self.from_hash(data)
+      new(
+        amount_cents: data.fetch("amount_cents"),
+        currency: data.fetch("currency"),
+        customer_id: data.fetch("customer_id"),
+        id: data.fetch("id"),
+        installment_interest_cents: data.fetch("installment_interest_cents"),
+        installments: data.fetch("installments"),
+        paid_at: data["paid_at"],
+        price_id: data.fetch("price_id"),
+        product_id: data.fetch("product_id"),
+        status: data.fetch("status")
+      )
+    end
+  end
+
+  # OrderInvoice is a resource of Peráta's API.
+  class OrderInvoice < Model
+    MEMBERS = %i[address amount_cents billing_name currency discount_cents generated_at number order_id product_name tax_id tax_id_kind total_cents].freeze
+
+    # @return [BillingAddress]
+    attr_reader :address
+
+    # @return [Integer]
+    attr_reader :amount_cents
+
+    # @return [String]
+    attr_reader :billing_name
+
+    # @return [String ("BRL")]
+    attr_reader :currency
+
+    # @return [Integer]
+    attr_reader :discount_cents
+
+    # @return [String]
+    attr_reader :generated_at
+
+    # Número da fatura, na série da organização (PREFIXO-0001).
+    # @return [String]
+    attr_reader :number
+
+    # @return [String]
+    attr_reader :order_id
+
+    # @return [String]
+    attr_reader :product_name
+
+    # CPF ou CNPJ, só dígitos.
+    # @return [String]
+    attr_reader :tax_id
+
+    # cpf ou cnpj; vazio sem documento.
+    # @return [String]
+    attr_reader :tax_id_kind
+
+    # @return [Integer]
+    attr_reader :total_cents
+
+    def initialize(address:, amount_cents:, billing_name:, currency:, discount_cents:, generated_at:, number:, order_id:, product_name:, tax_id:, tax_id_kind:, total_cents:)
+      @address = address
+      @amount_cents = amount_cents
+      @billing_name = billing_name
+      @currency = currency
+      @discount_cents = discount_cents
+      @generated_at = generated_at
+      @number = number
+      @order_id = order_id
+      @product_name = product_name
+      @tax_id = tax_id
+      @tax_id_kind = tax_id_kind
+      @total_cents = total_cents
+      freeze
+    end
+
+    # Builds a OrderInvoice from the API's JSON.
+    def self.from_hash(data)
+      new(
+        address: BillingAddress.from_hash(data.fetch("address")),
+        amount_cents: data.fetch("amount_cents"),
+        billing_name: data.fetch("billing_name"),
+        currency: data.fetch("currency"),
+        discount_cents: data.fetch("discount_cents"),
+        generated_at: data.fetch("generated_at"),
+        number: data.fetch("number"),
+        order_id: data.fetch("order_id"),
+        product_name: data.fetch("product_name"),
+        tax_id: data.fetch("tax_id"),
+        tax_id_kind: data.fetch("tax_id_kind"),
+        total_cents: data.fetch("total_cents")
+      )
+    end
+  end
+
+  # OrderReceipt is a resource of Peráta's API.
+  class OrderReceipt < Model
+    MEMBERS = %i[amount_cents currency customer_email customer_name discount_cents installment_interest_cents installments number order_id paid_at payment_method product_name refunded_cents total_cents].freeze
+
+    # @return [Integer]
+    attr_reader :amount_cents
+
+    # @return [String ("BRL")]
+    attr_reader :currency
+
+    # @return [String]
+    attr_reader :customer_email
+
+    # @return [String]
+    attr_reader :customer_name
+
+    # @return [Integer]
+    attr_reader :discount_cents
+
+    # @return [Integer]
+    attr_reader :installment_interest_cents
+
+    # Em quantas parcelas o cartão de crédito foi cobrado; 1 à vista.
+    # @return [Integer]
+    attr_reader :installments
+
+    # Número do pedido na série da organização; vazio antes de ter um.
+    # @return [String]
+    attr_reader :number
+
+    # @return [String]
+    attr_reader :order_id
 
     # @return [String, nil]
     attr_reader :paid_at
 
+    # card, pix ou boleto; vazio quando o pagamento não foi achado.
     # @return [String]
-    attr_reader :price_id
+    attr_reader :payment_method
 
     # @return [String]
-    attr_reader :product_id
+    attr_reader :product_name
 
-    # @return [String ("open", "confirmed", "succeeded", "failed", "expired")]
-    attr_reader :status
+    # @return [Integer]
+    attr_reader :refunded_cents
 
-    def initialize(amount_cents:, currency:, customer_id:, id:, installment_interest_cents:, installments:, paid_at:, price_id:, product_id:, status:)
+    # @return [Integer]
+    attr_reader :total_cents
+
+    def initialize(amount_cents:, currency:, customer_email:, customer_name:, discount_cents:, installment_interest_cents:, installments:, number:, order_id:, paid_at:, payment_method:, product_name:, refunded_cents:, total_cents:)
       @amount_cents = amount_cents
       @currency = currency
-      @customer_id = customer_id
-      @id = id
+      @customer_email = customer_email
+      @customer_name = customer_name
+      @discount_cents = discount_cents
       @installment_interest_cents = installment_interest_cents
       @installments = installments
+      @number = number
+      @order_id = order_id
       @paid_at = paid_at
-      @price_id = price_id
-      @product_id = product_id
-      @status = status
+      @payment_method = payment_method
+      @product_name = product_name
+      @refunded_cents = refunded_cents
+      @total_cents = total_cents
       freeze
     end
 
-    # Builds a Order from the API's JSON.
+    # Builds a OrderReceipt from the API's JSON.
     def self.from_hash(data)
       new(
         amount_cents: data.fetch("amount_cents"),
         currency: data.fetch("currency"),
-        customer_id: data.fetch("customer_id"),
-        id: data.fetch("id"),
+        customer_email: data.fetch("customer_email"),
+        customer_name: data.fetch("customer_name"),
+        discount_cents: data.fetch("discount_cents"),
         installment_interest_cents: data.fetch("installment_interest_cents"),
         installments: data.fetch("installments"),
+        number: data.fetch("number"),
+        order_id: data.fetch("order_id"),
         paid_at: data["paid_at"],
-        price_id: data.fetch("price_id"),
-        product_id: data.fetch("product_id"),
-        status: data.fetch("status")
+        payment_method: data.fetch("payment_method"),
+        product_name: data.fetch("product_name"),
+        refunded_cents: data.fetch("refunded_cents"),
+        total_cents: data.fetch("total_cents")
       )
     end
   end
@@ -584,7 +1609,7 @@ module Perata
 
   # Subscription is a resource of Peráta's API.
   class Subscription < Model
-    MEMBERS = %i[amount_cents cancel_at_period_end currency current_period_end current_period_start customer_id id interval price_id product_id status].freeze
+    MEMBERS = %i[amount_cents cancel_at_period_end currency current_period_end current_period_start customer_id id interval metadata price_id product_id status trial_end trial_start].freeze
 
     # @return [Integer]
     attr_reader :amount_cents
@@ -610,6 +1635,10 @@ module Perata
     # @return [String]
     attr_reader :interval
 
+    # Metadados do lojista: pares chave e valor (texto, número ou booleano); objeto vazio quando não há.
+    # @return [Hash{String => Object}]
+    attr_reader :metadata
+
     # @return [String]
     attr_reader :price_id
 
@@ -619,7 +1648,13 @@ module Perata
     # @return [String ("trialing", "active", "past_due", "paused", "canceled")]
     attr_reader :status
 
-    def initialize(amount_cents:, cancel_at_period_end:, currency:, current_period_end:, current_period_start:, customer_id:, id:, interval:, price_id:, product_id:, status:)
+    # @return [String, nil]
+    attr_reader :trial_end
+
+    # @return [String, nil]
+    attr_reader :trial_start
+
+    def initialize(amount_cents:, cancel_at_period_end:, currency:, current_period_end:, current_period_start:, customer_id:, id:, interval:, metadata:, price_id:, product_id:, status:, trial_end:, trial_start:)
       @amount_cents = amount_cents
       @cancel_at_period_end = cancel_at_period_end
       @currency = currency
@@ -628,9 +1663,12 @@ module Perata
       @customer_id = customer_id
       @id = id
       @interval = interval
+      @metadata = metadata
       @price_id = price_id
       @product_id = product_id
       @status = status
+      @trial_end = trial_end
+      @trial_start = trial_start
       freeze
     end
 
@@ -645,9 +1683,67 @@ module Perata
         customer_id: data.fetch("customer_id"),
         id: data.fetch("id"),
         interval: data.fetch("interval"),
+        metadata: data.fetch("metadata"),
         price_id: data.fetch("price_id"),
         product_id: data.fetch("product_id"),
-        status: data.fetch("status")
+        status: data.fetch("status"),
+        trial_end: data["trial_end"],
+        trial_start: data["trial_start"]
+      )
+    end
+  end
+
+  # WebhookBenefit is a resource of Peráta's API.
+  class WebhookBenefit < Model
+    MEMBERS = %i[created_at description id modified_at name status type visibility].freeze
+
+    # @return [String]
+    attr_reader :created_at
+
+    # @return [String]
+    attr_reader :description
+
+    # @return [String]
+    attr_reader :id
+
+    # @return [String]
+    attr_reader :modified_at
+
+    # @return [String]
+    attr_reader :name
+
+    # @return [String ("active", "archived")]
+    attr_reader :status
+
+    # @return [String]
+    attr_reader :type
+
+    # @return [String ("public", "private")]
+    attr_reader :visibility
+
+    def initialize(created_at:, description:, id:, modified_at:, name:, status:, type:, visibility:)
+      @created_at = created_at
+      @description = description
+      @id = id
+      @modified_at = modified_at
+      @name = name
+      @status = status
+      @type = type
+      @visibility = visibility
+      freeze
+    end
+
+    # Builds a WebhookBenefit from the API's JSON.
+    def self.from_hash(data)
+      new(
+        created_at: data.fetch("created_at"),
+        description: data.fetch("description"),
+        id: data.fetch("id"),
+        modified_at: data.fetch("modified_at"),
+        name: data.fetch("name"),
+        status: data.fetch("status"),
+        type: data.fetch("type"),
+        visibility: data.fetch("visibility")
       )
     end
   end
@@ -728,6 +1824,180 @@ module Perata
     end
   end
 
+  # WebhookDelivery is a resource of Peráta's API.
+  class WebhookDelivery < Model
+    MEMBERS = %i[attempts created_at endpoint_id event_id event_type id last_attempt_at last_error max_attempts next_attempt_at response_status status].freeze
+
+    # @return [Integer]
+    attr_reader :attempts
+
+    # @return [String]
+    attr_reader :created_at
+
+    # @return [String]
+    attr_reader :endpoint_id
+
+    # @return [String]
+    attr_reader :event_id
+
+    # @return [String]
+    attr_reader :event_type
+
+    # @return [String]
+    attr_reader :id
+
+    # @return [String, nil]
+    attr_reader :last_attempt_at
+
+    # @return [String]
+    attr_reader :last_error
+
+    # @return [Integer]
+    attr_reader :max_attempts
+
+    # @return [String, nil]
+    attr_reader :next_attempt_at
+
+    # O status HTTP da última resposta; nulo quando não houve.
+    # @return [Integer, nil]
+    attr_reader :response_status
+
+    # pending enquanto é repetida; exhausted quando todas as tentativas falharam.
+    # @return [String ("pending", "succeeded", "exhausted")]
+    attr_reader :status
+
+    def initialize(attempts:, created_at:, endpoint_id:, event_id:, event_type:, id:, last_attempt_at:, last_error:, max_attempts:, next_attempt_at:, response_status:, status:)
+      @attempts = attempts
+      @created_at = created_at
+      @endpoint_id = endpoint_id
+      @event_id = event_id
+      @event_type = event_type
+      @id = id
+      @last_attempt_at = last_attempt_at
+      @last_error = last_error
+      @max_attempts = max_attempts
+      @next_attempt_at = next_attempt_at
+      @response_status = response_status
+      @status = status
+      freeze
+    end
+
+    # Builds a WebhookDelivery from the API's JSON.
+    def self.from_hash(data)
+      new(
+        attempts: data.fetch("attempts"),
+        created_at: data.fetch("created_at"),
+        endpoint_id: data.fetch("endpoint_id"),
+        event_id: data.fetch("event_id"),
+        event_type: data.fetch("event_type"),
+        id: data.fetch("id"),
+        last_attempt_at: data["last_attempt_at"],
+        last_error: data.fetch("last_error"),
+        max_attempts: data.fetch("max_attempts"),
+        next_attempt_at: data["next_attempt_at"],
+        response_status: data["response_status"],
+        status: data.fetch("status")
+      )
+    end
+  end
+
+  # WebhookDiscount is a resource of Peráta's API.
+  class WebhookDiscount < Model
+    MEMBERS = %i[amount_cents basis_points code created_at currency duration duration_in_months ends_at id max_redemptions modified_at name redemptions_count starts_at status type].freeze
+
+    # Valor fixo em centavos, quando o tipo é fixed.
+    # @return [Integer]
+    attr_reader :amount_cents
+
+    # Percentual em pontos-base, quando o tipo é percentage.
+    # @return [Integer]
+    attr_reader :basis_points
+
+    # @return [String, nil]
+    attr_reader :code
+
+    # @return [String]
+    attr_reader :created_at
+
+    # @return [String]
+    attr_reader :currency
+
+    # @return [String ("once", "forever", "repeating")]
+    attr_reader :duration
+
+    # @return [Integer]
+    attr_reader :duration_in_months
+
+    # @return [String, nil]
+    attr_reader :ends_at
+
+    # @return [String]
+    attr_reader :id
+
+    # @return [Integer, nil]
+    attr_reader :max_redemptions
+
+    # @return [String]
+    attr_reader :modified_at
+
+    # @return [String]
+    attr_reader :name
+
+    # @return [Integer]
+    attr_reader :redemptions_count
+
+    # @return [String]
+    attr_reader :starts_at
+
+    # @return [String ("active", "expired", "exhausted", "archived")]
+    attr_reader :status
+
+    # @return [String ("percentage", "fixed")]
+    attr_reader :type
+
+    def initialize(amount_cents:, basis_points:, code:, created_at:, currency:, duration:, duration_in_months:, ends_at:, id:, max_redemptions:, modified_at:, name:, redemptions_count:, starts_at:, status:, type:)
+      @amount_cents = amount_cents
+      @basis_points = basis_points
+      @code = code
+      @created_at = created_at
+      @currency = currency
+      @duration = duration
+      @duration_in_months = duration_in_months
+      @ends_at = ends_at
+      @id = id
+      @max_redemptions = max_redemptions
+      @modified_at = modified_at
+      @name = name
+      @redemptions_count = redemptions_count
+      @starts_at = starts_at
+      @status = status
+      @type = type
+      freeze
+    end
+
+    # Builds a WebhookDiscount from the API's JSON.
+    def self.from_hash(data)
+      new(
+        amount_cents: data.fetch("amount_cents"),
+        basis_points: data.fetch("basis_points"),
+        code: data["code"],
+        created_at: data.fetch("created_at"),
+        currency: data.fetch("currency"),
+        duration: data.fetch("duration"),
+        duration_in_months: data.fetch("duration_in_months"),
+        ends_at: data["ends_at"],
+        id: data.fetch("id"),
+        max_redemptions: data["max_redemptions"],
+        modified_at: data.fetch("modified_at"),
+        name: data.fetch("name"),
+        redemptions_count: data.fetch("redemptions_count"),
+        starts_at: data.fetch("starts_at"),
+        status: data.fetch("status"),
+        type: data.fetch("type")
+      )
+    end
+  end
+
   # WebhookDispute is a resource of Peráta's API.
   class WebhookDispute < Model
     MEMBERS = %i[amount_cents currency customer_id decided_at due_by id invoice_id opened_at payment_id provider_dispute_id provider_reason reason source status].freeze
@@ -818,4 +2088,124 @@ module Perata
       )
     end
   end
+
+  # WebhookEndpoint is a resource of Peráta's API.
+  class WebhookEndpoint < Model
+    MEMBERS = %i[consecutive_failures created_at description events format id status url].freeze
+
+    # @return [Integer]
+    attr_reader :consecutive_failures
+
+    # @return [String]
+    attr_reader :created_at
+
+    # Como o lojista chama o endpoint; sem ele, o domínio do endereço.
+    # @return [String]
+    attr_reader :description
+
+    # Os eventos de que o endpoint é avisado, em ordem alfabética.
+    # @return [Array<String>]
+    attr_reader :events
+
+    # O corpo da mensagem; o que o endereço indica quando não é dito.
+    # @return [String ("raw", "discord", "slack")]
+    attr_reader :format
+
+    # @return [String]
+    attr_reader :id
+
+    # @return [String ("active", "disabled")]
+    attr_reader :status
+
+    # Endereço https para onde as mensagens são enviadas.
+    # @return [String]
+    attr_reader :url
+
+    def initialize(consecutive_failures:, created_at:, description:, events:, format:, id:, status:, url:)
+      @consecutive_failures = consecutive_failures
+      @created_at = created_at
+      @description = description
+      @events = events
+      @format = format
+      @id = id
+      @status = status
+      @url = url
+      freeze
+    end
+
+    # Builds a WebhookEndpoint from the API's JSON.
+    def self.from_hash(data)
+      new(
+        consecutive_failures: data.fetch("consecutive_failures"),
+        created_at: data.fetch("created_at"),
+        description: data.fetch("description"),
+        events: data.fetch("events"),
+        format: data.fetch("format"),
+        id: data.fetch("id"),
+        status: data.fetch("status"),
+        url: data.fetch("url")
+      )
+    end
+  end
+
+  # WebhookEndpointCreated is a resource of Peráta's API.
+  class WebhookEndpointCreated < Model
+    MEMBERS = %i[consecutive_failures created_at description events format id secret status url].freeze
+
+    # @return [Integer]
+    attr_reader :consecutive_failures
+
+    # @return [String]
+    attr_reader :created_at
+
+    # @return [String]
+    attr_reader :description
+
+    # @return [Array<String>]
+    attr_reader :events
+
+    # @return [String ("raw", "discord", "slack")]
+    attr_reader :format
+
+    # @return [String]
+    attr_reader :id
+
+    # O segredo (whsec_…) com que as mensagens são assinadas. Só esta resposta o traz; na repetição da criação sob a mesma Idempotency-Key vem vazio.
+    # @return [String]
+    attr_reader :secret
+
+    # @return [String ("active", "disabled")]
+    attr_reader :status
+
+    # @return [String]
+    attr_reader :url
+
+    def initialize(consecutive_failures:, created_at:, description:, events:, format:, id:, secret:, status:, url:)
+      @consecutive_failures = consecutive_failures
+      @created_at = created_at
+      @description = description
+      @events = events
+      @format = format
+      @id = id
+      @secret = secret
+      @status = status
+      @url = url
+      freeze
+    end
+
+    # Builds a WebhookEndpointCreated from the API's JSON.
+    def self.from_hash(data)
+      new(
+        consecutive_failures: data.fetch("consecutive_failures"),
+        created_at: data.fetch("created_at"),
+        description: data.fetch("description"),
+        events: data.fetch("events"),
+        format: data.fetch("format"),
+        id: data.fetch("id"),
+        secret: data.fetch("secret"),
+        status: data.fetch("status"),
+        url: data.fetch("url")
+      )
+    end
+  end
 end