Счета

С помощью представленных методов вы можете создавать счета для ваших контактов в рамках ISO 4217, а так же проводить операции по ним - начисление/списание.

Внимание!

Данное API вы используете на свой страх и риск, мы не несем ответственности за сохранность данных созданных вами счетов через представленное API, но приложим все усилия для их сохранности и безопасности. Вы не должны использовать методы API представленные на этой странице, если их использование нарушает законодательство Российской Федерации, Европейского союза и США.

Все счета отображаются в карточке контакта в личном кабинете. Так же по каждому счету ведется журнал операций.

Как отправить баланс пользователю в сообщении:

https://app.gitbook.com/@i-gulyaev-design/s/baza-znanij-leadtex/platezhnye-sistemy/popolnenie-balansa-vashikh-klientov-dlya-soversheniya-budushikh-pokupok-v-bote

Получить список счетов

GET https://app.leadteh.ru/api/v1/getContactAccounts

Этот метод позволяет получить список счетов указанного контакта. (Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

Query Parameters

Name	Type	Description
contact_id	integer	ID контакта

200 Запрос успешно обработан.

{
  "data": [
    {
      "id": 1,
      "currency": "USD",
      "amount": 17500,
      "amount_note": "175 USD",
      "created_at": "2019-11-29T13:33:35+00:00",
      "updated_at": "2019-11-30T07:08:57+00:00"
    }
  ]
}

Создать счет

POST https://app.leadteh.ru/api/v1/addContactAccount

Этот метод позволяет создать счет для указанного контакта. (Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

Request Body

Name	Type	Description
contact_id*	integer	ID контакта.
currency*	string	Трехзначный код валюты в ISO 4217. Пример: USD

201 Счет успешно создан

{
  "data": {
    "id": 6,
    "currency": "USD",
    "amount": 0,
    "amount_note": "0 USD",
    "created_at": "2019-11-30T14:56:24+00:00",
    "updated_at": "2019-11-30T14:56:24+00:00"
  }
}

422 Аккаунт уже существует.

{
  "errors": {
    "currency": [
      "Account with the currency already exists"
    ]
  }
}

422 Неподдерживаемый формат

{
  "message": "The given data was invalid.",
  "errors": {
    "currency": [
      "The currency format is invalid.",
      "The selected currency is invalid."
    ]
  }
}

Удалить счет

POST https://app.leadteh.ru/api/v1/deleteContactAccount

Этот метод позволяет удалить счет контакта. (Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

Request Body

Name	Type	Description
account_id*	integer	ID счета.

204 Счет успешно удален

422 Счет не может быть удален, т.к. имеет положительный баланс.

{
  "errors": {
    "account_id": [
      "You can not delete the account with a balance of 175 RUB"
    ]
  }
}

Счет может быть удален только если имеет нулевой баланс.

Зачислить сумму на счет

POST https://app.leadteh.ru/api/v1/addFundsToContactAccount

Этот метод позволяет зачислить средства на счет контакта. (Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

Request Body

Name	Type	Description
account_id*	integer	ID счета
amount*	integer	Сумма в минимальной денежной единице. Например для $10 - это 1000
description*	string	Описание транзакции

200 Счет успешно пополнен

{
  "data": {
    "id": 1,
    "currency": "USD",
    "amount": 117500,
    "amount_note": "1175 USD",
    "created_at": "2019-11-29T13:33:35+00:00",
    "updated_at": "2019-11-30T07:08:57+00:00"
  }
}

Списать сумму со счета

POST https://app.leadteh.ru/api/v1/withdrawFundsFromContactAccount

Этот метод позволяет списать средства со счета контакта. (Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

Request Body

Name	Type	Description
account_id*	String	ID счета
amount*	String	Сумма в минимальной денежной единице. Например для $10 - это 1000
description*	String	Описание транзакции

200