Обзор интерфейса
/orders/{id} и /orders/{id}/ в настоящее время оба доступны. ID заказа является частью ссылки на оплату и должен рассматриваться как конфиденциальный непрозрачный идентификатор, не распространяйте его публично.
Анонимный запрос
Страница оплаты может выполнять прямое чтение при потере состояния входа:id, description, price, state, pay_way, pay_url, expired_at, created_at. Он не возвращает аккаунт, Application, Package, внутренние идентификаторы оплаты или metadata.
Авторизованный запрос
application / applications, package / packages, bank_details, invoice_automation и поля модели. Если пользователь авторизован, но не является владельцем заказа, возвращается 403; за исключением супер-администраторов.
Ключевые поля
Полный ответ может содержать дополнительные поля в зависимости от способа оплаты, клиенту следует читать их по необходимости и всегда избегать логирования конфиденциальных metadata из полного ответа.
Обработка ошибок
404: ID заказа не существует.403: пользователь вошёл в систему, но не является владельцем заказа.- Анонимные запросы не возвращают
401; они получают только минимальную публичную проекцию.
Аннулирование счёта-фактуры и повторная заявка
ЧерезGET /api/v1/orders/{order_id}/invoice/ можно получить текущий счёт-фактуру заказа. После отправки автоматического аннулирования счёт-фактура по-прежнему имеет статус Issued, а red_state обозначает ход аннулирования; успешная отправка не означает завершения аннулирования. Во время ожидания подтверждения, оформления красного счёта или архивирования заказ не может повторно подать заявку на счёт-фактуру.
Когда администратор запрашивает аннулирование из-за ошибки в платёжной информации, такой как наименование или налоговый номер, причиной аннулирования является «ошибка при выставлении счёта»; автоматическое аннулирование, вызванное возвратом средств по заказу, по-прежнему использует «прекращение обслуживания».
После успешного оформления и архивирования красного счёта исходный счёт-фактура становится Voided, и только тогда заказ может подать повторную заявку. Исходный счёт-фактуру можно просмотреть в истории счетов-фактур. Если аннулирование не удалось или результат требует проверки, этим занимается финансовый отдел, и ограничение на выставление счёта для заказа не будет снято заранее. Счета-фактуры, оформленные вручную, необходимо сначала аннулировать или провести через красный счёт в налоговой или системе выставления счетов, после чего финансовый отдел подтвердит это на платформе.

