Шпаргалка · Бизнес-процессы
Платёжный шлюз
Проблема
Покупатель оплачивает заказ через шлюз, а шлюз четыре раза обращается к вашему магазину. Что значит каждый вызов и где теряются деньги или товар.
Чему вы научитесь
- Четыре вызова: проверить, создать, провести, отменить
- Почему повторный
CreateTransactionдолжен получить тот же ответ - Состояния транзакции:
1,2,-1и-2 - Почему товар уходит только после
state: 2
Диаграмма как код
Итоговая схема урока в виде текста: вставьте её в Jira, GitLab, GitHub, Notion или документацию, там Mermaid рисуется сам. Есть варианты для D2 и PlantUML (Confluence, IntelliJ).
Mermaid: схема
flowchart LR
n_payer(("Покупатель"))
n_gateway>"Шлюз"]
n_api["API магазина"]
n_orders[("База заказов")]
n_warehouse("Склад")
n_payer -->|"вызов"| n_gateway
n_gateway -->|"вызов"| n_api
n_api -->|"вызов"| n_orders
n_api -->|"вызов"| n_warehouseMermaid: последовательность запросов
sequenceDiagram
participant n_gateway as Шлюз
participant n_api as API магазина
participant n_orders as База заказов
participant n_warehouse as Склад
Note over n_gateway,n_api: Проверка: можно ли оплатить заказ?
n_gateway->>n_api: POST /merchant/rpc HTTP/1.1
n_api-->>n_gateway: HTTP/1.1 200 OK
Note over n_gateway,n_api: Создание: открывается транзакция
n_gateway->>n_api: POST /merchant/rpc HTTP/1.1
n_api-->>n_gateway: HTTP/1.1 200 OK
Note over n_gateway,n_api: Одно создание пришло дважды
n_gateway->>n_api: POST /merchant/rpc HTTP/1.1
n_api-->>n_gateway: HTTP/1.1 200 OK
Note over n_api,n_orders: На повтор — тот же ответ
n_api->>n_orders: SELECT id, state, create_time FROM transactions
n_orders-->>n_api: tx_77 #124; 1 #124; 1795392843512
Note over n_gateway,n_api: Проведение: деньги ваши
n_gateway->>n_api: POST /merchant/rpc HTTP/1.1
n_api-->>n_gateway: HTTP/1.1 200 OK
Note over n_gateway,n_api: Товар ушёл раньше денег
n_gateway->>n_api: POST /merchant/rpc HTTP/1.1
n_api-->>n_gateway: HTTP/1.1 200 OK
Note over n_api,n_warehouse: Отгружать только после state: 2
n_api->>n_warehouse: POST /shipments HTTP/1.1
n_warehouse-->>n_api: HTTP/1.1 201 Created
Note over n_gateway,n_api: Отмена оплаченной транзакции
n_gateway->>n_api: POST /merchant/rpc HTTP/1.1
n_api-->>n_gateway: HTTP/1.1 200 OKD2
direction: right
n_payer: "Покупатель" {
shape: person
}
n_gateway: "Шлюз" {
shape: cloud
}
n_api: "API магазина" {
shape: rectangle
}
n_orders: "База заказов" {
shape: cylinder
}
n_warehouse: "Склад" {
shape: rectangle
style.multiple: true
}
n_payer -> n_gateway: "вызов"
n_gateway -> n_api: "вызов"
n_api -> n_orders: "вызов"
n_api -> n_warehouse: "вызов"PlantUML: последовательность запросов
@startuml
boundary "Шлюз" as n_gateway
participant "API магазина" as n_api
database "База заказов" as n_orders
participant "Склад" as n_warehouse
note over n_gateway, n_api : Проверка: можно ли оплатить заказ?
n_gateway -> n_api : POST /merchant/rpc HTTP/1.1
n_api --> n_gateway : HTTP/1.1 200 OK
note over n_gateway, n_api : Создание: открывается транзакция
n_gateway -> n_api : POST /merchant/rpc HTTP/1.1
n_api --> n_gateway : HTTP/1.1 200 OK
note over n_gateway, n_api : Одно создание пришло дважды
n_gateway -> n_api : [дубль] POST /merchant/rpc HTTP/1.1
n_api --> n_gateway : HTTP/1.1 200 OK
note over n_api, n_orders : На повтор — тот же ответ
n_api -> n_orders : SELECT id, state, create_time FROM transactions
n_orders --> n_api : tx_77 | 1 | 1795392843512
note over n_gateway, n_api : Проведение: деньги ваши
n_gateway -> n_api : POST /merchant/rpc HTTP/1.1
n_api --> n_gateway : HTTP/1.1 200 OK
note over n_gateway, n_api : Товар ушёл раньше денег
n_gateway -> n_api : POST /merchant/rpc HTTP/1.1
n_api --> n_gateway : HTTP/1.1 200 OK
note over n_api, n_warehouse : Отгружать только после state: 2
n_api -> n_warehouse : POST /shipments HTTP/1.1
n_warehouse --> n_api : HTTP/1.1 201 Created
note over n_gateway, n_api : Отмена оплаченной транзакции
n_gateway -> n_api : POST /merchant/rpc HTTP/1.1
n_api --> n_gateway : HTTP/1.1 200 OK
@endumlPlantUML: компоненты
@startuml
left to right direction
actor "Покупатель" as n_payer
cloud "Шлюз" as n_gateway
component "API магазина" as n_api
database "База заказов" as n_orders
collections "Склад" as n_warehouse
n_payer --> n_gateway : вызов
n_gateway --> n_api : вызов
n_api --> n_orders : вызов
n_api --> n_warehouse : вызов
@endumlИтог
Четыре правила для платёжного шлюза.
1) Суммы в минимальных единицах, без дробей. 2) Любой вызов может повториться: ищите по ID шлюза и возвращайте тот же ответ. 3) Товар уходит только после state: 2. 4) У отмены два случая: -1 до денег, -2 после.
Показатели: в начале и в конце
| Показатель | В начале | В конце |
|---|---|---|
| Ответ p95 | 120 мс | 140 мс |
| Двойные списания | 0/день | 0/день |
| Отгружено без оплаты | 0/день | 0/день |
Шаги
- Кейс Проверка: можно ли оплатить заказ?
Покупатель вводит карту в шлюзе.
- Кейс Создание: открывается транзакция
Шлюз заблокировал деньги и просит магазин открыть транзакцию для заказа.
- Проблема Одно создание пришло дважды
API работал медленно, у шлюза истёк таймаут, и он отправил
CreateTransactionповторно с тем жеid. - Решение На повтор — тот же ответ
Перед созданием API ищет транзакцию по ID шлюза.
- Кейс Проведение: деньги ваши
Шлюз списывает деньги с карты и просит магазин провести транзакцию.
- Проблема Товар ушёл раньше денег
Магазин передал заказ на склад сразу после создания транзакции.
- Решение Отгружать только после
state: 2Склад теперь получает заказ только после
PerformTransaction. - Кейс Отмена оплаченной транзакции
Покупатель просит вернуть деньги.
- Итоги Итоги
Четыре правила для платёжного шлюза.