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

POST

https://tacq-tom.tcsbank.ru/tom-bpm/api/v1/public/tom-bpm/api/v1/public/service-requests/merchant-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.

Path parameters

Required

srType

String

Тип заявки на обслуживание.

Request body schema application/json

Required

company

Object (TomServiceRequestCompanyDto)

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

Required

extCompanyId

String

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

Required

merchants

Array of objects ()

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

address

Object (TomAddressDto)

Адрес.

apartment

String

Requirements: <= 20 characters

Номер квартиры или офиса.

block

String

Requirements: <= 20 characters

Номер корпуса.

building

String

Requirements: <= 20 characters

Номер строения.

city

String

Requirements: <= 50 characters

Наименование города. Обязателен к заполнению, если не передается settlement.

Required

country

String

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

Трехсимвольный цифровой код государства по ISO 3166-1. Например, код для государства Российская Федерация — 643.

district

String

Requirements: <= 50 characters

Район с типом/префиксом.

fiasId

String

Requirements: <= 50 characters

Идентификатор адреса по ФИАС.

house

String

Requirements: <= 20 characters

Номер дома.

kladrId

String

Requirements: <= 50 characters

Код адреса по КЛАДР.

Required

postalCode

String

Requirements: non-empty and <= 6 characters

Почтовый индекс.

Required

region

String

Requirements: non-empty and <= 50 characters

Регион с типом/префиксом.

Required

result

String

Requirements: non-empty and <= 300 characters

Результирующий адрес одной строкой.

settlement

String

Requirements: <= 100 characters

Регион с типом/префиксом. Обязателен к заполнению, если не передается city.

street

String

Requirements: <= 150 characters

Улица с типом/префиксом.

Required

type

String

Requirements: [FACTUAL, JURIDICAL, REGISTRATION]

Тип адреса:

FACTUAL — фактический адрес расположения объекта (торговой точки).
JURIDICAL — юридический адрес регистрации объекта (компании).
REGISTRATION — адрес регистрации субъекта: персоны ЕИО, связанного контакта компании.

bankAccount

Object (TomBankAccountDto)

Информация о банковском счете.

Required

bankName

String

Requirements: <= 100 characters

Наименование банка.

Required

bic

String

Requirements: Value must match regular expression \d{9}

БИК банка — банковский идентификационный код.

Required

corrAccount

String

Requirements: Value must match regular expression ^\d{20}$

Номер корреспондентского счета банка.

Required

currentAccount

String

Requirements: Value must match regular expression ^\d{20}$

Номер расчетного счета получателя в банке.

buildType

String

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

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

String

Requirements: Value must match regular expression ^[0-9a-zA-Zа-яА-ЯёЁ+_.-]+@[0-9a-zA-Zа-яА-ЯёЁ.-]+.[0-9a-zA-Zа-яА-ЯёЁ]{2,}$

Адрес электронной почты торговой точки.

Required

extShopId

String

Requirements: non-empty and <= 30 characters

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

fee

Object (TomFeeDto)

Комиссия. Обязательно заполняется или fee, или tariffs.

Required

amount

Object (TomAmountDto)

Размер комиссии.

feeRate

Number<double>

Процент комиссии.

fixed

Number<double>

Фиксированный размер комиссии в валюте для схемы типа fix или hybrid.

percentage

Number<double>

Requirements: <= 99.99

Размер комиссии в % от суммы операции для схемы типа percentage или hybrid.

Required

currency

Integer<int32>

Requirements: >= 1 and <= 643

Валюта комиссии. Трехзначный код валюты согласно стандарту ISO 4217. Рубли — 643.

groupId

String

Наименование группового условия по комиссии. Заполняется при использовании специальных групповых условий по комиссии.

Required

type

String

Requirements: [FIX, HYBRID, PERCENT]

Тип условия расчета комиссии.

nameEng

String

Requirements: <= 20 characters, Value must match regular expression ^[A-Za-z0-9 !\"#$%&'()*+,\-./:;<=>?@[\\\]^_{|}~]+$`

Наименование торговой точки на английском языке, транслитерированное.

nameRus

String

Requirements: <= 100 characters, Value must match regular expression ^[А-Яа-яЁё0-9 !\"#$%&'()*+,\-./:;<=>?@[\\\]^_{|}~]+$`

Наименование торговой точки на русском языке, как на вывеске.

phone

String

Requirements: <= 50 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.

tariffs

Array of objects ()

Информация о тарифе. Обязательно заполняется или fee, или tariffs.

beginDate

String<date>

Дата начала дествия тарифа

endDate

String<date>

Дата окончания дествия тарифа

tariffName

String

Название тарифа

Required

params

Array of objects ()

Параметры тарифа.

Required

paymentType

String

Requirements: [SBP]

Тип платежа.

Required

requestType

String

Requirements: [PAY, OTHER]

Тип запроса.

mcc

String<^\d{4}$>

Код MCC.

locality

String

Requirements: [ONUS, RESIDENT, NOT_RESIDENT]

Сегмент.

Required

amount

Object (TomTariffParamAmountDto)

Required

feeRate

Number<double>

Процент комиссии.

minFeeAmount

Number<double>

Минимальная комиссия.

maxFeeAmount

Number<double>

Максимальная комиссия.

fixFeeAmount

Number<double>

Фиксированная комиссия.

Required

partnerId

Integer<int64>

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

Ответ

200

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

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

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