결제 실패 처리 전략 - Workaway

chaean·2025년 5월 10일

Workaway

목록 보기

4/11

결제 시스템을 개발하다 보면 ‘성공’만큼이나 중요한 것이 바로 ‘실패 처리’입니다.
특히 결제 실패 시 예약 상태를 어떻게 처리할 것인지, 실패 데이터를 어떻게 보존할 것인지에 따라 사용자 경험과 데이터 무결성에 큰 영향을 줍니다.

이번 글에서는 PortOne V2 결제 시스템을 Spring Boot 기반으로 구현하며 겪었던 결제 실패 처리 이슈와 그 해결 과정을 정리했습니다.

PortOne V2 기반 결제 시스템 설계 및 검증 로직 구현기 - TRIO

🧾 문제 상황 - 결제 실패인데 예약 상태가 그대로⁇

제가 구현한 시스템은 다음과 같은 결제 흐름을 가지고 있습니다.

1. 임시 예약 생성 → 예약 상태 : PENDING
2. PortOne 결제 → 검증 API 호출
3. 유효성 검사 이것저것...
4. 검증 실패 시 예약 상태 FAILED로 변경

하지만.. 금액이 일치하지 않아 예외를 던졌는데도 예약 상태가 여전히 PENDING으로 남아있었습니다.

🫵 원인 : Transaction Rollback

이유는 단순했습니다.
결제 검증 로직 전체가 하나의 @Transcational 안에서 실행되고 있었기 때문입니다.

@Transactional
public void 검증클래스(...) {
    // 예약 상태를 FAILED로 변경
    reservation.updateStatus(FAILED);
    reservationRepository.save(reservation);

    // 이후 금액 불일치 발생 → 예외 발생
    if (!amountMatches()) {
        throw new BusinessException(...);
    }

    // 트랜잭션 전체 롤백 → 상태 업데이트도 무효 처리됨
}

위와 같은 코드에서 updateStatus(FAILED)는 수행되었고, save()까지 호출되었지만,
결과적으로 DB에 반영되지 않았습니다.

이유는 단순합니다.
예외가 발생하면 Spring의 기본 @Transactional은 전체 트랜잭션을 롤백시키기 때문입니다.
즉, 상태 업데이트 → 예외 발생 → 전체 롤백 → 아무것도 저장되지않음...

？ 이게 왜

트랜잭션이란 본래 원자성을 보장하기 위한 수단입니니다.
하지만 모든 데이터를 무조건 함께 커밋하거나 롤백해야하나??

아닙니다.
도메인 관점에서 반드시 보존해야 할 상태 변화가 존재한다면, 그에 알맞게 트랜잭션을 나눠야 합니다.

예약 실패는 사용자에게 반드시 보여줘야 할 상태이다.
이 상태가 롤백된다면, 사용자 입장에서는 여전히 예약이 살아 있는 것처럼 보인다.
하지만 실제로 결제는 실패.

비즈니스 상 모순이 발생합니다.

⭐️ 해결 방법 : 트랜잭션 분리

전략 1 : @Transactional(propagation = REQUIRES_NEW)

예약 상태 변경만 별도의 트랜잭션으로 분리하여 커밋합니다.

@Service
public class 상태_업데이트_서비스 {

    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void 상태업데이트해줘(Reservation reservation, Status status) {
        reservation.changeStatus(status);
        reservationRepository.save(reservation)
    }
}

논리적 트랜잭션 경계를 분리
기존 트랜잭션이 롤백되더라도, 해당 트랜잭션은 독립적으로 유지되며 커밋된다.
결제 실패 -> 예약 실패 기록은 반드시 남겨야 하는 정보이기 때문에, 이런 방식이 필수적이다.
동기적으로 동작하기 때문에 해당 방식을 채택하였습니다.

주의

@Transactional(propagation = REQUIRES_NEW)는 AOP기반으로 동작하기 때문에, 같은 클래스에서 호출할 시 Spring AOP 프록시가 적용되지 않아 동작하지 않습니다.

전략 2 : Spring Event

Spring Event 기반의 실패 처리도 대안이 될 수 있습니다.

@Component
public class PaymentEventListener {

    @Transactional
    @EventListener
    public void handlePaymentFailed(PaymentFailedEvent event) {
        상태_업데이트_서비스.상태업데이트해줘(예약, 상태);
    }
}