Skip to content

Создать Hold ​

Метод: POST
URL: BASE_URL/merchant/payment/hold/create/
Заголовок:

http
Authorization: Bearer <ACCESS_TOKEN>

Тело запроса ​

ПолеПример данныхТипТребуетсяОписание
amount1000intДаСумма в SUM (1000 = 1000 SUM)
userId123stringНетПользователь ID заявлен мерчантом
account{"field_name": "sample data"}dictНетОтправьте пустой dict {}, если нет дополнительных данных
cardId9f877739-bc25-4f0f-a13f-ec485fd04250stringДаКарта ID создана в системе Paylov
time10intДаВремя выдержки в минутах. Макс.: 40320 (28 дней)
externalIdexternalId1stringНетВнешний ID. Максимальная длина: 64 символа
serviceId9f877739-bc25-4f0f-a13f-ec485fd04250stringНетПредоставлено Платежной системой
json

{
  "userId": "string",
  "cardId": "string",
  "amount": 10,  # 10 = 10 Sum
  "account": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "time": 10,
  "externalId": "string", # max_chars: 64
  "serviceId": "uuid" 
}
ПолеТипТребуетсяОписание
userIdstringДаУникальный идентификатор пользователя.
cardIdstringДаУникальный идентификатор карты, используемой в удержании.
amountintegerДаСумма, которую необходимо удерживать. (сумма в сумме)
accountobjectНетСодержит дополнительные свойства учетной записи.
account.additionalProp1stringНеобязательноДанные пользовательского аккаунта.
account.additionalProp2stringНеобязательноДанные пользовательского аккаунта.
account.additionalProp2stringНеобязательноДанные пользовательского аккаунта.
timeintegerДаПродолжительность удержания в минутах. Максимально допустимое значение — 28 дней (40320 минут).

Успешный ответ ​

json

{
  "result": {
    "transactionId": "uuid4"
  }
}
Полеsample_dataТипОписание
transactionIduuid4stringУникальный идентификатор пользователя.