Регистрация терминала в рамках Service Request

POST

https://tacq-tom.tcsbank.ru/tom-bpm/api/v1/public/tom-bpm/api/v1/public/service-requests/terminal-registration

Регистрация дополнительного терминала по уже зарегистрированной торговой точке в рамках заявки на обслуживание.

Запрос

Header parameters

Required

authorization

String

Значение заполняется по шаблону {PartnerId}+':'+Base64(HMAC-SHA512({SecretKey}, UTF-8-Encoding-Of(Date))), где:

PartnerId — системный код партнера;
SecretKey — ключ в текстовом формате, сформированный на стороне Т-Банка.

Required

date

String

Дата в формате ISO 8601:2004 — YYYY-MM-DDThh:mm:ss±hh:mm.

Request body schema application/json

Required

company

Object (TomRegisterTerminalCompanyDto)

Информация о компании.

Required

extCompanyId

String

Идентификатор компании в рамках учета системы партнера — внешний по отношению к банку.

Required

merchants

Array of objects ()

Информация о мерчанте.

buildType

String

Requirements: [BEAUTY_SALON, CAR_SERVICE, CATERING_POINT, DELIVERY_POINT, DWELLING, HOTEL, MEDICAL_CENTER, OFFICE, OTHER, PRODUCTION_FACILITY, SHOP, SPORT_CENTER, WAREHOUSE]

Тип помещения торговой точки.

Required

extShopId

String

Requirements: non-empty and <= 30 characters

Идентификатор торговой точки — внешний, в рамках системы учета партнера.

Required

terminals

Array of objects ()

Терминал.

accessibilityCode

String

Requirements: non-empty and <= 30 characters

Код адаптивного решения для людей с инвалидностью. В параметре можно передать одно или несколько двузначных чисел. Допустимые значения: 00, 01, 02, 03. Если передаете несколько чисел, используйте разделитель ; без пробелов.

deviceConfigType

String

Requirements: [CASHIER, CLIENT]

Тип конфигурации платежного устройства:

CASHIER — ТСП кассир;
CLIENT — ТСП клиент.

deviceManufacturer

String

Requirements: <= 50 characters

Производитель устройства оплаты.

deviceSoftware

String

Requirements: <= 50 characters

Название программного обеспечения устройства.

Required

mcc

String

Requirements: <= 4 characters, Value must match regular expression ^\d{4}$

МСС (Merchant Category Code), соответствующий деятельности торговой точки.

paymReaderManufacturer

String

Requirements: <= 50 characters

Производитель внешнего считывателя бесконтактных платежей. Если его нет, укажите ОТСУТСТВУЕТ.

paymReaderModel

String

Requirements: <= 50 characters

Модель внешнего считывателя бесконтактных платежей.

Required

serialNumber

String

Requirements: non-empty and <= 50 characters

Серийный номер терминала.

Required

type

String

Requirements: [RETAIL, VENDING]

Тип терминала:

RETAIL — используется при торговле с участием продавца;
VENDING — используется при торговле с устройства самообслуживания — вендингового аппарата.

paymentType

String

Requirements: [POS, MPOS, SOFTPOS]

Default: POS

Тип технологии оплаты:

POS (point-of-sale) — традиционный тип, терминал;
mPOS (mobile POS) — гибридный тип, использующий мобильное устройство и специальный приемник карт;
SoftPOS (software POS) — программный тип технологии, использующий только мобильное устройство для приема платежа.

Поле необязательное. Если значение не передано, по умолчанию устанавливается тип технологии оплаты POS.

Required

partnerId

Integer<int64>

Системный код партнера.

Ответ

200

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

Это полезный материал?

Обратиться в поддержку