Сначала заморозьте повторную обработку спорного возврата: второй запуск может отправить ещё одну сумму провайдеру. Сравните объект исходного charge и объект refund. Валюта и целое значение amount должны относиться к одной денежной шкале, а не к сегодняшней витринной цене.
Курс покупки нужен для воспроизводимости заказа и внутреннего учёта. Клиентский возврат обычно привязывают к исходному платежу, но точное поведение конвертации и комиссий зависит от договора и API платёжного провайдера — его ответ важнее общего предположения.
В одном заказе могут жить три валюты
| Контур | Пример | Источник истины |
|---|---|---|
| Цена/presentment | 100.00 EUR | заказ и checkout |
| Charge | 10000 EUR minor units | платёжный объект |
| Settlement | 108.40 USD | balance 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.
Регрессионный тест меняет курс после оплаты
- Создать заказ в валюте, отличной от расчётной.
- Сохранить charge и валютный snapshot.
- Изменить тестовый текущий курс в источнике цен.
- Сформировать полный и частичный refund.
- Убедиться, что клиентские суммы не изменились.
- Сверить лимит повторного возврата и отдельную курсовую разницу.
Исправление готово, когда старый заказ даёт тот же результат независимо от сегодняшнего курса, а каждая денежная цифра имеет валюту и источник. Для анализа понадобятся обезличенные payment/refund objects, схема order lines, правила округления и пример одной сверки — банковские реквизиты и данные карты не нужны.