염영인 이력서
  • 질문하기
  • 경력
  • 프로젝트
  • 기술
이전 대표 사례Harness Engineering 기반 AI 개발 환경 구축위로 계속 스크롤하면 넘어가요
대표 사례

대표 사례 1/4 · PG 연동·결제 정합성

결제 멱등성 및 상태 정합성 확보

GuideME, 퍼플아카데미, 로워드에서 PG 결제부터 결제 검증, 후속 비즈니스 로직까지 이어지는 결제 프로세스 구현. 중복 요청과 동시성 문제에 대응해 결제 멱등성을 확보하고, PG 결제 상태와 서비스 내 주문·예약·입학 상태를 연동해 데이터 정합성 유지.

사례
PG 결제 시스템
역할
로워드 · 퍼플아카데미 · GuideME · 백엔드
기술
Toss Payments · PostgreSQL · TypeORM · Idempotency
이 사례에 대해 AI에게 묻기

프레스런 — 중복 요청에도 결제 결과가 한 번만 반영되도록 처리

문제 상황

프레스런에서는 Toss Payments로 카드 결제, 가상계좌, 분할결제, 결제 수단 변경 기능을 구현했습니다. 결제 방식이 다양해지면서 하나의 결제에 여러 승인 시도와 상태 변경이 생길 수 있었습니다.

예를 들어 사용자가 결제 완료 후 페이지를 새로고침하거나, 가상계좌 입금 통보와 결제 기한 만료 배치가 비슷한 시점에 실행되는 상황을 고려해야 했습니다. 이때 같은 결제 건이 중복 처리되거나, 실제 결제는 완료됐는데 서비스에서는 실패로 기록되지 않도록 하는 것이 중요했습니다.

이력 분리

먼저 결제 정보와 개별 결제 시도를 구분해 관리했습니다.

payments: 하나의 결제에 대한 정보

payment_transactions: 분할결제 회차, 승인 시도, 결제 수단 변경 등에 따른 개별 결제 건

이렇게 나누면 하나의 결제에서 여러 차례 시도가 생겨도 각각의 이력을 남길 수 있습니다. 또 PG 주문번호와 (결제 ID, 회차, 시도) 조합에 Unique 인덱스를 걸어, 애플리케이션의 중복 확인과 별개로 DB에서도 같은 결제 건이 중복 생성되지 않도록 했습니다.

동시 요청

결제 승인 요청, 가상계좌 입금 통보, 결제 기한 만료 배치는 모두 같은 결제 건의 상태를 바꿀 수 있습니다. 상태를 먼저 조회한 뒤 바꾸는 방식만 쓰면, 두 요청이 같은 대기 상태를 보고 각각 처리를 진행할 수 있습니다.

그래서 PG 승인 결과를 반영하거나 만료 처리를 할 때 대기 상태인 결제 건만 바꿀 수 있도록 조건부 UPDATE를 적용했습니다. 상태 변경에 성공한 요청만 후속 처리를 진행하고, 이미 상태가 바뀐 결제 건은 다시 반영하지 않습니다.

분할결제에서는 여러 회차의 승인 처리가 겹칠 수 있어 주문 완료 상태를 바꾸는 요청도 같은 방식으로 한 번만 성공하게 했습니다. 이를 통해 수강권과 적립금이 중복 지급되지 않도록 했습니다.

승인 요청, 입금 통보, 만료 배치가 같은 결제 건에 들어오면 대기 상태인 결제 건만 바꾸는 조건부 UPDATE로 한 요청만 성공한다. 성공한 요청만 후속 처리를 하고, 실패한 요청은 결제키를 대조해 중복이면 종료하고 다르면 PG 결제를 취소한다. 실제 코드 일부를 함께 보여준다.
같은 결제 건에 여러 요청이 들어올 때의 처리 흐름과 실제 코드 일부

상태 확인

결제 API를 호출했다고 해서 돌아온 성공·실패 응답만으로 최종 상태를 판단하지 않았습니다. 사용자가 승인 요청을 중복으로 보내면 Toss Payments는 이미 처리된 결제라는 오류를 돌려줄 수 있는데, 이 오류를 그대로 결제 실패로 저장하면 실제로는 결제가 완료됐지만 서비스에서는 실패로 기록되는 상황이 생깁니다.

따라서 승인 API에서 오류가 나면 PG에 결제 상태를 다시 조회해 실제 승인 여부를 확인했습니다. PG에서는 승인됐지만 내부 결제 건이 이미 종료된 경우에는 결제키를 비교했습니다.

결제키가 같으면 이미 처리된 요청의 중복 호출로 판단

결제키가 다르면 받을 자리가 없는 결제이므로 해당 PG 결제를 취소

가상계좌 입금 통보도 마찬가지로, 통보 요청의 secret을 검증한 뒤 전달받은 본문만으로 입금 완료를 확정하지 않고 결제사에 실제 상태를 다시 조회했습니다. 승인 금액과 결제 수단이 요청한 내용과 일치하는지도 확인했습니다.

결과

결제 시도와 상태 변경이 겹치는 상황에서도 결제 결과가 한 번만 반영되는 구조를 만들었습니다.

결제 시도 이력 분리와 DB Unique 제약으로 중복 데이터 생성 방지

승인·입금 통보·만료 처리의 동시 실행을 고려한 상태 변경 로직 구현

PG 상태 재조회로 중복 승인 응답과 내부 결제 상태 불일치에 대응

주문 완료 상태를 기준으로 수강권·적립금 중복 지급 방지

퍼플아카데미 — 여러 PG 상점과 결제 방식에 대응하는 구조

문제 상황

퍼플아카데미에서는 과세·면세 여부, 상품 종류, 일반결제·BrandPay 여부에 따라 서로 다른 Toss 상점 인증 정보를 써야 했습니다. 2개의 Toss 상점에서 6개의 키를 관리하는 구조였습니다.

결제 서비스 안에서 상품 조건마다 인증 정보를 고르고 PG API를 직접 호출하면, 결제 방식이 추가되거나 상점 정보가 바뀔 때 고쳐야 할 코드가 많아집니다. 그래서 어떤 상점을 쓸지 결정하는 로직과 실제 결제를 실행하는 로직을 분리했습니다.

구조 분리

두 가지 Resolver와 Gateway 구조를 적용했습니다.

TossStoreResolver: 과세·면세 여부, 상품 카테고리, 결제 방식에 따라 사용할 storeKey를 선택

PgGatewayResolver: 선택된 상점과 결제 방식에 맞춰 TossPaymentGateway 또는 BrandPayGateway 구현체를 반환

각 Gateway는 공통 인터페이스로 승인과 취소 기능을 제공합니다. 그 결과 PaymentService는 Toss 상점의 인증 정보나 결제 방식별 API 호출 구현을 직접 다루지 않아도 됐고, 새 상점이나 결제 방식이 추가되더라도 고칠 곳을 Resolver와 Gateway로 한정할 수 있었습니다.

결제 요청의 상품 카테고리, 과세·면세, 결제 방식으로 TossStoreResolver가 storeKey를 고르고, PgGatewayResolver가 TossPaymentGateway 또는 BrandPayGateway를 반환한다. PaymentService는 공통 인터페이스로 승인과 취소만 호출한다.
TossStoreResolver와 PgGatewayResolver 구조

결과

상점 선택과 PG 호출의 책임을 분리하고, 결제·입학 상태를 연동했습니다.

2개 Toss 상점과 6개 인증 키를 결제 조건에 따라 선택하는 구조 구현

Resolver와 Gateway의 책임 분리를 통해 상점 선택 정책과 PG 호출 로직 간 결합도 감소

관심사 분리와 컴포넌트별 책임 정의를 통해 결제 시스템의 확장성 및 유지보수성 강화

GuideME — 예약 충돌을 방지하고 정산까지 이어지는 결제 처리

문제 상황

GuideME는 여행자가 현지 가이드를 예약하고 결제하는 서비스입니다. 일반적인 상품 구매와 달리 결제가 끝난 뒤에도 예약 확정, 서비스 진행, 서비스 완료, 정산까지 거래가 이어집니다. 그래서 결제 완료 여부뿐 아니라 예약 가능 상태와 정산 조건까지 함께 관리해야 했습니다.

특히 테스트 과정에서 같은 가이드의 동일한 시간대에 두 건의 예약이 동시에 결제 완료되는 문제가 있었습니다. 예약 가능 여부를 애플리케이션에서 확인하더라도, 두 요청이 거의 동시에 처리되면 각각 예약 가능한 상태라고 판단할 수 있었습니다.

중복 방지

주문과 결제 내역에는 각각 고유 식별자를 사용했습니다. 이미 처리한 주문이나 결제인지 애플리케이션에서 먼저 확인하고, DB에도 Unique 제약조건을 걸어 재시도나 중복 요청으로 같은 주문·결제 데이터가 반복 생성되지 않도록 했습니다.

예약 충돌

동일 시간대의 중복 예약을 방지하기 위해 애플리케이션의 예약 가능 여부 검증과 함께 PostgreSQL의 `tstzrange` 및 GiST 인덱스 기반 Exclusion Constraint를 적용했습니다.

예약 시작·종료 시간을 범위로 관리하고, 동일 가이드에게 겹치는 시간대의 예약이 생성되지 않도록 DB 수준에서 제약조건을 설정했습니다. 이를 통해 동시 예약 요청이 발생하더라도 데이터베이스에서 중복 예약을 차단해 예약 정합성을 확보했습니다.

같은 가이드에게 14시부터 16시 예약 A가 저장된 상태에서 15시부터 17시 예약 B가 들어오면 시간 범위가 겹쳐 Exclusion Constraint가 저장을 거부한다.
같은 시간대 예약 충돌과 Exclusion Constraint (설명용 가상 시간대)

정산 관리

GuideME의 거래는 결제 완료만으로 끝나지 않기 때문에 예약과 서비스 진행 상태를 상태 머신으로 구분해 관리했습니다. 정산은 결제 직후 처리하지 않고, 매일 새벽 실행되는 배치 작업에서 정산 가능한 거래를 확인합니다. 정산 대상은 다음 조건을 모두 만족하는 거래로 제한했습니다.

결제가 정상적으로 완료된 거래

가이드 서비스가 정상적으로 완료된 거래

환불이 발생하지 않은 거래

조건을 만족하는 거래만 트랜잭션 단위로 정산하도록 구현했습니다.

결과

결제 이후 예약 충돌과 정산 조건까지 이어지는 거래 상태 관리 구조를 만들었습니다.

주문 ID와 결제 ID 기반 중복 처리 방지

PostgreSQL Exclusion Constraint로 동일 가이드·시간대 예약 충돌 방지

결제·예약·서비스 완료·환불 상태를 고려한 정산 처리

다음 대표 사례 · 메시지 큐·장애 격리메시지 큐 기반 비동기 처리 시스템 구축메시지 큐 처리아래로 계속 스크롤하면 넘어가요