Сначала заморозьте повторную обработку спорного возврата: второй запуск может отправить ещё одну сумму провайдеру. Сравните объект исходного charge и объект refund. Валюта и целое значение amount должны относиться к одной денежной шкале, а не к сегодняшней витринной цене.

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

В одном заказе могут жить три валюты

КонтурПримерИсточник истины
Цена/presentment100.00 EURзаказ и checkout
Charge10000 EUR minor unitsплатёжный объект
Settlement108.40 USDbalance transaction/выплата
Управленческий учёт9 870.00 RUBзафиксированный FX snapshot

Stripe, например, различает валюту платежа клиента и валюту расчёта с банком. Refund object содержит собственные `amount` и `currency` и связан с исходным charge. Не копируйте правила одного провайдера в другой: сохраните его идентификаторы и сверяйте официальную схему конкретного API.

Снимок цены остаётся частью заказа

{
  "order_id": "ORD-1042",
  "charge_id": "pay_...",
  "presentment": {"amount_minor": 10000, "currency": "EUR"},
  "settlement": {"amount_minor": 10840, "currency": "USD"},
  "fx_snapshot": {"rate": "98.700000", "base": "EUR", "quote": "RUB", "fixed_at": "2026-09-10T12:00:00Z"}
}

Числа условные. Деньги лучше хранить целыми minor units по правилам валюты либо точным decimal, но не binary float. Вместе с курсом нужны направление пары и время: значение `98.7` без EUR/RUB неоднозначно.

Partial refund использует исходные строки

При возврате одной позиции возьмите сохранённую фактически оплаченную сумму этой строки после скидки и распределённых корректировок. Текущая цена каталога не участвует. Налог, доставка и скидка возвращаются по вашей бизнес- и налоговой политике; статья не заменяет правила юрисдикции или договор с эквайером.

  • Храните paid unit amount, quantity и currency на строке заказа.
  • Фиксируйте распределение order-level скидки до возврата.
  • Не округляйте каждое промежуточное действие binary float.
  • Ограничьте суммарный refund остатком исходного charge.
  • Каждый запрос связывайте с idempotency key и refund id.

Текущий курс допустим только в отдельном расчёте

ЗадачаКакой показательПочему
Вернуть клиенту chargeисходная charge currency/amountсвязь с платежом
Показать историческую ценуorder snapshotвоспроизводимость
Оценить обязательство сегоднятекущий FX отдельноэто новая оценка
Сверить settlementданные провайдерафактическая конвертация
Проводка курсовой разницыправило учётане менять refund задним числом

Миграция старых заказов не выдумывает курс

Если historical snapshot не сохранён, сначала ищите его у провайдера, в invoice, balance transaction или журнале расчёта. Не подставляйте сегодняшний курс и не выдавайте его за исходный. Для записей без доказуемого значения заведите явный статус и ручной процесс; массовый backfill должен хранить provenance.

Регрессионный тест меняет курс после оплаты

  1. Создать заказ в валюте, отличной от расчётной.
  2. Сохранить charge и валютный snapshot.
  3. Изменить тестовый текущий курс в источнике цен.
  4. Сформировать полный и частичный refund.
  5. Убедиться, что клиентские суммы не изменились.
  6. Сверить лимит повторного возврата и отдельную курсовую разницу.

Исправление готово, когда старый заказ даёт тот же результат независимо от сегодняшнего курса, а каждая денежная цифра имеет валюту и источник. Для анализа понадобятся обезличенные payment/refund objects, схема order lines, правила округления и пример одной сверки — банковские реквизиты и данные карты не нужны.

Проверенные источники