--- title: AppRevenueAttributionRecord - GraphQL Admin description: >- Tracks revenue that was captured outside of Shopify's billing system but needs to be attributed to the app for comprehensive revenue reporting and partner analytics. This object enables accurate revenue tracking when apps process payments through external systems while maintaining visibility into total app performance. External revenue attribution is essential for apps that offer multiple payment channels or process certain transactions outside Shopify's billing infrastructure. For example, an enterprise app might process large custom contracts through external payment processors, or a marketplace app could handle direct merchant-to-merchant transactions that still generate app commissions. Use the `AppRevenueAttributionRecord` object to: - Report revenue from external payment processors and billing systems - Track commission-based earnings from marketplace or referral activities - Maintain comprehensive revenue analytics across multiple payment channels - Ensure accurate partner revenue sharing and commission calculations - Generate complete financial reports that include all app-generated revenue streams - Support compliance requirements for external revenue documentation Each attribution record includes the captured amount, external transaction timestamp, and idempotency keys to prevent duplicate reporting. The record type field categorizes different revenue streams, enabling detailed analytics and reporting segmentation. Revenue attribution records are particularly important for apps participating in Shopify's partner program, as they ensure accurate revenue sharing calculations and comprehensive performance metrics. The captured timestamp reflects when the external payment was processed, not when the attribution record was created in Shopify. For detailed revenue attribution values, see the [AppRevenueAttributionType enum](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppRevenueAttributionType). api_version: 2026-10 source_url: html: >- https://shopify.dev/docs/api/admin-graphql/latest/objects/AppRevenueAttributionRecord md: >- https://shopify.dev/docs/api/admin-graphql/latest/objects/AppRevenueAttributionRecord.md api_name: admin api_type: graphql type: object --- # App​Revenue​Attribution​Record object Requires Access allowed for apps with `app_attributions` scope using offline tokens only. This API is under a private program and is not available to all partners. Tracks revenue that was captured outside of Shopify's billing system but needs to be attributed to the app for comprehensive revenue reporting and partner analytics. This object enables accurate revenue tracking when apps process payments through external systems while maintaining visibility into total app performance. External revenue attribution is essential for apps that offer multiple payment channels or process certain transactions outside Shopify's billing infrastructure. For example, an enterprise app might process large custom contracts through external payment processors, or a marketplace app could handle direct merchant-to-merchant transactions that still generate app commissions. Use the `AppRevenueAttributionRecord` object to: * Report revenue from external payment processors and billing systems * Track commission-based earnings from marketplace or referral activities * Maintain comprehensive revenue analytics across multiple payment channels * Ensure accurate partner revenue sharing and commission calculations * Generate complete financial reports that include all app-generated revenue streams * Support compliance requirements for external revenue documentation Each attribution record includes the captured amount, external transaction timestamp, and idempotency keys to prevent duplicate reporting. The record type field categorizes different revenue streams, enabling detailed analytics and reporting segmentation. Revenue attribution records are particularly important for apps participating in Shopify's partner program, as they ensure accurate revenue sharing calculations and comprehensive performance metrics. The captured timestamp reflects when the external payment was processed, not when the attribution record was created in Shopify. For detailed revenue attribution values, see the [AppRevenueAttributionType enum](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppRevenueAttributionType). ## Fields * amount [Money​V2!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2) non-null The financial amount captured in this attribution. * captured​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The timestamp when the financial amount was captured. * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The timestamp at which this revenue attribution was issued. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * idempotency​Key [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The unique value submitted during the creation of the app revenue attribution record. For more information, refer to [Idempotent requests](https://shopify.dev/api/usage/idempotent-requests). * test [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Indicates whether this is a test submission. * type [App​Revenue​Attribution​Type!](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppRevenueAttributionType) non-null The type of revenue attribution. *** ## Map ### Fields and connections with this object * [AppInstallation.revenueAttributionRecords](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation#field-AppInstallation.fields.revenueAttributionRecords) * [AppRevenueAttributionRecordConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/AppRevenueAttributionRecordConnection#returns-nodes) * [AppRevenueAttributionRecordEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppRevenueAttributionRecordEdge#field-AppRevenueAttributionRecordEdge.fields.node) *** ## Interfaces * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## AppRevenueAttributionRecord Implements ### Implements * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)