Переводы между счетами
Перевод денег со счёта на счёт с комиссией: создание, правка и удаление. Части перевода — движения денег с transfer_id.
Переводы между счетами
Объекты
MoneyTransfer
idintegerобязательноID перевода — transfer_id его частей в журнале движений (/v1/money-transactions).
versionintegerобязательноВерсия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match.
from_account_idintegerобязательноID денежного счёта, с которого списаны деньги.
to_account_idintegerобязательноID денежного счёта, на который зачислены деньги.
from_amountstringобязательноСписано со счёта from_account_id в его валюте, десятичной строкой.
from_currencystringобязательноВалюта счёта списания: код ISO 4217 или код криптовалюты.
to_amountstringобязательноЗачислено на счёт to_account_id в его валюте, десятичной строкой. В одной валюте равно from_amount: разница — это комиссия fee.
to_currencystringобязательноВалюта счёта зачисления.
feestring или nullобязательноКомиссия перевода в валюте счёта списания, десятичной строкой — расход на системной статье bank_fees; null, если комиссии нет.
amountintegerобязательноСтоимость перевода в минимальных единицах валюты магазина: её несут обе части. Курсовую разницу обмена валют журнал пишет отдельным движением.
currencystringобязательноВалюта сумм, код ISO 4217: валюта магазина.
occurred_atstring (date-time)обязательноМомент перевода.
occurred_onstring (date)обязательноУчётная дата перевода, YYYY-MM-DD в часовом поясе магазина.
descriptionstring или nullобязательноОписание перевода; null, если не задано.
from_transaction_idintegerобязательноID движения-расхода на счёте списания.
to_transaction_idintegerобязательноID движения-прихода на счёте зачисления.
fee_transaction_idinteger или nullобязательноID движения комиссии; null, если комиссии нет.
created_atstring (date-time)обязательноКогда запись создана.
Методы
Перевод между денежными счетами
get/money-transfers/{money_transfer}
Scope: finance:read
Параметры
Путь
money_transferintegerобязательноID перевода — transfer_id его частей в журнале движений.
Ответы
200Успешно
Заголовки
ETagstringобязательноВерсия записи. Передайте её в If-Match, чтобы изменить запись.
- Пример:
"7"
application/json
Возвращает MoneyTransfer
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
404Объекта нет или он недоступен приложению
application/problem+json
Возвращает Problem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl "https://api.saleya.app/v1/money-transfers/{money_transfer}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"id": 0,
"version": 0,
"from_account_id": 0,
"to_account_id": 0,
"from_amount": "string",
"from_currency": "string",
"to_amount": "string",
"to_currency": "string",
"fee": "string",
"amount": 0,
"currency": "string",
"occurred_at": "2026-01-15T12:00:00Z",
"occurred_on": "2026-01-15",
"description": "string",
"from_transaction_id": 0,
"to_transaction_id": 0,
"fee_transaction_id": 0,
"created_at": "2026-01-15T12:00:00Z"
}Правка перевода целиком на месте: счета, суммы, комиссия, дата и описание
patch/money-transfers/{money_transfer}
Scope: finance:write
Параметры
Путь
money_transferintegerобязательноID перевода — transfer_id его частей в журнале движений.
Заголовок
Idempotency-KeystringУникальный ключ попытки, например UUID. Повтор с тем же ключом и телом получает сохранённый ответ вместо второй записи. Ключ живёт 24 часа.
- Мин. длина:
- 1
- Макс. длина:
- 255
- Пример:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringобязательноETag записи из последнего чтения, например "7". Правка применится, только если запись с тех пор никто не менял, иначе 412. Без заголовка — 428.
- Пример:
"7"
Тело запроса application/json
from_account_idintegerID денежного счёта, с которого списаны деньги.
- Минимум:
- 1
to_account_idintegerID денежного счёта, на который зачислены деньги.
- Минимум:
- 1
from_amountstringСписано со счёта from_account_id в его валюте, десятичной строкой.
- Макс. длина:
- 37
to_amountstring или nullЗачислено на счёт to_account_id в его валюте, десятичной строкой. В одной валюте равно from_amount: разница — это комиссия fee.
- Макс. длина:
- 37
feestring или nullКомиссия перевода в валюте счёта списания, десятичной строкой — расход на системной статье bank_fees; null, если комиссии нет.
- Макс. длина:
- 37
occurred_onstring (date)Учётная дата перевода, YYYY-MM-DD в часовом поясе магазина.
occurred_atstring (date-time)Момент перевода.
descriptionstring или nullОписание перевода; null, если не задано.
- Макс. длина:
- 1000
Ответы
200Успешно
Заголовки
Idempotent-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.
- Значения:
true
ETagstringобязательноВерсия записи. Передайте её в If-Match, чтобы изменить запись.
- Пример:
"7"
application/json
Возвращает MoneyTransfer
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
404Объекта нет или он недоступен приложению
application/problem+json
Возвращает Problem
409Запрос с тем же ключом идемпотентности ещё исполняется, данные изменились после чтения, внешний id у другой записи, исчерпан лимит тарифа или адресов вебхуков, или правке нужно согласие на последствия
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает ConflictProblem
412Запись изменилась после чтения: версия в If-Match не текущая
application/problem+json
Возвращает Problem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
428Запросу нужен If-Match с ETag записи
application/problem+json
Возвращает Problem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Отказы метода
- 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 412
precondition_failedЗапись изменилась - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен - 428
precondition_requiredНужен If-Match
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl -X PATCH "https://api.saleya.app/v1/money-transfers/{money_transfer}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"' \
-H "Content-Type: application/json" \
-d @body.json{
"from_account_id": 1,
"to_account_id": 1,
"from_amount": "string",
"to_amount": "string",
"fee": "string",
"occurred_on": "2026-01-15",
"occurred_at": "2026-01-15T12:00:00Z",
"description": "string"
}{
"id": 0,
"version": 0,
"from_account_id": 0,
"to_account_id": 0,
"from_amount": "string",
"from_currency": "string",
"to_amount": "string",
"to_currency": "string",
"fee": "string",
"amount": 0,
"currency": "string",
"occurred_at": "2026-01-15T12:00:00Z",
"occurred_on": "2026-01-15",
"description": "string",
"from_transaction_id": 0,
"to_transaction_id": 0,
"fee_transaction_id": 0,
"created_at": "2026-01-15T12:00:00Z"
}Удаление перевода со всеми его частями
delete/money-transfers/{money_transfer}
Scope: finance:write
Параметры
Путь
money_transferintegerобязательноID перевода — transfer_id его частей в журнале движений.
Заголовок
Idempotency-KeystringУникальный ключ попытки, например UUID. Повтор с тем же ключом и телом получает сохранённый ответ вместо второй записи. Ключ живёт 24 часа.
- Мин. длина:
- 1
- Макс. длина:
- 255
- Пример:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringобязательноETag записи из последнего чтения, например "7". Правка применится, только если запись с тех пор никто не менял, иначе 412. Без заголовка — 428.
- Пример:
"7"
Ответы
204Успешно
Заголовки
Idempotent-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.
- Значения:
true
Без тела
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
404Объекта нет или он недоступен приложению
application/problem+json
Возвращает Problem
409Запрос с тем же ключом идемпотентности ещё исполняется, данные изменились после чтения, внешний id у другой записи, исчерпан лимит тарифа или адресов вебхуков, или правке нужно согласие на последствия
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает ConflictProblem
412Запись изменилась после чтения: версия в If-Match не текущая
application/problem+json
Возвращает Problem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
428Запросу нужен If-Match с ETag записи
application/problem+json
Возвращает Problem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Отказы метода
- 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 409
in_use_conflictЗапись используется - 412
precondition_failedЗапись изменилась - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен - 428
precondition_requiredНужен If-Match
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl -X DELETE "https://api.saleya.app/v1/money-transfers/{money_transfer}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"'Перевод между денежными счетами, с комиссией или без
post/money-transfers
Scope: finance:write
Параметры
Заголовок
Idempotency-KeystringУникальный ключ попытки, например UUID. Повтор с тем же ключом и телом получает сохранённый ответ вместо второй записи. Ключ живёт 24 часа.
- Мин. длина:
- 1
- Макс. длина:
- 255
- Пример:
8e03978e-40d5-43e8-bc93-6894a57f9324
Тело запроса application/json
from_account_idintegerобязательноID денежного счёта, с которого списаны деньги.
- Минимум:
- 1
to_account_idintegerобязательноID денежного счёта, на который зачислены деньги.
- Минимум:
- 1
from_amountstringобязательноСписано со счёта from_account_id в его валюте, десятичной строкой.
- Макс. длина:
- 37
to_amountstring или nullЗачислено на счёт to_account_id в его валюте, десятичной строкой. В одной валюте равно from_amount: разница — это комиссия fee.
- Макс. длина:
- 37
feestring или nullКомиссия перевода в валюте счёта списания, десятичной строкой — расход на системной статье bank_fees; null, если комиссии нет.
- Макс. длина:
- 37
occurred_onstring (date)Учётная дата перевода, YYYY-MM-DD в часовом поясе магазина.
occurred_atstring (date-time)Момент перевода.
descriptionstring или nullОписание перевода; null, если не задано.
- Макс. длина:
- 1000
Ответы
201Создано
Заголовки
Idempotent-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.
- Значения:
true
ETagstringобязательноВерсия записи. Передайте её в If-Match, чтобы изменить запись.
- Пример:
"7"
Locationstring (uri)обязательноАдрес созданной записи, а у принятого к исполнению (202) — адрес, где следить за исходом.
application/json
Возвращает MoneyTransfer
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
409Запрос с тем же ключом идемпотентности ещё исполняется, данные изменились после чтения, внешний id у другой записи, исчерпан лимит тарифа или адресов вебхуков, или правке нужно согласие на последствия
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает ConflictProblem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Отказы метода
- 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl -X POST "https://api.saleya.app/v1/money-transfers" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H "Content-Type: application/json" \
-d @body.json{
"from_account_id": 1,
"to_account_id": 1,
"from_amount": "string",
"to_amount": "string",
"fee": "string",
"occurred_on": "2026-01-15",
"occurred_at": "2026-01-15T12:00:00Z",
"description": "string"
}{
"id": 0,
"version": 0,
"from_account_id": 0,
"to_account_id": 0,
"from_amount": "string",
"from_currency": "string",
"to_amount": "string",
"to_currency": "string",
"fee": "string",
"amount": 0,
"currency": "string",
"occurred_at": "2026-01-15T12:00:00Z",
"occurred_on": "2026-01-15",
"description": "string",
"from_transaction_id": 0,
"to_transaction_id": 0,
"fee_transaction_id": 0,
"created_at": "2026-01-15T12:00:00Z"
}