# Checkout payment request

이 문서는 체크아웃 서비스가 결제 요청을 처리하는 경로를 설명한다. 독자는 결제 승인 요청이 어느 컴포넌트를 거쳐 저장되는지 빠르게 파악해야 한다.

## 호출 전 조건

클라이언트는 로그인 세션과 장바구니 식별자를 보유한다. 체크아웃 API는 인증 게이트웨이 뒤에 있으며, 인증 게이트웨이는 유효한 세션만 통과시킨다.

## 결제 요청 경로

클라이언트는 HTTPS로 인증 게이트웨이에 결제 요청을 보낸다. 인증 게이트웨이는 검증된 요청을 체크아웃 API로 전달한다.

체크아웃 API는 주문 레코드를 PostgreSQL에 `PENDING` 상태로 기록한 뒤 결제 제공자 API에 승인 요청을 보낸다. 결제 제공자가 승인하면 체크아웃 API는 주문 상태를 `PAID`로 갱신하고 `payment.approved` 이벤트를 이벤트 버스에 발행한다.

<!-- techviz:begin id=payment-request context-sha256=d1449d2ad322f11e735bf5c98ee33311d03ff893ef91eb97b5422f6cc04b0e7c -->
<!-- techviz:generate id=payment-request -->
![클라이언트 결제 요청이 인증 게이트웨이와 체크아웃 API를 거쳐 PostgreSQL, 결제 제공자, 이벤트 버스로 흐르는 데이터 흐름도.](../assets/payment-request.svg)

<details>
<summary>Diagram description</summary>

왼쪽에서 오른쪽으로 읽는다. 클라이언트가 HTTPS 결제 요청을 인증 게이트웨이에 보내고, 검증된 요청이 체크아웃 API로 전달된다. 체크아웃 API는 PostgreSQL에 PENDING 주문을 기록하고 결제 제공자 API에 승인을 요청한다. 승인 응답을 받으면 같은 주문을 PAID로 갱신하고 payment.approved 이벤트를 이벤트 버스에 발행한다. 결제 제공자는 외부 시스템을 나타내는 점선 테두리로 표시된다.

</details>

[Editable source](../assets/payment-request.drawio) · [Grounded VizSpec](../work/payment/spec.json)
<!-- techviz:end id=payment-request -->

## 실패 처리

결제 제공자가 거절하면 체크아웃 API는 주문을 `DECLINED`로 갱신한다. 네트워크 타임아웃은 재시도 정책의 적용 대상이지만, 이 문서에서는 재시도 횟수와 백오프 값을 정의하지 않는다.