Счета

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

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

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

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

GET https://app.onebot.tech/api/v1/getContactAccounts

Этот метод позволяет получить список счетов указанного контакта

Query Parameters

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

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

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

Создать счет

POST https://app.onebot.tech/api/v1/addContactAccount

Этот метод позволяет создать счет для указанного контакта.

Request Body

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

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

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

422: Unprocessable Entity Аккаунт уже существует

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

Удалить счет

POST https://app.onebot.tech/api/v1/deleteContactAccount

Этот метод позволяет удалить счет контакта

Request Body

Name	Type	Description
account_id	Integer	ID счета

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

{
    // Response
}

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

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

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

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

POST https://app.onebot.tech/api/v1/addFundsToContactAccount

Этот метод позволяет зачислить средства на счет контакта

Request Body

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

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

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

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

POST https://app.onebot.tech/api/v1/withdrawFundsFromContactAccount

Этот метод позволяет списать средства со счета контакта

Request Body

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

200: OK Списание успешно проведено

{
    // Response
}