> Documentation index: [Saleor](/llms.txt) · [This section](/api-reference/payments/llms.txt)
> Source: https://docs.saleor.io/api-reference/payments/mutations/transaction-event-report

# transactionEventReport Mutation

Report the event for the transaction.

Requires the following permissions: OWNER HANDLE\_PAYMENTS for apps HANDLE\_PAYMENTS for staff users

Staff user cannot update a transaction that is owned by the app.

Triggers the following webhook events:

-   TRANSACTION\_ITEM\_METADATA\_UPDATED (async): Optionally called when transaction's metadata was updated.
-   CHECKOUT\_FULLY\_PAID (async): Optionally called when the checkout charge status changed to `FULL` or `OVERCHARGED`.
-   ORDER\_UPDATED (async): Optionally called when the transaction is related to the order and the order was updated.

```graphql
transactionEventReport(
  amount: PositiveDecimal
  availableActions: [TransactionActionEnum!]
  externalUrl: String
  id: ID
  message: String
  paymentMethodDetails: PaymentMethodDetailsInput
  pspReference: String!
  time: DateTime
  token: UUID
  transactionMetadata: [MetadataInput!]
  transactionPrivateMetadata: [MetadataInput!]
  type: TransactionEventTypeEnum!
): TransactionEventReport
```

Details

```graphql
type TransactionEventReport {
  alreadyProcessed: Boolean
  transaction: TransactionItem
  transactionEvent: TransactionEvent
  errors: [TransactionEventReportError!]!
}
```

<a id="arguments"></a>

### Arguments

<a id="amount"></a>

#### [`amount`](#amount) ● [`PositiveDecimal`](/api-reference/miscellaneous/scalars/positive-decimal.md)

The amount of the event to report.

Required for all `REQUEST`, `SUCCESS`, `ACTION_REQUIRED`, and `ADJUSTMENT` events. For other events, the amount will be calculated based on the previous events with the same pspReference. If not possible to calculate, the mutation will return an error.

<a id="available-actions"></a>

#### [`availableActions`](#available-actions) ● [`[TransactionActionEnum!]`](/api-reference/payments/enums/transaction-action-enum.md)

List of all possible actions for the transaction

<a id="external-url"></a>

#### [`externalUrl`](#external-url) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

The url that will allow to redirect user to payment provider page with event details.

<a id="id"></a>

#### [`id`](#id) ● [`ID`](/api-reference/miscellaneous/scalars/id.md)

The ID of the transaction. One of field id or token is required.

<a id="message"></a>

#### [`message`](#message) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

The message related to the event. The maximum length is 512 characters; any text exceeding this limit will be truncated.

<a id="payment-method-details"></a>

#### [`paymentMethodDetails`](#payment-method-details) ● [`PaymentMethodDetailsInput`](/api-reference/miscellaneous/inputs/payment-method-details-input.md)

Details of the payment method used for the transaction.

Added in Saleor 3.22

<a id="psp-reference"></a>

#### [`pspReference`](#psp-reference) ● [`String!`](/api-reference/miscellaneous/scalars/string.md)

PSP Reference of the event to report.

<a id="time"></a>

#### [`time`](#time) ● [`DateTime`](/api-reference/miscellaneous/scalars/date-time.md)

The time of the event to report. If not provide, the current time will be used.

<a id="token"></a>

#### [`token`](#token) ● [`UUID`](/api-reference/miscellaneous/scalars/uuid.md)

The token of the transaction. One of field id or token is required.

<a id="transaction-metadata"></a>

#### [`transactionMetadata`](#transaction-metadata) ● [`[MetadataInput!]`](/api-reference/miscellaneous/inputs/metadata-input.md)

Fields required to update the transaction metadata. Can be read by any API client authorized to read the object it's attached to.

Warning: never store sensitive information, including financial data such as credit card details.

<a id="transaction-private-metadata"></a>

#### [`transactionPrivateMetadata`](#transaction-private-metadata) ● [`[MetadataInput!]`](/api-reference/miscellaneous/inputs/metadata-input.md)

Fields required to update the transaction private metadata.

Requires permissions to modify and to read the metadata of the object it's attached to.

Warning: never store sensitive information, including financial data such as credit card details.

<a id="type"></a>

#### [`type`](#type) ● [`TransactionEventTypeEnum!`](/api-reference/payments/enums/transaction-event-type-enum.md)

Current status of the event to report.

<a id="type"></a>

### Type

<a id="transactioneventreport"></a>

#### [`TransactionEventReport`](/api-reference/payments/objects/transaction-event-report.md)

Report the event for the transaction.

Requires the following permissions: OWNER HANDLE\_PAYMENTS for apps HANDLE\_PAYMENTS for staff users

Staff user cannot update a transaction that is owned by the app.

Triggers the following webhook events:

-   TRANSACTION\_ITEM\_METADATA\_UPDATED (async): Optionally called when transaction's metadata was updated.
-   CHECKOUT\_FULLY\_PAID (async): Optionally called when the checkout charge status changed to `FULL` or `OVERCHARGED`.
-   ORDER\_UPDATED (async): Optionally called when the transaction is related to the order and the order was updated.