Сервис проверки доступности плательщику способа расчета "Аккредитив"
Обновлено 20 декабря 2023
Сервис выполняет проверку доступности плательщику способа расчета "Аккредитив".
Данный сервис необходимо вызвать, перед предложением покупателю способов оплаты за товары/услуги, приобретаемые по договору/контракту/заказу у продавца.
Для вызова сервиса потребуется получить токен доступа.
Получение токена доступа выполняется с помощью API Получение токена OAUTH. Перед тем, как использовать сервис API, необходимо отправить запрос на формирование токена авторизации.
После успешного формирования токена в ответном сообщении будет возвращен идентификатор токена, который необходимо указывать в заголовке Authorization в каждом запросе к API.
Токен нужно получать для каждого нового запроса к API. Срок жизни токена составляет 60 сек.
Scope | auth://tradefin/lc-legal/application |
Endpoint | https://mc.api.sberbank.ru/prod/tradefin/lc-legal/v1/service-allowed |
Method | GET |
Request Body | - |
Request Parameters | query: inn, где inn- ИНН плательщика по аккредитиву |
query: ogrn, где ogrn - ОГРН или ОГРНИП плательщика по аккредитиву | |
query: kpp, где kpp - КПП плательщика по аккредитиву (при наличии) | |
Response | HTTP 200 ОК (Расчет через аккредитив возможен) |
HTTP 403 Данный вид расчета для вашей организации не доступен | |
HTTP 403 Проверка токена не пройдена | |
HTTP 500 Внутренняя ошибка сервиса. Обратитесь в поддержку или попробуйте повторить запрос позднее | |
Response Parameters | - |
Заголовки запроса
Наименование заголовка | Описание | Обязательность поля |
---|---|---|
authorization | Токен авторизации, полученный в Токен OAUTH. В начало заголовка необходимо добавить строку «Bearer» с пробелом. | Да |
RqUID | Уникальный идентификатор сообщения, pattern=([0-9]|[a-f]|[A-F]){32})», переданный во входящем сообщении. Необходим для журналирования входящих вызовов и удобства разбора инцидентов.Чтобы обеспечить уникальность, можно использовать стандартные библиотеки и классы для генерации UUID/GUID(см. UUID), убрав из результата разделители «-». | Да |
Пример запроса
GET https://mc.api.sberbank.ru/prod/tradefin/lc-legal/v1/service-allowed?inn=5630020111&ogrn=1105658002111&kpp=563001001
Authorization: Bearer 5a9143e9-e39b-4130-958e-558524dc622a
Content-Type: application/json
RqUID: c6da1b21f459433da289f5684dba5b67
Пример ответа
HTTP/1.1 200 OK
Server: nginx/1.22.1
Date: Mon, 29 May 2023 05:37:37 GMT
Content-Length: 0
Connection: keep-alive
X-Gravitee-Transaction-Id: ac1272eb-fba4-4c59-9272-ebfba44c591b
X-Gravitee-Request-Id: ac1272eb-fba4-4c59-9272-ebfba44c591b
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1685338657848
x-content-type-options: nosniff
x-xss-protection: 1; mode=block
cache-control: no-cache, no-store, max-age=0, must-revalidate
pragma: no-cache
expires: 0
strict-transport-security: max-age=31536000 ; includeSubDomains
x-frame-options: DENY
Accept-Ranges: bytes
<Response body is empty>