Счета

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

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

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

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

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

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

Query Parameters

NameTypeDescription

contact_id

Integer

ID контакта

{
  "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

NameTypeDescription

contact_id

Integer

ID контакта

currency

String

Трехзначный код валюты в ISO 4217. Пример: USD

{
  "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"
  }
}

Удалить счет

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

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

Request Body

NameTypeDescription

account_id

Integer

ID счета

{
    // Response
}

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

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

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

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

Request Body

NameTypeDescription

account_id

Integer

ID счета

amount

Integer

Сумма в минимальной денежной единице. Например для $10 - это 1000

description

String

Описание транзакции

{
  "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

NameTypeDescription

account_id

String

ID счета

amount

String

Сумма в минимальной денежной единице. Например для $10 - это 1000

description

String

Описание транзакции

{
    // Response
}

Last updated