Шпаргалка · Бизнес-процессы
Возвраты и чарджбэки
Проблема
Магазин возвращает деньги двумя путями: сам делает возврат, полный или частичный, или банк держателя карты забирает деньги через чарджбэк. Оба выглядят как «минус какая-то сумма», и оба ломаются в одних и тех же местах: отредактированная строка платежа, клик, отправленный дважды, два сотрудника, возвращающие одновременно, статус, который приходит только позже вебхуком, и срок спора, за которым никто не следил.
Чему вы научитесь
- Почему возврат — это отдельная запись и отдельная проводка, а исходный платёж никогда не редактируется
- Как ключ идемпотентности и условный 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_dbMermaid: последовательность запросов
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 disputesD2
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_dbPlantUML: последовательность запросов
@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
@endumlPlantUML: компоненты
@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/mo | 0/mo |
| Возвраты сверх списанного | 0/mo | 0/mo |
| Возвраты с неверным статусом | 0 | 0 |
| Проигранные чарджбэки | 0% | 24% |
| Расходящиеся строки отчёта | 0 | 0 |
Шаги
- Кейс Оплаченный заказ и возврат товара
Заказ
ord_5120оплачен картой: 4 500.00, в базе450000минорных единиц. - Проблема Возврат записан поверх платежа
Первая версия просто уменьшает списанную сумму и меняет статус.
- Решение Возврат — новая запись и новая проводка
Возврат получает свою строку со своим id, суммой, причиной и статусом, и проводку с противоположными знаками, которая ссылается на него.
- Проблема Таймаут и второй клик
Провайдер медленный, запрос падает по таймауту через 10 с.
- Решение id возврата — это ключ идемпотентности
Сервис сначала сохраняет строку возврата
rf_2208, затем вызывает провайдера сIdempotency-Key: rf_2208. - Проблема Два сотрудника возвращают одновременно
После первого возврата осталось 300000.
- Решение Проверить и зарезервировать одной командой
Платёж хранит счётчик
refunded_minor. - Решение Провайдер отвечает позже
Провайдер принял
re_51Aкакpending. - Проблема Банк покупателя забирает деньги
Другой покупатель пишет в свой банк, что товар не пришёл.
- Решение Удержать деньги, ответить до срока
Спор получает свою строку и статус:
needs_response,under_review, затемwonилиlost. - Решение Каждый день сверяться с отчётом провайдера
Каждое утро задача загружает отчёт провайдера по возвратам и спорам и сопоставляет каждую строку по id провайдера.
- Итоги Итоги
Шесть правил возврата денег.
Термины
- Частичный возврат
- Возврат части списанной суммы. Исходный платёж не меняется: это отдельная строка и отдельная проводка, а сумма всех возвратов не должна превышать списанное.
- Чарджбэк (chargeback)
- Принудительный возврат платежа по претензии банка держателя карты. Деньги списываются с магазина сразу, вернуть их можно только доказательствами до срока.
- Срок подачи доказательств
- Последний момент, когда магазин может ответить на чарджбэк. После него спор считается проигранным без ответа.
- Резерв суммы возврата
- Сумма возврата прибавляется к счётчику возвращённого на платеже до вызова провайдера, одним условным update вместе с проверкой лимита. Если возврат не прошёл, резерв снимается.