> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Transactions

# Type: Transaction Object

# Link: https://dev.wix.com/docs/api-reference/business-solutions/benefit-programs/transactions/transaction-object.md

## Description: A transaction is a record of a change to a balance.

## Schema:

```json
 Type: Transaction Object | type: Transaction
 Description: A transaction is a record of a change to a balance.
       - name: id  | type: string | description: Transaction ID.
           - name: value  | type: string | description: 
       - name: revision  | type: string | description: Revision number, which increments by 1 each time the transaction is updated.
           - name: value  | type: string | description: 
       - name: createdDate  | type: string | description: Date and time the transaction was created.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the transaction was updated.
       - name: pool  | type: PoolInfo | description: Pool associated with this transaction.
           - name: id  | type: string | description: Pool ID.
           - name: poolDefinitionId  | type: string | description: ID of the pool definition the pool was created from.
           - name: programDefinitionId  | type: string | description: ID of the program definition containing the pool definition the pool was created from.
           - name: externalProgramDefinitionId  | type: string | description: External ID of the program definition the pool was created from.
           - name: programId  | type: string | description: ID of the program that contains the pool.
           - name: externalProgramId  | type: string | description: External ID of the program that contains the pool.
           - name: creditAmount  | type: string | description: Available credits.
           - name: namespace  | type: string | description: Namespace for your app or site's benefit programs. Namespaces allow you to distinguish between entities that you created and entities that other apps created.
           - name: displayName  | type: string | description: Pool name
           - name: benefitDisplayName  | type: string | description: Benefit name
       - name: amount  | type: string | description: Amount the balance was adjusted in this transaction.
       - name: source  | type: string | description: Where the credits came from.
           enum: AVAILABLE, EXTERNAL
       - name: target  | type: string | description: Where the credits went to.
       - name: idempotencyKey  | type: string | description: Unique identifier, generated by the client. Used to recognize repeated attempts to make the same request.
       - name: relatedTransactionId  | type: string | description: ID of the related transaction. For example, if this transaction is a refund for a benefit redemption, the related transaction is the benefit redemption transaction.
       - name: beneficiary  | type: IdentificationData | description: Beneficiary of the pool associated with this transaction.
       - name: instructingParty  | type: IdentificationData | description: Identity that created the transaction.
       - name: status  | type: string | description: Transaction status.
           enum: PENDING, COMPLETED, FAILED
       - name: details  | type: TransactionDetails | description: Additional transaction details.
           - name: item  | type: Item | description: Item associated with the transaction.
               - name: id  | type: string | description: Item ID.
               - name: externalId  | type: string | description: Item external ID.
               - name: category  | type: string | description: Item category.
               - name: itemSetId  | type: string | description: Item set ID.
               - name: displayName  | type: string | description: Item name.
               - name: providerAppId  | type: string | description: Provider app id
           - name: itemCount  | type: number | description: Amount of items associated with the transaction.
               - name: value  | type: number | description: 
           - name: effectiveDate  | type: string | description: Date and time the transaction was created.
           - name: reason  | type: string | description: Reason for the transaction. For example, `Redemption`.
           - name: benefitKey  | type: string | description: Benefit key associated with the transaction.
       - name: extendedFields  | type: ExtendedFields | description: Custom field data for the transaction object.  [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions.md) must be configured in the app dashboard before they can be accessed with API calls.
           - name: namespaces  | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md).
       - name: externalId  | type: string | description: External transaction ID.

```