왜 멀티 PG 전환에서 사고가 일어나고 어디부터 막아야 할까?

거래 규모가 커지거나 해외 결제와 간편결제를 넓히는 서비스는 단일 결제대행사(PG)에만 의존하기 어렵습니다. 수수료 협상력을 높이고 특정 PG나 카드사·VAN 구간의 장애에서 매출 손실을 줄이려고 두 곳 이상의 PG를 연결합니다. 그러나 API 두 벌을 조건문으로 이어 붙인 구조는 장애 순간에 매출을 지키기보다 이중 결제와 정산 누락을 먼저 일으킵니다.

사고가 집중되는 지점은 대체로 세 곳입니다. 첫째는 주력 PG의 승인 응답이 늦어졌을 때 앞선 거래의 성사 여부를 확정하지 않은 채 보조 PG로 새 승인을 요청하는 경우입니다. 둘째는 라우팅 규칙을 바꾼 뒤 과거 주문의 취소·부분 환불 요청이 원 거래 PG가 아니라 새로 바뀐 PG로 전달되는 경우입니다. 셋째는 PG마다 다른 웹훅 재전송 규칙과 정산 파일 형식이 주문 상태를 서로 덮어쓰는 경우입니다.[2][6]

멀티 PG 아키텍처의 목적은 결제사 이름을 동적으로 바꾸는 데 있지 않습니다. 주문과 회계 시스템이 개별 PG의 응답 형식에 흔들리지 않도록 공통 게이트웨이 계층을 두고, 어느 거래가 어느 PG·상점 계정(MID)에서 어떤 상태로 처리됐는지 추적 가능한 단일 원장으로 묶는 것이 핵심입니다.[7]

단일 PG 환경의 주문·결제·제공 상태 분리는 결제는 성공했는데 주문은 없다: 결제·주문 상태를 맞추는 설계에서 다룹니다. 이 글은 그 상태 모델 위에 복수의 PG와 간편결제를 올릴 때 필요한 어댑터 경계, 장애 우회 조건, 빌링키 제약, 취소 귀속과 정산 정규화 기준을 정리합니다.

주문 로직과 PG 어댑터는 어떤 경계로 나누어야 할까?

새 결제사를 추가할 때마다 장바구니, 주문서, 쿠폰 차감, 환불 화면과 관리자 페이지를 모두 고쳐야 한다면 게이트웨이 계층이 없는 상태입니다. 주문 시스템은 “이 주문에 얼마를 승인·취소해야 하는가”만 알고, 실제 PG별 파라미터 조립과 서명 검증은 게이트웨이 내부의 어댑터가 맡아야 합니다.

공통 계층과 어댑터의 책임을 나누면 결제사 하나를 더할 때 변경 범위를 어댑터 한 모듈과 정산 파서 하나로 가둘 수 있습니다. 토스페이먼츠처럼 클라이언트 인증 뒤 서버 승인(confirm)을 호출하는 흐름과 해외 PG의 Payment Intent 기반 흐름도 내부에서는 동일한 결제 시도 생명주기로 매핑합니다.[2][5]

계층담당하는 역할보관해야 할 핵심 데이터개별 PG 어댑터로 넘길 일
주문·청구 계층구매 금액 계산, 할인·재고 확정, 상품 제공 지시내부 주문 ID, 품목별 결제 대상 금액, 이행 상태없음 (PG 이름을 직접 참조하지 않음)
결제 게이트웨이 코어라우팅 결정, 결제 시도 생성, 멱등성 제어, 상태 전이결제 시도 ID, 선택된 PG·MID, 내부 표준 상태, 라우팅 사유승인·취소·조회 호출 시점과 재시도 한도 지시
PG 어댑터 계층PG별 API 호출, 인증 헤더·멱등 키 생성, 응답 코드 변환PG 원본 거래 키, PG 원본 응답 코드·시각, 요청 페이로드 해시각 PG 규격에 맞는 HTTP 요청과 오류 코드 매핑
웹훅·대사 수집기서명 검증, 중복 이벤트 제거, 정산 파일 표준화웹훅 수신 ID, 정규화된 거래·수수료·정산 예정일 행PG별 서명 알고리즘 검증과 CSV·API 파싱

내부 표준 상태는 특정 PG의 문자열을 그대로 쓰지 않습니다. PREPARED(시도 생성), AUTH_COMPLETED(인증 완료), CAPTURE_PENDING(승인 미확정), CAPTURED(승인 확정), CANCELED(취소 확정), FAILED(거절)처럼 다음 행동을 기준으로 정의합니다.[2][4]

결제 시도마다 PG와 상점 식별자를 불변으로 남깁니다

한 주문에서 첫 번째 PG 호출이 거절되어 두 번째 PG로 다시 결제했다면 내부 주문은 하나지만 결제 시도는 두 건입니다. 각 결제 시도 레코드에는 선택한 PG 코드, 상점 아이디(MID), 통화, 적용된 라우팅 규칙 버전과 멱등 키를 생성 시점에 고정해 둡니다.[3][5]

이 시점의 기록이 없으면 나중에 관리자 화면에서 “왜 이 주문이 B 결제사로 넘어갔는가”를 설명할 수 없고, 부분 취소나 정산 대사에서도 어느 상점 계정으로 조회해야 하는지 잃어버립니다. 결제사를 추가하기 전의 선정 기준은 PG 선정 가이드에서 함께 점검합니다.

서비스 작동 방식

하나의 거래 규격으로 여러 결제 경로 연결 — 결제사별 차이를 연동 계층에서 흡수하고 라우팅과 거래 상태를 같은 기준으로 관리합니다.

결제 전 라우팅과 승인 후 장애 우회는 어디서 갈라질까?

멀티 PG에서 가장 위험한 오해는 “주력 PG 호출이 실패하면 catch 블록에서 보조 PG를 호출한다”는 구현입니다. 결제 흐름은 구매자 인증 이전(결제창을 띄우기 전)과 서버 승인 호출 이후(돈이 움직이는 단계)로 나뉘며, 두 구간의 우회 가능 조건은 완전히 다릅니다.[2][7]

결제창을 열기 전에는 PG의 상태 점검 결과, 카드사 점검 공지, 결제 수단, 통화, 수수료율이나 가중치 규칙에 따라 다른 PG를 자유롭게 배정합니다. 반면 구매자가 이미 특정 PG의 결제창에서 인증을 마쳤다면 그 인증 토큰은 다른 PG에서 승인할 수 없습니다. 더 나아가 서버가 승인 API를 호출한 뒤 네트워크 타임아웃이나 5xx 응답을 받았다면 거래가 실제로 승인됐는지 거절됐는지 알 수 없는 미확정 상태가 됩니다.[3][4]

발생 시점과 상황원 거래의 결제 성사 가능성다른 PG로 즉시 우회 가능 여부안전한 처리 절차
결제창 호출 전 라우팅 단계(점검 공지·회로 차단기 열림)없음 (호출 전)가능보조 PG의 결제창과 MID로 새 결제 시도 생성
구매자 인증 단계에서 사용자 취소 또는 인증 실패없음 (승인 미호출)가능 (새 결제 시도로 전환)기존 시도를 종료하고 새 시도로 다른 PG 결제창 제시
서버 승인 요청 전 파라미터·서명 검증 오류(4xx 명확한 거절)없음조건부 가능 (입력값 수정 또는 새 인증 필요)오류 코드 확인 후 재인증 유도, 동일 인증 토큰 재사용 금지
서버 승인 요청 후 응답 타임아웃·연결 끊김·5xx있음 (결과 미확정)금지 (즉시 우회 시 이중 결제 위험)동일 멱등 키·거래 키로 원 PG 상태 조회 또는 망취소 확정 후 판단
원 PG 조회 결과 미승인·망취소 완료가 확인된 뒤없음 (종료 확인됨)가능 (구매자 재인증 필요)기존 시도를 실패 확정으로 닫고 보조 PG로 새 결제 시도 안내

토스페이먼츠와 Stripe의 멱등성 문서는 모두 네트워크 오류 시 같은 멱등 키(Idempotency-Key)로 같은 결제사에 재요청하거나 조회 API로 결과를 먼저 확인하도록 안내합니다.[3][5] 멱등 키는 같은 PG 내부의 중복 승인만 막아줄 뿐, 우리 서버가 다른 PG로 새 요청을 보내는 것까지 막아주지 않습니다.

회로 차단기(Circuit Breaker)는 신규 결제창 진입만 바꿉니다

연쇄 장애를 막으려면 승인 실패율이나 응답 지연이 임계치를 넘었을 때 회로 차단기가 신규 트래픽의 기본 PG를 보조 PG로 전환해야 합니다.[7] 이때 전환 대상은 새로 결제창에 진입하는 주문입니다.

이미 주력 PG에서 인증을 마치고 승인 대기 중인 거래(CAPTURE_PENDING)는 회로 차단기가 열렸다는 이유로 보조 PG에 넘기지 않습니다. 진행 중이던 거래는 원 PG의 조회·망취소 파이프라인으로 끝까지 매듭을 지어야 두 결제사에 동시에 승인이 남는 사고를 막을 수 있습니다.

정기결제 빌링키와 카드 토큰은 왜 PG 사이에 호환되지 않을까?

일반 단건 결제와 달리 정기결제(구독 빌링)와 간편 재결제는 등록된 빌링키(billingKey)나 고객 결제 수단 토큰으로 승인을 요청합니다. 많은 팀이 “정기결제도 주력 PG가 죽으면 보조 PG로 승인하면 되지 않는가”라고 묻지만, 일반 PG가 발급한 빌링키는 해당 PG와 상점 계정(MID) 안에서만 유효한 참조값입니다.

A 결제사에서 발급받은 빌링키를 B 결제사의 승인 API에 넣으면 유효하지 않은 키로 거절됩니다. 카드 번호 원문을 우리 서버가 보관하지 않고 PG에 위탁해 토큰만 받는 구조 자체가 카드 데이터 보안 표준(PCI DSS)의 보호 범위를 줄이기 위한 설계이기 때문입니다.[1]

  1. 단일 빌링키 + 시간차 재시도 모델: PCI DSS 범위를 넓히지 않는 서비스는 기존 빌링키로 승인을 요청하되, 일시 장애 시 다른 PG로 넘기는 대신 백오프 재시도와 유예 기간으로 복구를 기다립니다.
  2. 예비 결제 수단(Backup Payment Method) 모델: 주 결제 수단 외에 다른 PG나 간편결제 보조 수단을 미리 등록하게 하고, 주 경로가 영구 거절되거나 중단될 때 사전 고지된 규칙에 따라 청구합니다.
  3. 결제 수단 재등록 유도 모델: 특정 PG 계정을 폐지하거나 주력 PG를 영구 이전할 때는 갱신 시점의 고객에게 새 PG 기반 결제 수단 변경을 안내하고, 이전 완료 전까지 구 PG의 환불 경로를 유지합니다.

정기결제의 상태 전이와 재시도·유예 설계는 정기결제 API를 붙이면 구독 서비스가 완성되는 걸까에서 자세히 다룹니다. 멀티 PG를 정기결제에 도입할 때는 “실시간 무중단 자동 전환”을 가정하기보다 빌링키의 귀속 주체와 재등록 동선을 먼저 확인해야 합니다.

취소와 부분 환불은 왜 현재 라우팅 규칙을 따르면 안 될까?

결제 승인 비중을 A PG 80%·B PG 20%에서 B PG 100%로 바꾼 날에도, 어제 A PG로 결제한 고객의 취소와 부분 환불 요청은 계속 들어옵니다. 만약 취소 모듈이 “현재 기본 PG” 설정을 읽어 B PG로 취소 API를 호출하면 원 거래가 없다는 오류로 모든 환불이 멈춥니다.

취소와 부분 환불은 라우팅 엔진을 거치지 않고 원 결제 시도 레코드에 기록된 pg_provider, merchant_id(MID), pg_transaction_id로 직행해야 합니다. 한 주문을 여러 차례 부분 취소할 때도 각 취소 시도는 원 결제 시도의 자식으로 묶이고, 취소 가능 잔액은 원 결제의 승인액과 누적 취소액을 기준으로 검산합니다.[2]

취소·환불 시나리오라우팅·귀속 기준검증해야 할 정합성 조건실패 시 보호 장치
라우팅 규칙 변경 후 과거 주문 전체 취소원 결제 시도의 PG·MID·원 거래 키 고정원 거래 상태가 승인 확정(CAPTURED)인지 확인현재 라우팅 테이블 참조 금지
단일 결제의 다회차 부분 취소원 결제 시도의 PG + 취소 회차별 고유 멱등 키누적 취소액 + 이번 취소액 ≤ 원 승인 금액할인가·배송비 재계산 후 잔액 불일치 시 보류
포인트·쿠폰·PG 복합 결제의 부분 취소환불 우선순위 규칙에 따라 내부 차감분과 PG 취소분 분리PG로 보낼 실제 현금 환불액과 내부 복원액의 합 일치한쪽만 반영된 경우 보상 대기 상태로 격리
승인 직후 응답 유실 건의 망취소승인 요청에 썼던 동일 PG·MID·원 주문 식별자조회 결과 승인 여부에 따라 취소 또는 미승인 확정망취소 응답 유실 시 재조회 큐로 이관

부분 취소에서 할인·배송비·과세/면세 금액이 어긋나는 계산 문제는 부분 취소 때 금액이 어긋나는 이유: 할인·배송비·환불을 나누어 설계하기의 원칙을 그대로 따릅니다. 멀티 PG 환경에서는 여기에 PG별로 다른 부분 취소 제약(예: 특정 간편결제나 구형 계약의 부분 취소 횟수·기간 제한)을 어댑터 메타데이터로 함께 관리해야 합니다.

서비스 작동 방식

주문에서 승인과 환불까지 상태를 연결 — 결제수단을 주문 흐름에 붙이고 응답 지연과 재시도, 취소와 환불의 예외를 검증합니다.

서로 다른 웹훅과 정산 파일을 어떻게 하나의 원장으로 맞출까?

PG마다 웹훅의 이벤트 이름, 서명 헤더, 타임아웃, 재전송 주기가 다릅니다. 토스페이먼츠는 웹훅 수신 후 10초 이내 HTTP 200 응답을 요구하고 실패 시 최대 7회 재전송하며, Stripe는 엔드포인트 비밀키 기반의 Stripe-Signature 검증과 비순차 전달 가능성을 명시합니다.[2][6]

웹훅 수신기는 각 PG 어댑터가 서명과 출처를 검증한 뒤 원본 페이로드를 영속 저장하고 즉시 200을 반환하도록 구성합니다. 실제 주문 상태 반영은 내부 표준 이벤트로 변환한 뒤 공통 상태 전이 규칙을 통과하게 해야, 늦게 도착한 승인 웹훅이 이미 취소된 주문을 다시 확정 상태로 되돌리는 일을 막을 수 있습니다.

정산 대사는 PG 원본을 공통 원장 스키마로 정규화한 뒤 비교합니다

회계와 재무팀이 겪는 가장 큰 고충은 PG가 늘어날수록 정산 엑셀과 API 형식이 제각각이라는 점입니다. 어떤 PG는 거래 발생일 기준으로 묶고, 어떤 PG는 매입 완료일이나 입금 예정일 기준으로 묶으며, 부가세와 수수료의 원단위 반올림·절사 규칙도 다릅니다.

  • 1단계(원본 수집): 각 PG의 정산 API나 파일을 수정 없이 원본 테이블에 적재하고 수집 시각과 파일 해시를 남깁니다.
  • 2단계(공통 스키마 정규화): PG 코드, MID, 원 거래 키, 내부 결제 시도 ID, 거래 구분(승인/취소), 총 거래액, PG 수수료, 부가세, 정산 예정액, 지급 예정일로 열을 통일합니다.
  • 3단계(3자 대사): 내부 주문·결제 원장, 정규화된 PG 정산 원장, 실제 은행 입금 내역을 대조해 누락 거래, 수수료율 차이, 입금 보류 건을 자동으로 분류합니다.

대사 기준과 예외 분류 설계는 주문액·PG 내역·입금액이 다를 때 무엇을 기준으로 대사할까와 정산 자동화 자료에서 이어서 확인할 수 있습니다.

출시 전에 어떤 전환·장애 시나리오를 시험해야 할까?

멀티 PG 게이트웨이는 정상 승인 1건이 통과했다고 출시할 수 있는 시스템이 아닙니다. 운영 전환 전에 격리된 샌드박스 환경과 장애 주입(fault injection) 테스트로 다음 여섯 가지 경계를 반드시 검증해야 합니다.

시험 시나리오주입할 조건합격 판정 기준확인할 증적
결제창 진입 전 PG 전환주력 PG 회로 차단기 강제 개방신규 주문이 보조 PG 결제창으로 지연 없이 배정됨결제 시도 레코드의 라우팅 사유와 보조 PG MID 기록
승인 호출 중 타임아웃주력 PG 승인 응답을 설정 시간 이상 지연보조 PG로 자동 우회하지 않고 미확정 조회·망취소 큐로 진입동일 주문에 활성 승인 거래가 1건만 존재하는지 확인
라우팅 전환 후 과거 주문 취소기본 PG를 A에서 B로 바꾼 뒤 A 결제 건 부분 취소취소 요청이 A PG의 원 MID로 전송되어 정상 환불됨취소 시도의 대상 PG·원 거래 키 매핑 로그
웹훅 중복·역순 수신취소 완료 직후 과거 승인 웹훅을 재전송취소 확정 상태가 과거 승인 알림으로 덮어써지지 않음웹훅 수신 기록과 상태 전이 거절 로그
한 주문의 연속 실패 후 재시도A PG 한도 초과 거절 후 고객이 B PG로 재결제첫 시도는 실패 종료, 둘째 시도만 승인 확정 및 상품 1회 제공주문당 시도 이력 2건과 상품 제공 1건의 유일성 제약
멀티 PG 일일 정산 대사A·B PG의 승인·부분 취소·수수료 샘플 데이터 투입정규화 원장에서 건수·금액·수수료 차이를 구분해 탐지PG별 대사 결과표와 불일치 예외 목록

연동 전후에 점검해야 할 필수 항목은 PG 연동 체크리스트에서 항목별로 대조할 수 있습니다.

결제사 추가가 서비스 개편으로 번지지 않게 하려면

멀티 PG 도입의 성패는 계약한 결제사 개수보다 주문 시스템과 결제 대행사 사이에 얼마나 단단한 표준 게이트웨이 계층을 두었는가에서 갈립니다. 결제 시도 식별자, 승인 전후의 우회 경계, 원 거래 기반 취소 귀속, 정규화된 정산 원장이 자리를 잡으면 새로운 PG나 간편결제를 추가하는 일은 서비스 전체의 개편이 아니라 어댑터 하나를 더하는 작업이 됩니다.

우선 현재 운영 중인 결제 테이블에서 주문 ID와 결제 시도 ID가 분리되어 있는지, 그리고 승인 타임아웃이 났을 때 코드가 어떤 분기를 타는지부터 확인해 보시기 바랍니다. 이 두 가지만 점검해도 멀티 PG 전환 시 발생할 이중 결제 위험의 대부분을 미리 볼 수 있습니다.

기존 단일 PG 구조를 멀티 PG 게이트웨이로 전환하거나 결제 승인·취소·정산 대사 파이프라인을 함께 정비해야 한다면, PG(결제대행) 게이트웨이 구축 서비스와 PG 연동·결제 시스템 구축 서비스, 정산 자동화 서비스에서 프로젝트 범위를 상담할 수 있습니다.