mufassall

Шпаргалка · Бизнес-процессы

Возвраты и чарджбэки

14 мин · Средний · mufassall.dtwin.uz/ru/l/refunds-and-chargebacks/

← Открыть урок

Проблема

Магазин возвращает деньги двумя путями: сам делает возврат, полный или частичный, или банк держателя карты забирает деньги через чарджбэк. Оба выглядят как «минус какая-то сумма», и оба ломаются в одних и тех же местах: отредактированная строка платежа, клик, отправленный дважды, два сотрудника, возвращающие одновременно, статус, который приходит только позже вебхуком, и срок спора, за которым никто не следил.

Чему вы научитесь

  • Почему возврат — это отдельная запись и отдельная проводка, а исходный платёж никогда не редактируется
  • Как ключ идемпотентности и условный update не дают выплатить возврат дважды или больше списанного
  • Статусы возврата, которые завершаются асинхронно: pending, succeeded, failed, и вебхуки, приходящие дважды или не по порядку
  • Жизненный цикл чарджбэка: открытие спора, удержание денег, доказательства до срока, выигрыш или проигрыш и ежедневная сверка с отчётом провайдера
Итоговая сцена

Диаграмма как код

Итоговая схема урока в виде текста: вставьте её в Jira, GitLab, GitHub, Notion или документацию, там Mermaid рисуется сам. Есть варианты для D2 и PlantUML (Confluence, IntelliJ).

Mermaid: схема

flowchart LR
  n_support(["Сотрудник поддержки"])
  n_api["Сервис возвратов"]
  n_db[("БД платежей")]
  n_provider>"Карточный провайдер"]
  n_support2(["Второй сотрудник"])
  n_issuer>"Банк-эмитент"]
  n_recon("Ежедневная сверка")
  n_support -->|"вызов"| n_api
  n_api --> n_db
  n_api -->|"вызов"| n_provider
  n_support2 -->|"вызов"| n_api
  n_provider -.->|"асинхронно"| n_api
  n_issuer -->|"асинхронно"| n_provider
  n_recon --> n_provider
  n_recon --> n_db

Mermaid: последовательность запросов

sequenceDiagram
  participant n_api as Сервис возвратов
  participant n_db as БД платежей
  participant n_provider as Карточный провайдер
  participant n_issuer as Банк-эмитент
  participant n_recon as Ежедневная сверка
  Note over n_api,n_db: Оплаченный заказ и возврат товара
  n_api->>n_db: SELECT id, status, captured_minor FROM payments WHERE id = 'pay_7731'#59;
  n_db-->>n_api: pay_7731 #124; captured #124; 450000
  Note over n_api,n_db: Возврат записан поверх платежа
  n_api->>n_db: UPDATE payments
  Note over n_api,n_db: Возврат — новая запись и новая проводка
  n_api->>n_db: BEGIN#59;
  Note over n_api,n_provider: Таймаут и второй клик
  n_api->>n_provider: 14:02:10.0 POST /v1/refunds payment=pay_7731 amount=150000
  Note over n_api,n_provider: id возврата — это ключ идемпотентности
  n_api->>n_provider: POST /v1/refunds HTTP/1.1
  n_provider-->>n_api: HTTP/1.1 200 OK
  Note over n_api,n_db: Два сотрудника возвращают одновременно
  n_api->>n_db: captured 450000, already refunded 150000, left 300000
  Note over n_api,n_db: Проверить и зарезервировать одной командой
  n_api->>n_db: UPDATE payments
  n_db-->>n_api: agent A: UPDATE 1 refunded_minor = 350000
  Note over n_provider,n_api: Провайдер отвечает позже
  n_provider->>n_api: POST /webhooks/provider HTTP/1.1
  n_api-->>n_provider: HTTP/1.1 200 OK (stored, applied in 40 ms)
  Note over n_issuer,n_provider: Банк покупателя забирает деньги
  n_issuer->>n_provider: dispute.created dp_3307
  Note over n_api,n_db: Удержать деньги, ответить до срока
  n_api->>n_db: BEGIN#59; -- dispute.created dp_3307
  Note over n_recon,n_db: Каждый день сверяться с отчётом провайдера
  n_recon->>n_db: 06:00 provider report 2026-11-18: 412 refunds, 9 disputes

D2

direction: right

n_support: "Сотрудник поддержки" {
  shape: rectangle
}
n_api: "Сервис возвратов" {
  shape: rectangle
}
n_db: "БД платежей" {
  shape: cylinder
}
n_provider: "Карточный провайдер" {
  shape: cloud
}
n_support2: "Второй сотрудник" {
  shape: rectangle
}
n_issuer: "Банк-эмитент" {
  shape: cloud
}
n_recon: "Ежедневная сверка" {
  shape: rectangle
  style.multiple: true
}

n_support -> n_api: "вызов"
n_api -> n_db
n_api -> n_provider: "вызов"
n_support2 -> n_api: "вызов"
n_provider -> n_api: "асинхронно" {
  style.stroke-dash: 3
}
n_issuer -> n_provider: "асинхронно"
n_recon -> n_provider
n_recon -> n_db

PlantUML: последовательность запросов

@startuml
participant "Сервис возвратов" as n_api
database "БД платежей" as n_db
boundary "Карточный провайдер" as n_provider
boundary "Банк-эмитент" as n_issuer
participant "Ежедневная сверка" as n_recon
note over n_api, n_db : Оплаченный заказ и возврат товара
n_api -> n_db : SELECT id, status, captured_minor FROM payments WHERE id = 'pay_7731';
n_db --> n_api : pay_7731 | captured | 450000
note over n_api, n_db : Возврат записан поверх платежа
n_api -> n_db : UPDATE payments
note over n_api, n_db : Возврат — новая запись и новая проводка
n_api -> n_db : BEGIN;
note over n_api, n_provider : Таймаут и второй клик
n_api -> n_provider : [дубль] 14:02:10.0 POST /v1/refunds payment=pay_7731 amount=150000
note over n_api, n_provider : id возврата — это ключ идемпотентности
n_api -> n_provider : POST /v1/refunds HTTP/1.1
n_provider --> n_api : HTTP/1.1 200 OK
note over n_api, n_db : Два сотрудника возвращают одновременно
n_api -> n_db : captured 450000, already refunded 150000, left 300000
note over n_api, n_db : Проверить и зарезервировать одной командой
n_api -> n_db : UPDATE payments
n_db --> n_api : agent A: UPDATE 1 refunded_minor = 350000
note over n_provider, n_api : Провайдер отвечает позже
n_provider ->> n_api : POST /webhooks/provider HTTP/1.1
n_api -->> n_provider : HTTP/1.1 200 OK (stored, applied in 40 ms)
note over n_issuer, n_provider : Банк покупателя забирает деньги
n_issuer ->> n_provider : dispute.created dp_3307
note over n_api, n_db : Удержать деньги, ответить до срока
n_api -> n_db : BEGIN; -- dispute.created dp_3307
note over n_recon, n_db : Каждый день сверяться с отчётом провайдера
n_recon -> n_db : 06:00 provider report 2026-11-18: 412 refunds, 9 disputes
@enduml

PlantUML: компоненты

@startuml
left to right direction
agent "Сотрудник поддержки" as n_support
component "Сервис возвратов" as n_api
database "БД платежей" as n_db
cloud "Карточный провайдер" as n_provider
agent "Второй сотрудник" as n_support2
cloud "Банк-эмитент" as n_issuer
collections "Ежедневная сверка" as n_recon
n_support --> n_api : вызов
n_api --> n_db
n_api --> n_provider : вызов
n_support2 --> n_api : вызов
n_provider ..> n_api : асинхронно
n_issuer --> n_provider : асинхронно
n_recon --> n_provider
n_recon --> n_db
@enduml

Итог

Шесть правил возврата денег.

1) Возврат — новая строка и новая проводка; совершённый платёж никогда не редактируется. 2) id строки возврата — ключ идемпотентности для каждого вызова провайдера. 3) Проверяйте лимит и резервируйте сумму одним условным update или под блокировкой строки: pending и succeeded вместе никогда не превышают списанное. 4) Возвраты завершаются асинхронно; окончательный статус берите из подписанных вебхуков, только вперёд, а о застрявших в pending спрашивайте провайдера. 5) У чарджбэка есть срок: удерживайте деньги, отвечайте доказательствами вовремя и не возвращайте оспоренный платёж. 6) Каждый день сверяйте возвраты и споры с отчётом провайдера.

Показатели: в начале и в конце

ПоказательВ началеВ конце
Возвраты, выплаченные дважды0/mo0/mo
Возвраты сверх списанного0/mo0/mo
Возвраты с неверным статусом00
Проигранные чарджбэки0%24%
Расходящиеся строки отчёта00

Шаги

  1. Кейс Оплаченный заказ и возврат товара

    Заказ ord_5120 оплачен картой: 4 500.00, в базе 450000 минорных единиц.

  2. Проблема Возврат записан поверх платежа

    Первая версия просто уменьшает списанную сумму и меняет статус.

  3. Решение Возврат — новая запись и новая проводка

    Возврат получает свою строку со своим id, суммой, причиной и статусом, и проводку с противоположными знаками, которая ссылается на него.

  4. Проблема Таймаут и второй клик

    Провайдер медленный, запрос падает по таймауту через 10 с.

  5. Решение id возврата — это ключ идемпотентности

    Сервис сначала сохраняет строку возврата rf_2208, затем вызывает провайдера с Idempotency-Key: rf_2208.

  6. Проблема Два сотрудника возвращают одновременно

    После первого возврата осталось 300000.

  7. Решение Проверить и зарезервировать одной командой

    Платёж хранит счётчик refunded_minor.

  8. Решение Провайдер отвечает позже

    Провайдер принял re_51A как pending.

  9. Проблема Банк покупателя забирает деньги

    Другой покупатель пишет в свой банк, что товар не пришёл.

  10. Решение Удержать деньги, ответить до срока

    Спор получает свою строку и статус: needs_response, under_review, затем won или lost.

  11. Решение Каждый день сверяться с отчётом провайдера

    Каждое утро задача загружает отчёт провайдера по возвратам и спорам и сопоставляет каждую строку по id провайдера.

  12. Итоги Итоги

    Шесть правил возврата денег.

Термины

Частичный возврат
Возврат части списанной суммы. Исходный платёж не меняется: это отдельная строка и отдельная проводка, а сумма всех возвратов не должна превышать списанное.
Чарджбэк (chargeback)
Принудительный возврат платежа по претензии банка держателя карты. Деньги списываются с магазина сразу, вернуть их можно только доказательствами до срока.
Срок подачи доказательств
Последний момент, когда магазин может ответить на чарджбэк. После него спор считается проигранным без ответа.
Резерв суммы возврата
Сумма возврата прибавляется к счётчику возвращённого на платеже до вызова провайдера, одним условным update вместе с проверкой лимита. Если возврат не прошёл, резерв снимается.