1. 배경

결제를 진행하다보면, 멱등성을 보장해야하는 상황이 있다.

문제가 발생하는 상황

사용자가 의도치 않게, 결제 버튼을 두번 누른다거나
네트워크 지연으로 인해 두번 요청이 가게 되는 경우

결제가 2번 발생할 수 있다.

물론 Toss Payment API 자체에서 중복 결제를 막아주긴한다. 하지만 문제는 다음과 같다.

한번에 주문에 재고가 2번 예약된다. 결제 실패 시, 이를 복구해주긴 하지만, 악의적으로 여러번 예약하는 경우 재고가 부족하여 주문 자체를 못하게 만들 수 있다.
사용자 입장에서 결제 요청이 2번 가는 경우, 무엇을 결제해야 할 지 혼동이 올 수 있다. 이로인해 주문을 처음부터 다시해야하는 불편함이 있을 것이다.

문제의 원인

아래는 현재의 결제 코드이다.

    public TossPaymentConfirmResponse confirmPayment(ConfirmPaymentRequest confirmRequest) {
        log.info("[Payment] 결제 승인 요청, 결제 정보 : 결제 id={}, 주문 id={}, 결제 금액={}",
            confirmRequest.paymentKey(),
            confirmRequest.orderId(), confirmRequest.amount());

        Payment payment = paymentRepository.findById(confirmRequest.paymentId())
            .orElseThrow(() -> new PaymentNotFoundException(confirmRequest.paymentId()));

        OrderSummary order = getConfirmableOrder(payment.getOrderId());

        // payment 만료 여부 검증
        if (payment.isExpired(LocalDateTime.now())) {
            payment.expire();
            paymentRepository.save(payment);
            orderClient.updatePendingOrder(payment.getOrderId());
            throw new PaymentExpiredException(payment.getOrderId(), payment.getId());
        }

        // 종료 상태 결제는 승인 시도 실패로 닫지 않고, 승인 흐름 진입 전에 거부한다.
        payment.validateConfirmableStatus(); // 결제 가능한지 상태 검증
        List<OrderLineSummary> reservedLines = List.of();

        try {
            // 결제 로직 검증
            payment.validateOrderId(confirmRequest.orderId()); // ★ 위치 try문 밖으로 변경. 주문 검증
            payment.validateConfirmAmount(confirmRequest.amount()); // ★ 위치 try 문 밖으로 변경. 수량 검증

            // 결제 승인 처리 시작 및 상태 등록
            payment.start(confirmRequest.paymentKey()); // ★ 핵심 코드 라인 ★

            // 주문 상품 전체 재고 예약 처리
            reservedLines = reserveOrderStocks(order);

            paymentRepository.save(payment);

            TossPaymentConfirmResponse response = tossPaymentClient.confirm(
                new TossPaymentConfirmRequest(confirmRequest.paymentId(),
                    confirmRequest.paymentKey(), confirmRequest.amount()));

            // 결제 승인 완료
            payment.complete();

            log.info("[Payment] 결제 승인 완료. paymentKey={}, paymentId={}, amount={}",
                response.paymentKey(), response.orderId(), response.totalAmount());

            // Order 완료 처리
            orderClient.updateCompleteOrder(payment.getOrderId());

            paymentRepository.save(payment);
            return response;
        } catch (PaymentException | StockException exception) {
            // 해당 결제 실패 처리
            payment.fail();
            paymentRepository.save(payment);

            // Order 상태 pending 변경
            orderClient.updatePendingOrder(payment.getOrderId());

            restoreReservedStocks(reservedLines);

            log.warn("[Payment] 결제 실패. {} \n paymentKey={}, orderId={}, amount={}", exception,
                confirmRequest.paymentKey(), confirmRequest.orderId(), confirmRequest.amount());
            throw new PaymentConfirmExternalException(confirmRequest.paymentId(),
                confirmRequest.paymentKey(), exception);
        } catch (Exception e) {
            log.error(e.getMessage());
            throw new PaymentException("[Payment] 알 수 없는 에러가 발생하였습니다.", e);
        }
    }

위 핵심 코드라인인, payment.start() 에서 상태 변경이 발생한다.

    public void start(String paymentKey) {
        if (this.status != PaymentStatus.NOT_STARTED) {
            throw new PaymentInvalidStatusException(PaymentStatus.NOT_STARTED, this.status);
        }
        registerPaymentKey(paymentKey);
        this.status = PaymentStatus.EXECUTING;
    }

해당 결제가 NOT_STARTED 상태라면, 정상 결제처리가 진행되지만, 해당 상태가 아닌 경우, 에러가 발생하는 코드이다.