Начните не с таблицы курсов, а с объекта исходного платежа у провайдера. Зафиксируйте его amount и currency, затем сравните с параметрами созданного refund. Если заказ сегодня заново переводит цену из базовой валюты, система возвращает новую оценку товара, а не часть фактически списанной транзакции.

Рабочее правило проще: возврат создаётся в валюте исходного charge и ограничивается его неиспользованным остатком. Для частичного возврата берётся доля или сумма из строк оплаченного заказа, сохранённых на момент покупки. Курс на дату возврата нужен для управленческого учёта, но не должен молча менять запрос платёжному API.

Сначала разделите три разных валюты

Что хранитсяПримерГде используется
Валюта цены или каталогаEURПоказ товара и бизнес-правила
Валюта charge (presentment)USDСумма, которую принимает refund API
Валюта settlement магазинаRUBВыплата и бухгалтерская сверка
Валюта счёта клиентаKZTКонвертация банка или эмитента
Сохранённый курс расчёта заказаEUR→USD на момент checkoutОбъяснение цены и распределение по строкам

Stripe отдельно различает валюту платёжного метода клиента, presentment currency и settlement currency. Если валюта карты отличается от валюты charge, курс и возможную комиссию применяет банк клиента. Поэтому одинаковый refund в USD способен отобразиться на выписке не той же суммой в KZT, которая была при покупке; магазин не должен «компенсировать» эту разницу повторной конвертацией без отдельного бизнес-решения.

Денежный снимок не пересчитывается задним числом

{
  "payment_id": "pay_demo_1042",
  "charge_amount_minor": 12500,
  "charge_currency": "usd",
  "refunded_amount_minor": 3000,
  "line_refund_minor": 2500,
  "refund_operation_id": "return_882:item_17:v1"
}

available_to_refund = 12500 - 3000 = 9500 USD minor units

Это условный снимок, а не ответ реального API. Суммы хранятся целыми minor units: 12500 означает 125.00 USD, тогда как для zero-decimal currency масштаб другой. Stripe требует передавать API amount в минимальной единице конкретной валюты; универсальное умножение на 100 для всех валют создаёт отдельный класс ошибок.

В снимке нужны идентификатор charge, фактически захваченная сумма, валюта, уже возвращённый остаток и распределение скидок/доставки/налога по строкам. Название товара и актуальная цена могут меняться, но денежная версия оплаченного заказа остаётся неизменяемой. Корректировка оформляется отдельной записью, а не UPDATE старой истории.

Частичный возврат проверяется на инвариантах

  • Валюта refund совпадает с валютой исходного charge, если провайдер не документирует иной поток.
  • Сумма нового возврата не превышает captured amount минус уже успешные и ожидающие возвраты.
  • Распределение скидки и налога использует снимок checkout, а не текущие правила каталога.
  • Повтор команды имеет тот же operation ID и не создаёт второй возврат после сетевого таймаута.
  • Статусы pending, succeeded и failed сверяются с провайдером, а не выводятся из HTTP 200 одного запроса.

Документация Stripe разрешает несколько частичных возвратов, но их общая сумма не может превышать исходный charge. Там же указано, что refund возвращается на исходный способ оплаты. Это ещё одна причина связывать запись с payment/charge, а не рассчитывать свободный перевод на любую карту по сегодняшнему курсу.

Расхождение локализуется одной сверкой

  1. Взять amount/currency у charge и всех его refunds из платёжного кабинета или API.
  2. Сравнить их с денежным снимком заказа без пересчёта через каталог и текущий FX rate.
  3. Проверить minor-unit scale и правила округления по каждой строке и итогу.
  4. Отдельно сопоставить settlement amount магазина и сумму в выписке клиента — это другие конверсии.
  5. Повторить частичный возврат в sandbox и убедиться, что один operation ID создаёт одну запись.

Не исправляйте историю массовым пересчётом до классификации расхождений. Ошибка может быть в валюте запроса, масштабе minor units, двойном FX, распределении скидки или только в отображении банковской выписки. Для каждого класса нужен свой repair: от корректирующей записи до понятного объяснения клиенту.

Что считать успешным исправлением

Контрольный заказ проходит полный и два частичных возврата без изменения суммы после обновления курса. Локальный ledger, refund object провайдера и доступный остаток совпадают в одной валюте charge. В отчёте settlement может быть другая сумма — она подписана собственной валютой и курсом, а не подменяет данные клиента.

Для разбора подготовьте JSON исходного payment/refund без персональных данных, снимок денежных строк заказа, правила округления и экран банковской выписки с закрытыми реквизитами. Этого достаточно, чтобы найти место второго пересчёта; полный номер карты, секрет API и данные покупателя передавать не нужно.

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