---
title: "Returns a single shop's data."
method: GET
path: "/shops/{shopId}"
---

# Returns a single shop's data.

`GET /shops/{shopId}`

## Request

- Base URL: `https://api.test.kalixa.com/payment-service/v6`
- URL: `https://api.test.kalixa.com/payment-service/v6/shops/{shopId}`
- Auth: HTTP basic

Returns a single shop's data.

## Path parameters

- `shopId` string, required

## Response `200`

Successful operation

- Shop: Contains the shop data.
  - `id` string: The id of the registered shop. Used for identifying the shop in other methods e.g. getShop.
  - `name` string: A short text, usually the shop name or abbreviation. Used for display and filtering purposes the PS Admin tool.
  - `cardAcceptanceMode` 'CP' | 'CNP': The information if the shop operates in card present (CP) or card not present (CNP) mode. Used for setting up the Shop correctly with the Card Schemes.
  - `isMotoOnlyBusiness` boolean: The information if a card not present (CNP) shop processes only MOTO transactions. Used to decide if a URL needs to be provided.
  - `url` string: The URL of the shop's main website where the items/goods/services are sold if cardAcceptanceMode equals CNP (ecommerce). The URL of the company website if cardAcceptanceMode equals CP (POS). Used for screening purposes by the PXP Financial Risk Team.
  - `domainOwnership` 'Own' | 'RetailPlatform': The information if the domain is owned by the merchant or its belongs to a retail platform. Used by the PXP Financial Risk Team.
  - `activationState` 'LiveAcceptingCards' | 'LiveNotAcceptingCards' | 'Test' | 'BetaVersion': The information if the provided URL is already live or still in a test mode. Used by the PXP Financial Risk Team.
  - `approvalState` 'Approved' | 'Declined' | 'Pending': The information if the shop was approved, declined or if the approval is still pending.
  - `countryCode` string: The country code of the country out of which this website operates or does the main business as ISO 3166-1 alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Used for screening purposes by the PXP Financial Risk Team.
  - `billingDescriptor1` string: The name of the Shop in a way the customer recognizes it. Used for card transactions and will appear on the 1st line of the billing descriptor.
  - `billingDescriptor2` string: Usually the location out of which the shop operates. Used for card transactions acquired by PXP Financial and will appear on the 2nd line of the billing descriptor.
  - `volumeSpreadByProcessing` VolumeSpreadByProcessing: An indication how the volume is expected to be distributed across different types of transactions. Expressed in percentage which needs to sum up to 100. Applicable only for shops where cardAcceptanceMode equals CNP (ecommerce). Used for screening purposes by the PXP Financial Risk Team.
    - `ecom` integer: E-commerce transactions.
    - `moto` integer: Mail or Telephone Order transactions.
    - `recurring` integer: Recurring e-commerce transactions.
  - `volumeSpreadByRegion` VolumeSpreadByRegion: An indication how the volume is expected to be distributed across regions. Expressed in percentage which needs to sum up to 100. Applicable only for shops where cardAcceptanceMode equals CNP (ecommerce). Used for screening purposes by the PXP Financial Risk Team.
    - `northAmerica` integer: Percentage of transactions in North America.
    - `europeanEconomicArea` integer: Percentage of transactions in the european economic area.
    - `asia` integer: Percentage of transactions in Asia.
    - `latinAmerica` integer: Percentage of transactions in Latin America.
    - `others` integer: Percentage of transactions in other regions.
  - `volumeSpreadByScheme` VolumeSpreadByScheme: An indication how the volume is expected to be distributed across schemes. Expressed in percentage which needs to sum up to 100. Applicable only for shops where cardAcceptanceMode equals CNP (ecommerce). Used for screening purposes by the PXP Financial Risk Team.
    - `visa` integer: Percentage of processed transactions for VISA.
    - `mastercard` integer: Percentage of processed transactions for Mastercard.
    - `others` integer: Percentage of processed transactions for other schemes.
  - `merchant` ObjectWithId: Contains only the id of the resource. Used for future extensibility.
    - `id` string: The id of the resource.
  - `documents` ObjectWithId[]: Contains a list of previously uploaded documents for the new shop.
    - `id` string: The id of the resource.
  - `questionAnswerPairs` QuestionAnswerPair[]: Contains a list of previously submitted set of questions with their answers for the new shop.
    - `questionId` string: The predefined literal id of the question. See https://developer.kalixa.com/v1.0/docs/questions for more information.
    - `answer` string: The answer to the question, as provided by the merchant. Used for screening purposes.

## Other responses

- `400`: Error occurred

---

[API](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding.md) - [All operations](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/revisions/066120f66046?raw)