Refunds

Описание

Плагин добавляет обработку полных и частичных возвратов в заказы Payload ecommerce. Он создаёт коллекцию `refunds`, где каждый возврат оформлен как обычный документ, и добавляет в коллекцию заказов поля `refundedAmount` и `refundableAmount`, которые синхронизируются с записями о возвратах. Все суммы хранятся и сравниваются как целые числа в минимальных единицах валюты (копейках, центах). Дробные значения не округляются, а отклоняются. Плагин расширяет `@payloadcms/plugin-ecommerce` и должен регистрироваться после того, как коллекция заказов уже существует. Если коллекция отсутствует, конфигурация возвращается без изменений, поэтому плагин безопасно подключать в любом проекте. `refundedAmount` пересчитывается заново из записей о возвратах при каждой записи и никогда не инкрементируется, что исключает рассогласование с историей. Возврат может включать несколько позиций заказа. Сумма возвращённых единиц по всем записям не превышает количества заказанного товара. Возврат отклоняется с ошибкой `RefundError` (HTTP 400), если сумма равна нулю, отрицательна, дробная, превышает остаток к возврату или если лимит по позиции исчерпан. Хук `onRefund` выполняется после валидации и до записи в базу. Если вызов платёжного провайдера завершится неудачей, не останется никаких следов. Возврат объекта `reference` из хука сохраняет идентификатор возврата на стороне провайдера в записи. Опциональный restock возвращает товары на склад в документ продукта или варианта через compare-and-set записи с повторными попытками, чтобы избежать перезаписи при параллельных изменениях. `updateTransactionStatus` помечает соответствующую транзакцию как `refunded` после полного возврата суммы заказа. Опция `refundedStatus` управляет статусом самого заказа: пустая строка оставляет его без изменений, что подходит для частичных возвратов. Пакет не содержит админ-компонентов и не имеет рантайм-зависимостей, включая прямые импорты `payload`, что сохраняет стабильность между минорными релизами Payload. Плагин не вычисляет цену отдельной позиции, поскольку официальный ecommerce-плагин не хранит её в строке заказа, поэтому лимиты по позициям применяются только по количеству. Запись о возврате доступна только для добавления: хук `beforeChange` отклоняет любые операции, кроме `create`, поэтому история возвратов остаётся неизменной.

О пакете

Имя пакета

payload-refunds

Последняя версия

1.0.1

Размер

52 кБ

Лицензия

MIT

Загрузок в неделю

3

Последняя публикация

21 авг. 2026 г.