mufassall

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

Платёжный шлюз

14 мин · Средний · mufassall.dtwin.uz/ru/l/payments/

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

Проблема

Покупатель оплачивает заказ через шлюз, а шлюз четыре раза обращается к вашему магазину. Что значит каждый вызов и где теряются деньги или товар.

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

  • Четыре вызова: проверить, создать, провести, отменить
  • Почему повторный 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_warehouse

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

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 OK

D2

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
@enduml

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

@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 после.

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

ПоказательВ началеВ конце
Ответ p95120 мс140 мс
Двойные списания0/день0/день
Отгружено без оплаты0/день0/день

Шаги

  1. Кейс Проверка: можно ли оплатить заказ?

    Покупатель вводит карту в шлюзе.

  2. Кейс Создание: открывается транзакция

    Шлюз заблокировал деньги и просит магазин открыть транзакцию для заказа.

  3. Проблема Одно создание пришло дважды

    API работал медленно, у шлюза истёк таймаут, и он отправил CreateTransaction повторно с тем же id.

  4. Решение На повтор — тот же ответ

    Перед созданием API ищет транзакцию по ID шлюза.

  5. Кейс Проведение: деньги ваши

    Шлюз списывает деньги с карты и просит магазин провести транзакцию.

  6. Проблема Товар ушёл раньше денег

    Магазин передал заказ на склад сразу после создания транзакции.

  7. Решение Отгружать только после state: 2

    Склад теперь получает заказ только после PerformTransaction.

  8. Кейс Отмена оплаченной транзакции

    Покупатель просит вернуть деньги.

  9. Итоги Итоги

    Четыре правила для платёжного шлюза.