Счета и организации

Счёт выставляется одной из сохранённых организаций аккаунта. Сначала сохраните организацию, затем выставляйте ей счета. Баланс пополняется сам, когда банк увидит оплату. Как это выглядит в кабинете — в статье Баланс и оплата.

Методы

Сохранить организацию

curl -X POST https://api.aitunnel.ru/v1/aitunnel/payments/companies \
  -H "Authorization: Bearer sk-aitunnel-mgmt-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "legal",
    "name": "ООО «Ромашка»",
    "inn": "7707083893",
    "kpp": "773601001",
    "email": "buh@romashka.example",
    "accountant_phone": "+7 999 123-45-67"
  }'

Ответ 201 — сохранённая организация:

{
  "id": "3f9c2a71-5b8e-4d0a-9c6f-1e2d7b4a8c05",
  "type": "legal",
  "name": "ООО «Ромашка»",
  "inn": "7707083893",
  "kpp": "773601001",
  "email": "buh@romashka.example",
  "address": "г. Москва, ул. Вавилова, д. 19",
  "accountant_phone": "79991234567",
  "has_payments": false,
  "contract_number": null,
  "contract_date": null,
  "edo_status": "unknown",
  "edo_operator": null,
  "edo_requested_at": null,
  "edo_invited_at": null
}

• Организация с теми же ИНН и КПП не создаётся второй раз: POST перезаписывает сохранённую.
• PUT /payments/companies/{id} принимает те же поля и заменяет реквизиты целиком: необязательное поле, которое не передано, очищается.
• DELETE /payments/companies/{id} отвечает 204. Выставленные счета хранят свою копию реквизитов и не меняются.
• В аккаунте — до 20 организаций.

Выставить счёт

curl -X POST https://api.aitunnel.ru/v1/aitunnel/payments/invoices \
  -H "Authorization: Bearer sk-aitunnel-mgmt-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 20000,
    "company_id": "3f9c2a71-5b8e-4d0a-9c6f-1e2d7b4a8c05"
  }'

Ответ 201:

{
  "payment": {
    "id": 530118264,
    "status": "pending",
    "provider": "tbank_invoice",
    "source": "checkout",
    "amount": 20000,
    "bonus_amount": 0,
    "refunded_amount": 0,
    "card_pan": null,
    "payment_url": "https://business.tbank.ru/invoice/530118264.pdf",
    "payer_name": "ООО «Ромашка»",
    "payer_inn": "7707083893",
    "created_at": "2026-11-14T13:16:00.000Z",
    "paid_at": null,
    "receipt_url": null
  },
  "incoming_invoice_url": "https://business.tbank.ru/incoming-invoice/abc",
  "sent_to": "buh@romashka.example"
}

• amount — целые рубли, от 10 000 до 100 000 000. company_id — id сохранённой организации, строка UUID. Не UUID — ошибка 400 по полю company_id; UUID чужой или удалённой организации — 404.
• Банк отправляет счёт на почту организации. Счёт сам денег не списывает: баланс пополнится, когда организация оплатит его переводом.
• Оплачен ли счёт, показывает GET /payments/{id} с номером из payment.id: статус станет succeeded.
• Бонус за пополнение на оплату от организации не начисляется: сумма на балансе равна сумме в счёте и в закрывающих документах.
• Оплата по СБП от организации — POST /payments с "method": "company_sbp", см. платежи.

Счёт в PDF

GET /payments/invoices/{id}/pdf отдаёт наш печатный счёт по номеру платежа: Content-Type: application/pdf.

curl -o invoice.pdf https://api.aitunnel.ru/v1/aitunnel/payments/invoices/530118264/pdf \
  -H "Authorization: Bearer sk-aitunnel-mgmt-xxx"

Ошибки