ym88659208ym87991671
Смарт-контракты на ЭДС+ | Документация для разработчиков

Смарт-контракты на ЭДС+ (1.2.5)

Скачать OpenAPI-спецификацию:Скачать

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

Доступные функции:

  • Создание смарт-контракта с КЭП владельца API
  • Получение статуса смарт-контракта

Подробнее о смарт-контрактах

Аутентификация

OAuth2

Security Scheme Type OAuth2
clientCredentials OAuth Flow
Token URL: https://mc.api.sberbank.ru/prod/tokens/v3/oauth
Scopes:
  • auth://sbersmartcabinet/digital-money-contract -

    единый scope для API

API

Для возможности Marketplace передавать через API с

post/customers

Для возможности Marketplace передавать через API смарт-контракт и быть участником этого смарт-контракта. (Разовая операция для каждого нового Marketplace)

Авторизация
OAuth2 (
  • auth://sbersmartcabinet/digital-money-contract
)
Заголовки
RqUID
required
string (RqUID) <= 32 characters ^(([0-9]|[a-f]|[A-F]){32})$
Example: fe4e390d969bcc91f4db3e4ec0d2fa26

Уникальный идентификатор запроса

Схема запроса: application/json
inn
required
string^(([0-9]{12})|([0-9]{10}))?$

ИНН организации

ogrn
string^[0-9]{13}$

ОГРН

kpp
string^([0-9]{9})$

КПП организации

Ответы

Пример запроса

Content type
application/json
{
  • "inn": "7804492059",
  • "ogrn": "1047796372711",
  • "kpp": "780401001"
}

Пример ответа

Content type
application/json
{
  • "memberId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1d1i"
}

Запрос идентификатора СберСмартКабинета участника

get/members

Запрос идентификатора СберСмартКабинета участника смарт-контракта

Авторизация
OAuth2 (
  • auth://sbersmartcabinet/digital-money-contract
)
QUERY-ПАРАМЕТРЫ
inn
required
string (inn) ^(([0-9]{12})|([0-9]{10}))?$
Example: inn=7804492059

ИНН организации

kpp
string (kpp) ^([0-9]{9})$
Example: kpp=780401001

КПП организации

Заголовки
RqUID
required
string (RqUID) <= 32 characters ^(([0-9]|[a-f]|[A-F]){32})$
Example: fe4e390d969bcc91f4db3e4ec0d2fa26

Уникальный идентификатор запроса

Ответы

Пример ответа

Content type
application/json
{
  • "memberId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1d1i"
}

Создание нового смарт-контракта

post/basic-smart-contracts

Создание нового смарт-контракта

Авторизация
OAuth2 (
  • auth://sbersmartcabinet/digital-money-contract
)
Заголовки
RqUID
required
string (RqUID) <= 32 characters ^(([0-9]|[a-f]|[A-F]){32})$
Example: fe4e390d969bcc91f4db3e4ec0d2fa26

Уникальный идентификатор запроса

Схема запроса: application/json
required
object

Информация по смарт-контракту

required
Array of objects <= 10 items [ items ]

Ответы

Пример запроса

Content type
application/json
{
  • "smartContract": {
    },
  • "members": [
    ]
}

Пример ответа

Content type
application/json
{
  • "timestamp": "2022-01-13T09:59:48.704+03:00",
  • "smartContractId": "2sadb5e775db496ab929e6fbv",
  • "smartContractStatus": "PENDING"
}

Запрос данных по смарт-контракту

get/basic-smart-contracts/{id}

Запрос данных по смарт-контракту

Авторизация
OAuth2 (
  • auth://sbersmartcabinet/digital-money-contract
)
PATH-ПАРАМЕТРЫ
id
required
string (smartContractId) 25 characters ^[a-z0-9]{25,25}$
Example: 2sadb5e775db496ab929e6fbv

ID смарт-контракта

Заголовки
RqUID
required
string (RqUID) <= 32 characters ^(([0-9]|[a-f]|[A-F]){32})$
Example: fe4e390d969bcc91f4db3e4ec0d2fa26

Уникальный идентификатор запроса

Ответы

Пример ответа

Content type
application/json
{
  • "smartContract": {
    },
  • "members": [
    ],
  • "contractApproves": [
    ],
  • "transactionApproves": [
    ]
}

Создание нового смарт-контракта

post/approved-basic-smart-contracts

Создание нового смарт-контракта

Авторизация
OAuth2 (
  • auth://sbersmartcabinet/digital-money-contract
)
Заголовки
RqUID
required
string (RqUID) <= 32 characters ^(([0-9]|[a-f]|[A-F]){32})$
Example: fe4e390d969bcc91f4db3e4ec0d2fa26

Уникальный идентификатор запроса

Схема запроса: application/json
object (smartContractApproval)

Смарт-контракт

signature
string (signature) <= 16000 characters ^[A-Za-z0-9+/=]{0,16000}$

Подпись над content

Ответы

Пример запроса

Content type
application/json
{
  • "content": {
    },
  • "signature": "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"
}

Пример ответа

Content type
application/json
Example
{
  • "timestamp": "2022-01-13T09:59:48.704+03:00",
  • "error": "Bad Request",
  • "message": "Something is wrong in the incoming message...",
  • "path": "/api/v1/digital-money/basic-smart-contracts"
}
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.