# Support source: https://developer.mastercard.com/small-business-credit-analytics/documentation/support/index.md ## FAQ {#faq} #### SBCA Product Questions {#sbca-product-questions} Insights reflect sales activity (Mastercard network transactions only) at small businesses. Mastercard has a sizable share of the credit and debit card market to provide a strong signal on small business performance. Small Business Credit Analytics can be used for decisions across several types of loans including small business (SMB) cards, term loans, lines of credit, merchant cash advances, and others. It may also be utilized for monitoring the performance of an SMB over the lifetime of a loan. See [Use Cases](https://developer.mastercard.com/small-business-credit-analytics/documentation/use-cases/index.md) for example lending scenarios. Merchant TaxID or Acquirer Merchant ID along with country, or Name and Address are matched against the cleansed data from Mastercard Transactions. TaxID matching is currently available only in selected countries, to find out more please contact your Mastercard representative. Refer to [API Reference](https://developer.mastercard.com/small-business-credit-analytics/documentation/api-reference/index.md) for the exact request parameters used in matching. Currently SBCA supports matching by either TaxID, Acquirer Merchant ID, or Merchant Name and Address. TaxID matching is currently available only in selected countries, to find out more please contact your Mastercard representative. Refer the [API Reference](https://developer.mastercard.com/small-business-credit-analytics/documentation/api-reference/index.md) for the full list of supported parameters. A Merchant ID or Acquirer Merchant ID is a unique identifier assigned to a business by a payment processor for tracking and processing electronic transactions. Refer to [API Reference](https://developer.mastercard.com/small-business-credit-analytics/documentation/api-reference/index.md) for how to supply this value in a request. If a search returns no matches, work through these steps: 1. Verify your input against the valid [Merchant Match test cases](https://developer.mastercard.com/small-business-credit-analytics/documentation/testing/merchant-match/index.md). 2. Retry with either an Acquirer Merchant ID + Country, or a complete Name and Address. 3. If the response is `MATCHES_NOT_FOUND`, see [Code and Formats](https://developer.mastercard.com/small-business-credit-analytics/documentation/code-and-formats/index.md#matches-errors) for resolution guidance. You may conduct a data evaluation on your current loan portfolio to assess the lift of the data on underwriting outcomes before onboarding to the API. Please [contact us](mailto:advisors.help@mastercard.com?subject=SBCA:) for more information. The contract needs to specifically call out any third parties who will need access to the API. Please contact your Mastercard representative for more details. Currently, SBCA is supported in USA, Latin America, Europe, the Middle East and Africa. To find out more about supported features and upcoming countries on the roadmap, contact your Mastercard representative. Refer to the [API Reference](https://developer.mastercard.com/small-business-credit-analytics/documentation/api-reference/index.md) for the `country_code` values currently accepted by the API. #### SBCA Technical Questions {#sbca-technical-questions} The Small Business Credit Analytics API provide two types of aggregated sales metrics: * [Retail Sales Analytics](https://developer.mastercard.com/small-business-credit-analytics/documentation/use-cases/retail-sales-analytics/index.md), which consists of up to 45 near real-time data-driven insights for the last 12 months used to assist underwriters with understanding a merchant's performance. * [Retail Sales Benchmarks](https://developer.mastercard.com/small-business-credit-analytics/documentation/use-cases/retail-sales-benchmarks/index.md), which consists of up to 14 monthly metrics (weighted average indices) for up to 12 latest months used to help understand a merchant's relative performance to its benchmark peer set.
SBCA metrics are based on aggregated and anonymized Mastercard transaction data, and are subject to applicable laws and regulations as well as internal Mastercard analytics guidelines and standards. See a sample response in the API Reference section or for the full list of possible merchant metrics and their definitions, contact your Mastercard representative or [Mastercard support team](mailto:advisors.help@mastercard.com?subject=SBCA:). Access to some metrics and available timeframes may differ based on contract and country specific policies. * Retail Sales Analytics metrics are delivered with 12 months of data in weekly and monthly aggregations * Retail Sales Benchmarks metrics are delivered with up to 12 months (depending on the region) of data in monthly aggregation * You may refer to the periodStartDate and periodEndDate in the API response to view the timeframe of the selected metrics Refer to [Retail Sales Analytics](https://developer.mastercard.com/small-business-credit-analytics/documentation/use-cases/retail-sales-analytics/index.md) and [Retail Sales Benchmarks](https://developer.mastercard.com/small-business-credit-analytics/documentation/use-cases/retail-sales-benchmarks/index.md) for the full metric list and their timeframes. * Retail Sales Analytics metrics are updated every week for the latest available week of metrics that can be retrieved, for weekly metrics. * Retail Sales Analytics metrics are updated every month for the latest available month of metrics that can be retrieved, for monthly metrics. * Retail Sales Benchmarks metrics are updated every month for the latest available month of metrics that can be retrieved. Refer [Retail Sales Analytics](https://developer.mastercard.com/small-business-credit-analytics/documentation/use-cases/retail-sales-analytics/index.md) and [Retail Sales Benchmarks](https://developer.mastercard.com/small-business-credit-analytics/documentation/use-cases/retail-sales-benchmarks/index.md) for details on each metric type The "has_consent" parameter indicates whether you have prior consent from the relevant small business to retrieve their metrics from the API. In order to retrieve the metrics, you must have consent, as laid out in the written agreement in place with Mastercard. For implementation details, refer the [pre-requisites](https://developer.mastercard.com/small-business-credit-analytics/documentation/use-cases/retail-sales-analytics/index.md#2-retail-sales-analytics-metrics). There are two API calls required (and therefore two payloads returned) to obtain metrics from Small Business Credit Analytics. The maximum size is no greater than 100KB for the output from the first API call (merchant match), and the maximum size is no greater than 5MB for the output from the second API call (Retail Sales Analytics / Retail Sales Benchmarks metric retrieval). Refer the [API Reference](https://developer.mastercard.com/small-business-credit-analytics/documentation/api-reference/index.md) for response schemas. The competitor peer set for a particular merchant location is identified in consideration of factors such as Industry Type, Geographic Location and Spend Bracket, as may be appropriate. Reversed amount (reversed_amt) refers to the total spend amount of returned purchases, which is recorded as a negative value to reflect the offsetting effect of the transactions. See [Retail Sales Analytics](https://developer.mastercard.com/small-business-credit-analytics/documentation/use-cases/retail-sales-analytics/index.md) for the full metric definitions. These values describe cases where there is low transaction volume or no recent transactions at a merchant location. For YoY metrics, the following are also possible responses. You can find their descriptions below: * 0: If no transactions were observed to calculate the respective metrics in that period * E.g. Zero amount of spend at the merchant location * null: If the minimum number of transactions needed to calculate the respective metrics was not met in that period, or for YoY metrics when there were no data points in the previous year * -1: For YoY metrics only, in the event that there were no data points in the current year * E.g. If there were 50 transactions in the previous year but no transactions in the current year, YoY growth would be calculated as (0-50)/50, which would lead to -1 as a returned response These values describe cases where there is low transaction volume or no recent transactions at the merchant location or its benchmark peer set in the specified period- * 0: If no transactions were observed for the respective metrics at the merchant location * null: If the minimum number of transactions needed to calculate the respective metrics was not met for the merchant location * -1: If there are transactions at the merchant location but insufficient transactions in the competitor peer set. The metrics do not distinguish between domestic and cross-border transactions. #### Support {#support} **Before contacting support:** * For API errors or response-format questions, check [Code and Formats](https://developer.mastercard.com/small-business-credit-analytics/documentation/code-and-formats/index.md). * For integration or test-data questions, check [Testing](https://developer.mastercard.com/small-business-credit-analytics/documentation/testing/index.md). * To confirm the API is operational, check the [API status page](https://developer.mastercard.com/api-status). **If you still need help,** write to the [Mastercard support team](mailto:advisors.help@mastercard.com?subject=SBCA:%20Issue%20with%20(Describe%20Issue%20Here)) and include: * **Subject:** SBCA: Issue with (describe the issue) * **Environment:** Sandbox or Production * **Endpoint \& request:** the call made (e.g. `GET /metrics/{location_id}`) with parameters, minus credentials * **Error details:** HTTP status code, `ErrorCode`, and the response body or a screenshot * **Timestamp** of the failed request Providing these details up front helps the team reproduce and resolve the issue faster. [This page](https://developer.mastercard.com/api-status) informs Mastercard Developers users of the statuses of each API. ## Related Resources {#related-resources} * [Code and Formats](https://developer.mastercard.com/small-business-credit-analytics/documentation/code-and-formats/index.md) --- error codes and resolution steps * [Testing](https://developer.mastercard.com/small-business-credit-analytics/documentation/testing/index.md) --- sandbox test data and end-to-end scenarios * [Quick Start Guide](https://developer.mastercard.com/small-business-credit-analytics/documentation/quick-start-guide/index.md) --- make your first sandbox call * [API Reference](https://developer.mastercard.com/small-business-credit-analytics/documentation/api-reference/index.md) --- full parameter and schema details ## Get Help {#get-help} ### Contact us for technical Support. {#contact-us-for-technical-support}