# Skerry: events

- `customer.updated`: Verification status, requirements or any can-flag changed.
- `customer.verified`: Business verification completed.
- `customer.rejected`: Business verification was declined.
- `checkout_session.completed`: A payer finished a checkout session.
- `checkout_session.expired`: A checkout session expired unpaid.
- `payment.requires_action`: The payer must authenticate before the payment can proceed.
- `payment.processing`: The payer has paid by a method that settles later, such as a bank debit. Wait for payment.succeeded or payment.failed.
- `payment.authorized`: Funds are held and waiting to be captured.
- `payment.succeeded`: Funds were collected.
- `payment.failed`: The payment was declined or failed.
- `payment.canceled`: An authorisation was released before capture.
- `payment.refunded`: A payment was refunded, wholly or in part. Read `data.status` to tell which: `refunded` or `partially_refunded`.
- `payment.disputed`: The payer's bank opened a dispute.
- `dispute.updated`: A dispute moved: evidence due, under review, won or lost.
- `refund.updated`: A refund changed state.
- `payment_method.saved`: A payer saved a method for later charges.
- `settlement.created`: Card proceeds were sent towards the business's bank.
- `settlement.paid`: A settlement arrived.
- `settlement.failed`: A settlement failed.
- `subscription.updated`: A subscription was created or changed.
- `subscription.canceled`: A subscription ended.
- `subscription.payment_succeeded`: A recurring charge collected.
- `subscription.payment_failed`: A recurring charge failed.
- `payout.created`: A payout was created.
- `payout.processing`: A payout's funds were received and it is on its way.
- `payout.on_hold`: A payout is paused: it is being checked, or information has been asked for.
- `payout.canceled`: A payout was canceled before it left.
- `payout.updated`: A payout changed state.
- `payout.paid`: A payout reached its destination.
- `payout.returned`: A payout came back.
- `account.credited`: Money arrived in a customer's account.
- `conversion.completed`: A conversion settled.
- `wallet.created`: A wallet was created for a customer.
- `payee.created`: A payee was added.
- `payee.updated`: A payee changed: paused, resumed, or its name check came back.
- `payee.removed`: A payee was removed.
- `standing_order.created`: A standing conversion was created.
- `standing_order.updated`: A standing conversion changed state.
- `standing_order.drained`: Money that arrived at a standing conversion's address was converted and sent on.
- `compliance_request.created`: Information was asked for about a customer or a payment, with a deadline.
- `compliance_request.updated`: A compliance request changed: answered, under review, or closed.
- `deposit.unmatched`: Money arrived that could not be credited to a checkout session: the wrong coin or chain, no known reference, or after the session expired. A person assigns it or sends it back.
- `deposit.resolved`: An unmatched deposit was assigned to a session, or sent back.
- `agentic.refund_requested`: An agent asked for a refund that a person must approve.
- `approval.requested`: An operation is held for a person to approve.
- `approval.decided`: A held operation was approved or denied.
- `spend_policy.revoked`: A spend policy was revoked.
- `budget.low`: A budget fell under its `low_below` mark. Sent once until the budget is topped up.
- `budget.exhausted`: Nothing remains of a budget. Sent once until the budget is topped up.
- `balance.low`: A wallet's balance fell under its floor. Sent once until the balance has been back at or above it.
- `payout.scheduled`: A payout was set to run later: at a time, on an interval, or when an event arrives or a person releases it.
- `payout.released`: A conditional payout was released, by the event it waited for or by a person, and runs now.
- `payout.schedule_canceled`: A scheduled payout was cancelled: by request, because it lapsed, or because the key, agent, mandate or customer behind it may no longer send money. Carries the reason.
- `movement.pending`: Money is in flight: a payout, a conversion or a deposit has started and not yet settled. Carries the receipt.
- `movement.posted`: A movement settled in the customer's books. Carries the signed receipt.
- `movement.reversed`: A movement failed or came back. Carries the receipt of the reversal, which names the movement it undoes.
- `agent.created`: An agent was registered, directly or by delegation.
- `agent.updated`: An agent's details or signing keys changed, or a suspended agent was resumed.
- `agent.suspended`: An agent was suspended: its keys, tokens and policies stop working until it is resumed.
- `agent.revoked`: An agent was revoked, permanently, together with every agent it delegated to.
- `agent_wallet.created`: A wallet was created for an agent to sign payments from.
- `agent_wallet.retired`: An agent's wallet was retired: nothing is signed with it again. Funds at its address are not moved.
- `agent_payment.created`: An agent's payment to a merchant passed every check and is being paid.
- `agent_payment.paid`: A merchant accepted an agent's payment.
- `agent_payment.failed`: An agent's payment was decided and not completed: the signing failed, or the merchant did not answer the paid request with success. `signed` says whether a signature or token was produced.
- `agent_payment.refused`: An agent's payment was refused before anything was signed: by a control, a mandate, or because the merchant asked for more than the ceiling or for something that cannot be paid.
- `agent_payment.held`: An agent's payment is waiting for a person to approve it. An `approval.requested` event carries the approval.
- `customer.frozen`: Money movement was frozen for a customer.
- `customer.unfrozen`: A customer's freeze was lifted.
- `partner.frozen`: Money movement was frozen for the whole account in this environment.
- `partner.unfrozen`: The account's freeze was lifted.
