# `LatticeStripe.EventNotification.RelatedObject`
[🔗](https://github.com/szTheory/lattice_stripe/blob/v2.2.2/lib/lattice_stripe/event_notification/related_object.ex#L1)

Represents the `related_object` sub-resource referenced by a Stripe thin-event
notification (or a v2-fetched `%LatticeStripe.Event{}`).

Thin-event notifications point at the underlying resource (e.g. an account, customer,
invoice) without embedding the full snapshot. Adopters pattern-match this sub-struct
to dispatch to typed fetchers via `LatticeStripe.Webhook.fetch_related_object/3`.

## Fields

- `id` — Stripe ID of the related resource (e.g., `"acct_1T93Q4Pmpb34Vto6"`)
- `type` — Stripe object type string (e.g., `"v2.core.account"`, `"customer"`)
- `url` — Relative API path to fetch the resource (e.g., `"/v2/core/accounts/acct_..."`)
- `extra` — Unknown fields from Stripe not yet in this struct

This sub-struct is the **single source of truth** for `related_object` on both
`LatticeStripe.EventNotification.t()` and `LatticeStripe.Event.t()`. The same
module is decoded from both wire shapes.

## Stripe API Reference

See the [Stripe thin-event payload](https://docs.stripe.com/event-destinations)
for field definitions.

# `t`

```elixir
@type t() :: %LatticeStripe.EventNotification.RelatedObject{
  extra: map(),
  id: String.t() | nil,
  type: String.t() | nil,
  url: String.t() | nil
}
```

A `related_object` reference on a Stripe thin-event payload.

# `from_map`

```elixir
@spec from_map(map() | nil) :: t() | nil
```

Converts a decoded Stripe API map to a `%RelatedObject{}` struct.

Returns `nil` when given `nil` — this is load-bearing because parent decoders
(`EventNotification.from_map/1`, `Event.from_map/1`) call this function
unconditionally on the `"related_object"` map key, which may be absent.

Maps all known fields. Any unrecognized fields are collected into `extra` so
no data is silently lost. Always succeeds (infallible) for map inputs.

## Example

    iex> LatticeStripe.EventNotification.RelatedObject.from_map(%{
    ...>   "id" => "acct_1T93Q4Pmpb34Vto6",
    ...>   "type" => "v2.core.account",
    ...>   "url" => "/v2/core/accounts/acct_1T93Q4Pmpb34Vto6"
    ...> })
    %LatticeStripe.EventNotification.RelatedObject{
      id: "acct_1T93Q4Pmpb34Vto6",
      type: "v2.core.account",
      url: "/v2/core/accounts/acct_1T93Q4Pmpb34Vto6",
      extra: %{}
    }

---

*Consult [api-reference.md](api-reference.md) for complete listing*