> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/docs/platform/extensibility/mediation/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Mediation

## Docs

- [Mediation overview](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/mediation.md): Mediation simplifies the loading of service consumption events into Zuora by automating data processing steps, enabling effortless, reliable, and cost-effective consumption-based billing.
- [Meters overview](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/meters-overview.md): A meter quantifies customer activity into structured usage records for billing, tracking usage like CPU hours or data transferred.
- [Streaming and batch meters](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/streaming-and-batch-meters.md): Streaming and batch meters allow you to process either continuously arriving events or a finite set of input data in Zuora Mediation.
- [Meter statuses](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/meter-statuses.md): Understand meter run statuses.
- [Create a meter based on a meter type](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/create-a-meter-based-on-meter-type.md): Create a meter using predefined types that send results to Zuora Billing.
- [Create a custom meter](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/create-custom-meter.md): Create a custom meter by using available components to meet specific business process requirements.
- [Audit Trail for meter runs](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/audit-trail-for-meter-runs.md): The audit trail for meter runs provides detailed logs of changes, segregated into live and test runs, accessible under the Audit Trail>Runs section.
- [Audit Trail for meter errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/audit-trail-for-meter-errors.md): Learn how to use audit trails to track and filter meter errors by timeframe, session ID, and error category.
- [Export error records](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/audit-trail-for-meter-errors/export-error-records.md): Learn how to export and download meter run error records, including large datasets that exceed the inline download limit of 100,000 rows.
- [Download Center](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/audit-trail-for-meter-errors/download-center.md): All large error exports are visible in the centralized Download Center, which lets you monitor export jobs and download files when they are ready.
- [Stop a meter](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/stop-a-meter.md): Stop a running meter gracefully or immediately by using the API.
- [Prefetch in Mediation](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/prefetch-in-mediation.md): Prefetch in Mediation copies relevant Zuora Billing and product data into Mediation's internal store so that meters can enrich and process usage events quickly and accurately.
- [Check and refresh prefetch data](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/prefetch-in-mediation/check-and-refresh-prefetch-data-for-enrichment.md): Learn how to check the status of prefetched data used by the Enrichment processor and how to trigger a manual prefetch when you need an immediate update.
- [View prefetch history](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/prefetch-in-mediation/view-prefetch-history.md): Learn how to view the prefetch history for Enrichment processors, including details on automatic and manual runs and their status.
- [Metering APIs](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/metering-apis.md): The Metering APIs provide insights into success/failure metrics, record-level details, and guidance for next steps, supporting backend integration and data analysis.
- [Retrieve summary data API](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/metering-apis/summary-api.md): The summary API gives you a rolled-up view of a run or time window.
- [Retrieve audit trail entries API](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/metering-apis/audit-trail-entries-api.md): The audit trail entries API gives you detailed, record-level information about what happened during processing.
- [Create audit trail export job API](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/metering-apis/audit-trail-export-api.md): The audit trail export job API provides large-scale, offline access to audit data.
- [Retrieve audit trail export jobs API](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/metering-apis/list-audit-trail-export-api.md): This API lists the export jobs that you previously initiated.
- [Retrieve presigned download URL API](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/metering-apis/presigned-download-url-api.md): Once an export job is finished, it produces one or more files, such as CSV files, and returns file keys. This API converts those file keys into time-limited download URLs.
- [Example workflow](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/metering-apis/example-workflow.md): An example of how these APIs work together.
- [Runtime configuration for meter runs](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meters/metering-apis/runtime-configuration-for-meter-runs.md): Runtime configuration lets you change the input source for a single meter run without modifying the stored meter definition or creating a new version. Runtime overrides apply only to the current run. The stored meter definition remains unchanged.
- [Events overview](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/events-overview.md): An overview of event data management, including ingestion, mediation, and analysis through the events dashboard.
- [Create an event definition](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/create-event-definition.md): Create and configure event definitions by importing files or manually specifying fields to structure event data.
- [Events Dashboard](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/events-dashboard.md): The Events Dashboard in Zuora Mediation provides a consolidated, filterable view to monitor event volumes, track key metrics, ingestion successes versus errors, and to investigate issues across your meters.
- [Ingestion source analysis](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/events-ingested.md): There are different ingestion options available in Zuora Mediation. Each method is suitable for different use cases, based on latency, volume, infrastructure complexity, and operational needs.
- [Event Store](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/event-store-mediation.md): The Event Store is a versatile data storage solution in the mediation system, enabling data ingestion, storage, and processing for various scenarios such as multi-region data collection, time-shifted processing, and data validation.
- [Configure an Event Store as a source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/event-store-mediation/to-create-a-meter-with-event-store-as-the-source-follow-the-instructions-below.md): Learn how to configure an event store as a source for a custom meter.
- [Configure an Event Store as a target](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/event-store-mediation/meter-with-event-store-as-a-target.md): Learn how to configure an Event Store as a target for a custom meter by selecting and mapping event fields.
- [Re-run a meter with an Event Store source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/event-store-mediation/meter-with-event-store-replay.md): Learn how to re-run a custom meter using an event store as a source to process specific events within a date range.
- [Configure a meter with Event Store backfill](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/event-store-mediation/meter-with-event-store-backfill.md): Learn how to backfill event data in a custom meter using an event store to re-populate or recompute meter values.
- [Event store data APIs](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/event-store-mediation/query-metering-events-with-event-store-data-apis.md): The event store data APIs let you run SQL-style asynchronous queries against raw metering events stored for a specific meter. Use these APIs to validate event ingestion, troubleshoot metering workflows, perform post‑run reconciliation, and run ad‑hoc queries for QA or analytics.
- [Meter Audit counts and Event Store counts](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/event-store-mediation/meter-audit-counts-and-event-store-counts.md): When a meter reads data from a source such as Amazon S3 and writes it to an Event Store, the counts shown in Meter Audit might not always match the number of records stored in the Event Store.
- [Event Store timezone impact](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/event-store-mediation/event-store-timezone-impact.md): The Event Store uses your tenant timezone to organize, query, and report usage events. Changing the tenant timezone after data has already been ingested can affect how historical and future data is grouped and displayed.
- [Notifications in Mediation](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/notifications-in-mediation.md): Learn how to use notifications in Zuora Mediation to receive alerts about meter runs and Event Store operations, leveraging the Events and Notifications framework.
- [Meter Session Status Change](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/notifications-in-mediation/meter-session-status-change.md): The Meter Session Status Change event triggers when a Mediation meter session changes status.
- [Meter Session Periodic Status Update](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/notifications-in-mediation/meter-session-periodic-status-update.md): The Meter Session Periodic Status Update event generates periodic summaries for a running meter session at the operator level.
- [Event Store Query Status Changed](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/notifications-in-mediation/event-store-query-status-changed.md): The Event Store Query Status Changed event fires when an asynchronous Event Store query changes status.
- [Configure Mediation Notifications](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/events/notifications-in-mediation/configure-mediation-notifications.md): Learn how to configure mediation notifications by defining triggers, selecting events, setting filters, and choosing delivery options.
- [Meter components overview](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/meter-components.md): Meter components are essential for data processing, including source, processor, and target components, each performing specific actions to manage and transform data efficiently.
- [Streaming API as a source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/streaming-api.md): Streaming as an API allows you to send usage events to Zuora in real time through a simple REST API. Instead of uploading batch files, your applications push usage directly to Zuora, where it is validated and processed through Zuora Mediation pipelines.
- [Configure a Streaming API as a source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/streaming-api/streaming-api-as-a-source.md): Create meters using a Streaming API as a source, requiring specific platform roles for access.
- [Configure Amazon S3 as a source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/amazon-s3-as-a-source.md): Learn how to configure a custom meter using an Amazon S3 bucket as the source for event data.
- [Snowflake as a source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/snowflake-as-a-source.md): Use a Snowflake source when you want Mediation to ingest data from Snowflake in batch runs. Each run processes a snapshot of the data available when the run starts.
- [Design queries for Snowflake source runs](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/snowflake-as-a-source/design-queries-for-snowflake-source-runs.md): Design your Snowflake source query so that each run returns only the records you want to process for that run.
- [Schedule and run Snowflake source meters](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/snowflake-as-a-source/design-queries-for-snowflake-source-runs/schedule-and-run-snowflake-source-meters.md): A Snowflake source runs only when a meter run is started.
- [Configure Snowflake as a source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/snowflake-as-a-source/configure-snowflake-as-a-source.md): Create a custom meter using Snowflake as the source for event data by configuring connection settings, selecting event definitions, and adjusting advanced settings.
- [Snowflake configuration parameters](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/snowflake-as-a-source/configure-snowflake-as-a-source/snowflake-configuration-parameters.md): Configure a Snowflake source by selecting the event definition, Snowflake connection, and data retrieval mode, and then optionally overriding connection defaults for the run.
- [Kafka as a source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/kafka-as-a-source.md): Use the Kafka Source operator to read messages from a Kafka topic and ingest them into a Mediation pipeline.
- [Configure Kafka as a source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/kafka-as-a-source/configure-kafka-as-a-source.md): Learn how to configure custom meters to use Apache Kafka as a source, including setting up connections, selecting topics, and configuring data formats.
- [Configure Upload File as a source](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/upload-file-as-a-source.md): Learn how to configure a meter to use upload event or transaction data files, including guidelines for file formats and size limits.
- [Configure Amazon S3 as a target](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/amazon-s3-as-a-target.md): Learn how to configure a custom meter to use an Amazon S3 bucket as the target data store.
- [Configure Snowflake as a target](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/snowflake-as-a-target.md): Create a custom meter using a Snowflake data warehouse as the target by configuring connection, data upload, and advanced settings.
- [Kafka as a target](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/kafka-as-a-target.md): Use the Kafka Target operator to publish processed Mediation events to a Kafka topic.
- [Configure Kafka as a target](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/kafka-as-a-target/configure-kafka-as-a-target.md): Learn how to configure custom meters to use Apache Kafka as a target for data transition in Zuora.
- [Configure Usage Records as a target](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/usage-records-as-a-target.md): Create a custom meter to send output data to usage records by selecting Usage Records as the target and configuring the required settings.
- [Empty Sink](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/empty-sink.md): The Empty Sink operator consumes events, halts processing, and logs records without storing data.
- [Configure Empty Sink as a target](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/sources-and-targets/empty-sink/configure-empty-sink-as-a-target.md): Learn how to configure an Empty Sink as a target to end a branch of a meter flow without sending data externally, while maintaining an audit trail in Mediation.
- [Enrichment processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/enrichment-processor.md): The Enrichment processor in Zuora Mediation adds data to events using methods based on product, account, or identifier attributes.
- [Configure an Enrichment processor (Product or Account data)](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/enrichment-processor/configure-enrichment-processor1.md): Learn how to configure an Enrichment processor to enhance events with product or account data.
- [Configure an Enrichment processor (Standard Identifiers)](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/enrichment-processor/configure-enrichment-processor2.md): Learn how to transform raw usage data into billable rated records by configuring a Rating processor.
- [Filter processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/filter-processor.md): Use the Filter processor to remove unwanted or irrelevant records early in the pipeline so that downstream processors work only on the data you care about.
- [Filter processor operators](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/filter-processor/filter-processor-operators.md): Supported operators for the filter processor.
- [Configure Filter as a processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/filter-processor/filter-as-a-processor.md): Configure a filter processor to control which event records continue through your Mediation pipeline. The filter evaluates each record against the rules you define. Records that meet the conditions pass through to downstream processors. Records that do not match are dropped.
- [Deduplicator processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/deduplicator-processor.md): The Deduplicator processor helps you identify duplicate records in a Mediation pipeline based on all fields or selected fields.
- [Deduplicator behavior in batch and streaming meters](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/deduplicator-processor/deduplicator-batch-stream-meters.md): The Deduplicator behaves differently in streaming meters and batch meters.
- [Deduplicator examples](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/deduplicator-processor/deduplicator-examples.md): Use the following examples to choose a Deduplicator configuration that matches your use case.
- [Configure Deduplicator as a processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/deduplicator-processor/deduplicator-as-a-processor.md): Use the Deduplicator processor to identify duplicate event data in your Mediation pipeline. When the Deduplicator identifies a duplicate record, the record is marked as an error and discarded.
- [Aggregator processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/aggregator-processor.md): The Aggregator is a metering processor that calculates aggregate values over incoming usage events without reducing the number of records.
- [Aggregator operators](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/aggregator-processor/aggregator-operators.md): The Aggregator processor supports several standard operators for computing aggregate values over events in each partition, including sum, avg, min, max, count, and delta.
- [Configure an Aggregator as a processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/aggregator-processor/aggregator-as-a-processor.md): Use the Aggregator processor to calculate aggregate values over incoming usage events without reducing the number of records.
- [Accumulator processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/accumulator-processor.md): The Accumulator processor maintains a running state for groups of events as they flow through a meter. Instead of waiting for a complete time window and then discarding state, the Accumulator continuously updates counters or other metrics for each group and emits the current values when a release condition is met.
- [Accumulator processor - field reference](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/accumulator-processor/accumulator-processor-field-reference.md): This topic describes the configuration fields of the Accumulator processor, available options, and how the release triggers behave.
- [Configure an Accumulator as a processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/accumulator-processor/accumulator-as-a-processor.md): Use the Accumulator processor to group events by selected fields and maintain running totals or other state until a release trigger condition is met.
- [Advanced Transformer](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/advanced-transformer.md): Use the Advanced Transformer when the incoming usage event shape does not match the event shape required for billing or downstream processing.
- [Advanced Transformer metadata](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/advanced-transformer/advanced-transformer-metadata.md): The Advanced Transformer provides access to metadata associated with the current event and pipeline execution.
- [Advanced Transformer use cases](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/advanced-transformer/advanced-transformer-metadata/advanced-transformer-use-cases.md): Use the Advanced Transformer to access metadata, state, and utility functions through the context object. The following examples show common implementation patterns.
- [Configure Advanced Transformer as a processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/advanced-transformer/advanced-transformer-as-a-processor.md): Add an advanced transformer as a processor and use that to include code to perform custom transform functions on event data.
- [Currency Lookup processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/currency-lookup-processor.md): The Currency Lookup processor automatically adds foreign exchange (FX) rates to your event data so that you can convert values from one currency to another during Mediation. It removes the need to manage complex currency conversion logic yourself in downstream processors or external systems.
- [Currency Lookup processor - field and error reference](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/currency-lookup-processor/currency-lookup-processor-field-and-error-reference.md): This topic describes the configuration fields of the Currency Lookup processor, supported options, and the main error codes you may see when using this processor.
- [Configure Currency Lookup as a processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/currency-lookup-processor/currency-lookup-as-a-processor.md): Use the Currency Lookup processor to add foreign exchange (FX) rates to events so that you can convert amounts from one currency to another during Mediation. The processor uses exchange rate types provided by Oanda and can work with static or event‑based currencies.
- [Configure Map as a processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/map-as-a-processor.md): The Map processor in Zuora Mediation allows for the selective retention, renaming, dropping, or transformation of fields from usage events to normalize data formats and prepare fields for further processing.
- [Map processor examples](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/map-as-a-processor/map-processor-examples.md): This document provides examples and guidelines for using map processors to transform and map data fields effectively.
- [Rating processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/rating-processor.md): The Rating processor in Zuora Mediation calculates rated amounts for usage events, transforming raw data into billable records.
- [Configure a Rating processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/rating-processor/configure-rating-processor.md): Learn how to transform raw usage data into billable rated records by configuring a Rating processor.
- [Attribute-Based Pricing in the Rating processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/rating-processor/attribute-based-pricing.md): Attribute-Based Pricing (ABP) in Mediation allows for dynamic pricing based on specific attributes, ensuring accurate charge calculations and integration into billing processes.
- [HTTP processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/http-processor.md): The HTTP processor in Zuora Mediation enables real-time data enrichment by calling external APIs within a mediation flow, enhancing event data for accurate billing and processing.
- [Configure a HTTP processor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/http-processor/configure-http-processor.md): Learn how to configure an HTTP processor to enable real-time data enrichment by calling external APIs within a mediation flow.
- [Connection configuration references](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/http-processor/connection-configuration-references.md): References for configuring HTTP connections, including setup, request handling, and authentication types.
- [Connection configuration examples](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/http-processor/connection-configuration-examples.md): Examples of connection configurations for customer enrichment and webhook sinks.
- [Troubleshooting HTTP processor configurations](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/http-processor/troubleshooting.md): Troubleshoot common HTTP processor configuration issues.
- [Python support in advanced processors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/python-support-in-advanced-processors.md): Learn how Python is supported in Zuora Mediation advanced processors, including high-performance in-platform execution and extended external execution with additional libraries.
- [Delta operator behavior in Mediation](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/delta-operator-behavior.md): The Delta operator in Zuora Mediation calculates how a numeric field changes over time, rather than just aggregating all values into a single total. It is typically used when the source field is a cumulative counter (such as a running meter reading) and you need to derive per-event or per-interval changes.
- [Mediation code editors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/mediation-code-editors.md): Zuora's mediation engine supports custom code for three meter components, the Advanced Transformer, Aggregator, and Accumulator processors. Each operator is designed for a distinct purpose within the event processing pipeline.
- [Advanced Transformer code editor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/mediation-code-editors/advanced-transformer-code-editor.md): The Advanced Transformer is used for per-event transformations. It processes individual events independently, performing 1 to 1, many or none It is stateless unless state handling is explicitly implemented.
- [Advanced Accumulator code editor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/mediation-code-editors/advanced-accumulator-code-editor.md): The Advanced Accumulator code editor processes multiple events together, typically within time-based windows or grouped contexts. It is best suited for aggregation, summation, and grouped analytics.
- [Advanced Aggregator code editor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/mediation-code-editors/advanced-aggregator-code-editor.md): The Advanced Aggregator code editor provides stateful, memory-based processing across multiple events. It enables custom release conditions, allowing flexible accumulation of data until business-defined triggers are met.
- [Mediation code editor guide](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/meter-components/processors/mediation-code-editors/mediation-code-editor-guide.md): The Mediation code editor guide offers a comprehensive overview of using GraalVM 23.0.1, GraalJS, and GraalPy to execute custom logic in meters. It includes examples of transformers, accumulators, and aggregators, along with guidelines for handling dates and currency in JavaScript and Python.
- [Manage connections in meters](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters.md): The Manage Connections feature in Zuora Mediation lets you create and maintain reusable connections that can be selected when configuring processors in a meter flow.
- [Create HTTP connections in meters](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-http-connections-in-meters.md): Create and configure HTTP connections in Meters, including base URL, authentication, and connection testing.
- [Create AWS S3 connections in meters](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-aws-s3-connections-in-meters.md): The AWS S3 connection type in the Manage Connections window lets you register AWS S3 buckets that can be used by meters in Zuora Mediation.
- [Create a Zuora-managed S3 connection](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-aws-s3-connections-in-meters/create-zuora-s3-connection.md): Create a single Zuora-managed S3 connection so Zuora can manage the AWS S3 bucket on your behalf.
- [Create an external AWS S3 connection](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-aws-s3-connections-in-meters/create-external-s3-connection.md): Create an external S3 connection when you want to use your own AWS S3 bucket.
- [Create Snowflake connections in meters](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-snowflake-connections-in-meters.md): Use Snowflake connections to let Mediation connect to a Snowflake account that can be used as a source or target in meters.
- [Prepare a Snowflake user and role for Mediation](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-snowflake-connections-in-meters/prepare-a-snowflake-user-and-role-for-mediation.md): Before using Snowflake with Mediation, create a dedicated Snowflake user and assign a default role with the required privileges.
- [Define the Snowflake connection](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-snowflake-connections-in-meters/snowflake-define-connection.md): Define a Snowflake connection in Mediation to enable Zuora-managed access to your Snowflake account.
- [Configure Snowflake authentication](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-snowflake-connections-in-meters/configure-snowflake-authentication.md): Snowflake connections support password-based authentication and key-pair authentication. On the Authentication step of the wizard, configure one of the authentication options.
- [Configure Zuora-managed S3 for Snowflake (Credentials)](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-snowflake-connections-in-meters/config-snowflake-creds.md): Use the Zuora Managed S3 setup using the Credentials option when you want the simplest Snowflake setup.
- [Configure Zuora-managed S3 for Snowflake (Storage Integration, Inline)](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-snowflake-connections-in-meters/config-snowflake-storage-int-inline.md): Use these steps when your Snowflake environment uses a storage integration to control access to external S3 locations, but you do not need separate stages for every data flow.
- [Configure Zuora-managed S3 for Snowflake (Storage Integration, Stage)](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-snowflake-connections-in-meters/config-snowflake-storage-int-stage.md): Use these steps your Snowflake standards require all external data access to go through named stages.
- [Validate and activate the Snowflake connection](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-snowflake-connections-in-meters/validate-snowflake-connection.md): Validate the Snowflake connection and activate it for use in meters
- [Create Kafka connections in meters](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-kafka-connections-in-meters.md): Use Kafka connections to let Mediation connect to an external Kafka (or Kafka‑compatible) cluster that can be used as a source or sink in meters. The connection stores the cluster's bootstrap servers, security protocol, and authentication settings so it can be reused across multiple meters.
- [Define the Kafka connection](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-kafka-connections-in-meters/kafka-define-connection.md): Define a Kafka connection in Mediation and specify the cluster configuration.
- [Security options for Kafka connections](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-kafka-connections-in-meters/security-options-for-kafka-connections.md): Learn how to configure security protocols, SASL mechanisms, and TLS/SSL settings for Kafka connections, including required properties and validation rules.
- [Configure Kafka authentication](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-kafka-connections-in-meters/security-options-for-kafka-connections/configure-kafka-authentication.md): Configure how Zuora authenticates with your Kafka cluster using SASL (SCRAM or PLAIN) or TLS/SSL, and review how credentials and certificates are handled securely.
- [Validate and activate the Kafka connection](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/manage-connections-in-meters/create-kafka-connections-in-meters/validate-kafka-connection.md): Validate the Kafka connection and activate it for use in meters.
- [Data refresh from Production to Central Sandbox (CSBX) for Mediation](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/data-refresh-from-production-to-central-sandbox-csbx-for-mediation.md): Zuora Mediation currently provides limited support for Central Sandbox (CSBX) refreshes from Production. While a CSBX refresh updates Zuora Billing data, Mediation data and processing state are handled separately and require additional steps.
- [System errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/system-errors-mediation.md): This reference provides details on various system errors, their descriptions, and possible remedies.
- [Data & Operator errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/data-operator-errors-mediation.md): This reference provides comprehensive details on data and operator errors, including error codes, descriptions, and potential remedies.
- [External Service errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/external-service-errors-mediation.md): This reference provides comprehensive details on external service errors, including error codes, descriptions, and potential remedies for issues such as rule engine execution, subscription lookup, invoice creation, and more.
- [Dashboard Summary errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/dashboard-summary-errors-mediation.md): This reference provides a summary of dashboard error codes, their messages, and suggested remedies for resolution.
- [Authentication & Authorization errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/authentication-authorization-errors-mediation.md): This reference provides a summary of authentication and authorization error codes, their messages, and suggested remedies for resolution.
- [Meter Lifecycle errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/meter-lifecycle-errors-mediation.md): This reference provides a summary of meter lifecycle error codes, their messages, and suggested remedies for resolution.
- [Event Definition errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/event-definition-errors-mediation.md): This reference provides a summary of event definition error codes, their messages, and suggested remedies for resolution.
- [Meter Import & Configuration errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/meter-import-config-errors-mediation.md): This reference provides a comprehensive overview of meter import and configuration error codes, detailing their messages and offering suggested remedies for resolution.
- [Script errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/script-errors-mediation.md): This reference provides details on script errors, including error codes, messages, and possible remedies for each issue.
- [Event Store errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/event-store-errors-mediation.md): This reference provides details on Event Store errors, including error codes, messages, and possible remedies for each issue.
- [File, ZDP & Prefetch errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/file-zdp-prefetch-errors-mediation.md): This reference details file, ZDP, and prefetch errors, covering error codes, their messages, and suggested remedies.
- [Source & Target Validation errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/source-target-validation-errors-mediation.md): This document provides error codes and remedies for source and target validation, covering a range of issues from missing connections to unsupported data formats.
- [Pipeline Validation errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/pipeline-validation-errors-mediation.md): This document provides details on error codes and remedies for pipeline validation.
- [Package Management errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/package-management-errors-mediation.md): This reference provides error codes and remedies for package management issues, including file type support, package duplication, and version conflicts.
- [Replay and Reprocess errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/replay-reprocess-errors-mediation.md): This document provides details on replaying and reprocessing errors including error messages and possible remedies.
- [Scheduler & Prefetch errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/scheduler-prefetch-errors-mediation.md): This document provides error codes and remedies for Scheduler and Prefetch operations, covering a range of issues from invalid job IDs to unsupported prefetch modes.
- [SQL & Miscellaneous errors](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/error-message-reference-for-mediation/sql-misc-errors-mediation.md): This document details SQL and miscellaneous errors, including error codes, messages, and possible remedies.
- [Zuora Mediation Model Context Protocol](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol.md): Learn how Mediation MCP helps you design, operate, monitor, and troubleshoot Mediation pipelines through an AI assistant.
- [Mediation MCP scope](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/mediation-mcp-scope.md): Use this reference to understand what Mediation MCP includes.
- [Mediation MCP prerequisites](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/mediation-mcp-prerequisites.md): Use this reference to verify the tenant, client, user, and entity requirements for Mediation MCP.
- [Connect to the Zuora remote MCP](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/connect-to-the-zuora-remote-mcp.md): Learn how to create OAuth credentials, select an MCP endpoint, and connect an MCP-compatible client to Mediation.
- [Create OAuth 2.0 credentials](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/connect-to-the-zuora-remote-mcp/create-oauth-2-0-credentials.md): Create static OAuth 2.0 credentials for an MCP-compatible client.
- [Configure the redirect URI](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/connect-to-the-zuora-remote-mcp/configure-the-redirect-uri.md): Use the redirect URI that corresponds to your MCP client.
- [Select the MCP server endpoint](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/connect-to-the-zuora-remote-mcp/select-the-mcp-server-endpoint.md): Use the endpoint that matches the tenant environment that you intend to operate.
- [Configure the MCP client](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/connect-to-the-zuora-remote-mcp/configure-the-mcp-client.md): Configure an MCP-compatible client to connect to Zuora Remote MCP and verify access to Mediation meters.
- [Permissions and safe operation](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/permissions-and-safe-operation.md): Use this reference to understand Mediation MCP permissions, write approvals, entity scope, and safe operating rules.
- [Manage meters with Mediation MCP](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/manage-meters-with-mediation-mcp.md): Use this reference to discover, validate, create, update, import, export, and duplicate Mediation meters.
- [Run and monitor meters with Mediation MCP](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/run-and-monitor-meters-with-mediation-mcp.md): Use this reference to start, stop, monitor, and analyze Mediation meter runs and prefetch operations.
- [Investigate and export audit data](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/investigate-and-export-audit-data.md): Use this reference to browse error and sample audit records and create audit exports for Mediation reconciliation.
- [Common Mediation MCP workflows](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/common-mediation-mcp-workflows.md): Learn how to investigate failed runs, author and test meters, recover stuck runs, and refresh prefetch data.
- [Install the Mediation MCP skill in Cursor](https://zuora.ferndocs.com/docs/platform/extensibility/mediation/zuora-mediation-model-context-protocol/install-the-mediation-mcp-skill-in-cursor.md): Learn how to install the Mediation MCP skill in Cursor and verify that the client can access your meters.