Managing Report Subscriptions

The API enables you to view the details of a single report subscription and a list of all report subscriptions. You can also create, edit, and delete report subscriptions.

Viewing Report Subscriptions

For a summary of all report subscriptions, the request format is:

  GET https://
    
    /reporting/v3/report-subscriptions

Summary Report Subscriptions URL Values
Value	Description
<`url_prefix`>	Name of the server from which to download the report. Use one of these values: Test: `apitest.cybersource.com` Production: `api.cybersource.com` Production in India: api.in.cybersource.com

For a summary of a single report subscription, the request format is:

  GET https://
    
    /reporting/v3/report-subscriptions/
    {reportName}

Single Report Subscription URL Values
Value	Description	Required/ Optional
<`url_prefix`>	Name of the server from which to download the report. Use one of these values: Test: `apitest.cybersource.com` Production: `api.cybersource.com` Production in India: api.in.cybersource.com	Required
`{reportName}`	Unique name of the report subscription you want to review.	Required

Responses

This call can return one of the following HTTP status codes:

200: Ok.

400: Invalid request.

404: Report not found.

For detailed information on the responses, including which fields are returned, see the Reporting REST API Reference .

Creating and Updating Report Subscriptions

To create or update a report subscription, your client application must send an HTTP PUT request to the report server. The request body contains the details for creating the subscription, such as the report type, the start time, and the frequency. The format of the URL is as follows:

  PUT https://
    
    /reporting/v3/report-subscriptions

For example, if you wanted to create a report titled Daily Transactions, the request would be:

  PUT https:///reporting/v3/report-subscriptions

The request body would be:

    {
                "organizationId": "myorg",
                "reportName": "DailyTransactions",
                "reportDefinitionName": "TransactionDetailClass",
                "reportFields": [
                    "Request.RequestID",
                    "Request.TransactionDate",
                    "Request.MerchantID",
                    "BillTo.FirstName",
                    "BillTo.LastName",
                    "BillTo.City",],
                "startTime": "1100",
                "reportMimeType": "application/xml,
                "reportFrequency": "DAILY",
                "timezone": "GMT",
                "startTime": "0900",
                "startDay": "1"
                }

Create/Update Report Subscription URL Values
Value	Description
	Name of the server from which to download the report. Use one of these values: Test: `apitest.cybersource.com` Production: `api.cybersource.com` Production in India: api.in.cybersource.com

Not all configuration options below are available for all reports.

Create/Update Report Subscription Request Body Values
Value	Description	Required/ Optional
`organizationId`	The organization ID under which the report is subscribed. This can be the merchant ID, account ID, or reseller ID.	Optional
`reportDefinitionName`	Name of the report type you want to review. The options are: `TransactionRequestClass`: Transaction Request Report `PaymentBatchDetailClass`: Payment Batch Detail Report `ExceptionDetailClass`: Transaction Exception Detail Report `ProcessorSettlementDetailClass`: Processor Settlement Detail Report `ProcessorEventsDetailClass`: Processor Events Detail Report `FundingDetailClass`: Funding Detail Report `AgingDetailClass`: Aging Detail Report `ChargebackAndRetrievalDetailClass`: Chargeback And Retrieval Detail Report `DepositDetailClass`: Deposit Detail Report `FeeDetailClass`: Fee Detail Report `InvoiceSummaryClass`: Invoice Summary Report `PayerAuthDetailClass`: Payer Authentication Detail Report `ConversionDetailClass`: Conversion Detail Report `SubscriptionDetailClass`: Subscription Detail Report `JPTransactionDetailClass`: JP Transaction Detail Report `ServiceFeeDetailClass`: Service Fee Detail Report `GatewayTransactionRequestClass`: Gateway Transaction Request Report `DecisionManagerEventDetailClass`: `Decision Manager` Event Detail Report `RecurringBillingDetailClass`: Recurring Billing Details Report	Required
`reportFields`	Array of field names which should be included in the report. For a list of available fields, see Reporting Fields and Descriptions	Required
`reportMimeType`	Format of the report. Valid values are: application/xml text/csv	Optional
`reportFrequency`	Frequency of the report subscription. The options are: Daily Weekly Monthly	Optional
`reportName`	Unique name of the report subscription you want to create or edit.	Required
`timeZone`	Merchant’s time zone. For a list of supported time zones, see Supported Time Zones. For example: America/Chicago	Required
`startTime`	Time of day the report will run. Format: HHMM	Optional
`startDay`	Day of month (1-31) the report will run for monthly reports.	Optional
`reportFilters`	Array that contains additional filters.	Optional
`reportPreferences.signedAmounts`	Indicator that determines whether or not a negative sign is used for the amount of all refunded transactions. Valid values: true false	Optional
`reportPreferences.fieldNameConvention`	Specify the field naming convention to be followed in reports (applicable only to csv report formats). Valid values: Simple Order API SCMP	Optional
`selectedMerchantGroupName`	Name of the merchant group.	Optional

Responses

This call can return one of the following HTTP status codes:

200: Ok.

304: Not modified.

404: Report not found.

For detailed information on the responses, including which fields are returned, see the Reporting REST API Reference .

Deleting Report Subscriptions

To delete a report subscription, your client application must send an HTTP DELETE request to the report server. The format of the URL is as follows:

  DELETE https://<
    url_prefix
    >/reporting/v3/report-subscriptions/
    {reportName}

For example, if you wanted to delete a report titled Daily Transactions, the request would be:

  DELETE https://<
    url_prefix
    >/reporting/v3/report-subscriptions/DailyTransactions

Delete Report Subscription URL Values
Value	Description	Required/Optional
<`url_prefix`>	Name of the server from which to download the report. Use one of these values: Test: `apitest.cybersource.com` Production: `api.cybersource.com` Production in India: api.in.cybersource.com	Required
`{reportName}`	Unique name of the report subscription you want to create or edit.	Required

Responses

This call can return one of the following HTTP status codes:

200: Ok.

400: Invalid request.

404: Report not found.

For detailed information on the responses, including which fields are returned, see the Reporting REST API Reference .