---
# @generated by sylphx-gen. Do not edit.
title: "Processor events"
description: "The `processor_events` collection of Sylphx Money: A stored Stripe hint."
type: reference
product: payments
summary: "A stored Stripe hint."
updated: 2026-09-28
order: 900
---

A stored Stripe hint. No payload, customer details, credential or raw error is returned. Recovery never creates a grant or writes a ledger entry: retry schedules the existing authenticated, idempotent application path.

**Service** Sylphx Money · **Resource type** `money.sylphx.com/ProcessorEvent` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/processor_events/{processor_event}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | Name; the final segment is Stripe's event id. |
| `uid` | `string` | Stable, server-derived id. Output only. |
| `meta` | `ResourceMeta` | Metadata; meta.etag is required on recovery calls. Output only. |
| `account_id` | `string` | Stripe account id, never the customer's identity. Output only. |
| `event_type` | `string` | Stripe event type. Output only. |
| `object_id` | `string` | Stripe object id (not a payload). Output only. |
| `state` | `string` | `pending`, `held`, `applied` or `dismissed`. Output only. |
| `hold_reason` | `string` | `processor_permission_denied`, `attempts_exhausted`, or empty. Output only. |
| `attempts` | `int32` | Number of failed application attempts. Output only. |
| `livemode` | `bool` | Whether the owning merchant is live. Read only when mode_known is true. Output only. |
| `mode_known` | `bool` | False when the owning merchant cannot be resolved; never assumes test. Output only. |
| `last_recovery` | `ProcessorEventRecovery` | Last audited recovery decision, if any. Full history is retained. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/processor_events#get) | Gets one stored processor hint, with its safe hold reason. |
| `GET` | [`list`](/docs/api/processor_events#list) | Lists stored processor hints; defaults to held events. |
| `POST` | [`retry`](/docs/api/processor_events#retry) | Schedules a held event through the existing idempotent application path. The decision is audited; an etag is required. |
| `POST` | [`dismiss`](/docs/api/processor_events#dismiss) | Dismisses only a held test-mode payout observation, retaining the row and audit. Live, unknown-mode and payment events are refused. |

## get

Gets one stored processor hint, with its safe hold reason.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/processor_events/processor-event` · scope `billing:processor_events:read` · effect `read` · [Request, response and examples](/docs/api/processor_events/get)

## list

Lists stored processor hints; defaults to held events.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/processor_events` · scope `billing:processor_events:read` · effect `read` · paginated · [Request, response and examples](/docs/api/processor_events/list)

## retry

Schedules a held event through the existing idempotent application path. The decision is audited; an etag is required.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/processor_events/processor-event:retry` · scope `billing:processor_events:write` · effect `write` · [Request, response and examples](/docs/api/processor_events/retry)

## dismiss

Dismisses only a held test-mode payout observation, retaining the row and audit. Live, unknown-mode and payment events are refused.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/processor_events/processor-event:dismiss` · scope `billing:processor_events:write` · effect `write` · [Request, response and examples](/docs/api/processor_events/dismiss)