개발팀
PG 두 곳의 규격 차이를 신경 쓰지 않아도 됩니다
BEFORE승인 파라미터, 웹훅, 재시도 로직을 PG마다 따로 구현
AFTER단일 SDK와 내장 멱등성으로 연동 공수 75% 절감 목표
2.5초 이내
PG 장애 시 사람 개입 없는 자동 우회
6ms
플랫폼 내부 처리 오버헤드 (P99)
0분
매일 엑셀로 하던 정산 대사 작업
3일
듀얼 PG 연동을 끝내는 데 걸리는 목표 기간
* 자동 우회 시간과 P99 처리 시간은 MVP 테스트 환경에서 측정한 값입니다. 연동 기간은 목표치입니다.
하나의 결제 인프라
결제 승인부터 정산 대사까지,
AI가 운영합니다
PG를 붙이는 일보다 운영하는 일이 더 어렵습니다. 장애 대응, 에러 해석, 정산 검증을 WavPay가 맡습니다.
듀얼 PG · 자동 페일오버
토스가 흔들리면,
나이스로 결제를 이어갑니다
승인 요청이 3초 안에 응답이 없거나 5xx 장애가 나면 WavPay가 결과를 확인하고 정리한 뒤 2순위 PG로 넘깁니다. 빌링키 결제는 고객이 아무것도 다시 입력하지 않아도 됩니다.
- 타임아웃이면 망취소를 먼저 확인해 이중 결제를 막습니다
- 연속 장애 시 서킷 브레이커가 해당 PG를 30초간 차단합니다
- 우회 중에도 5% 트래픽으로 복구를 감지해 자동 복귀합니다
빌링 결제 · pay_7fQ2…PAID
토스승인 요청 →
FAILED_INTERNAL_SYSTEM_PROCESSING412msWavPay인프라 장애로 분류 · 2순위 PG 빌링키로 재시도+2ms
나이스승인 완료 · 신한카드386ms
고객 재입력 없이 결제 성공총 0.8초
스마트 에러 정규화
9999, FAILED…
모호한 에러도 해석합니다
PG마다 다른 에러 코드를 하나의 기준으로 분류합니다. 망 오류는 다른 PG로 바로 재시도하고, 한도초과처럼 고객 카드 문제는 불필요한 재시도 없이 바로 안내합니다.
- 토스 에러 코드 카탈로그 + 한국어 메시지 규칙
- 처음 보는 코드는 AI가 분류하고 다음 거래부터 즉시 반영
- 고객에게 보여줄 안내 문구까지 함께 제공
PG 응답WavPay 분류
NICEPAY 9999 시스템 오류
인프라 자동 재시도
TOSS PROVIDER_ERROR
인프라 자동 재시도
TOSS REJECT_CARD_PAYMENT
고객 귀책 한도초과 안내
NICEPAY F113 카드 한도 초과
고객 귀책 재시도 차단
TOSS INVALID_API_KEY
설정 오류 운영 알림
AI 3-Way 정산 대사
0.01%p 수수료 차이도
다음 날 아침에 알려드립니다
매일 새벽 PG 정산 원장을 수집해 자사 주문, WavPay 승인 내역과 건별로 맞춰봅니다. 차액이 나오면 원인 분석 리포트를 Slack으로 보냅니다.
- 계약 수수료율 불일치, 부가세 오차 탐지
- 환불 수수료 이중 차감, 정산 누락 건 추적
- 취소 건 정산일 차이처럼 흔한 원인은 리포트에서 바로 설명
10월 10일 대사 결과이슈 2건
| 주문 | PG | 계약 수수료 | 실제 수수료 | 차액 |
|---|---|---|---|---|
| ORD-1021 | 토스 | 1,600원 | 1,600원 | 일치 |
| ORD-1022 | 토스 | 3,200원 | 3,300원 | +100원 |
| ORD-1023 | 나이스 | 900원 | 900원 | 일치 |
| ORD-1024 | 나이스 | -150원 | +150원 | 환불 수수료 재부과 |
결제금액×계약 요율 3.20%=기대 수수료vsPG 원장
AI 리포트 · 토스 카드 결제 수수료가 계약보다 0.10%p 높게 적용됐습니다. 계약 요율 변경이 PG 쪽에 반영되지 않았을 가능성이 높습니다.
Ops Copilot
대시보드를 뒤지는 대신
그냥 물어보세요
개발자와 재무 담당자가 평소 말로 질문하면, Copilot이 승인 시도, 라우팅 이력, 정산 결과를 직접 조회해 근거 수치와 함께 답합니다.
- PG·카드사·에러코드·시간대별로 원인을 쪼개 분석
- 읽기 전용 조회만 수행, 결제 데이터를 바꾸지 않음
- Slack에 그대로 붙여 넣을 수 있는 요약
Ops Copilot재무·개발팀 공용
어젯밤 나이스페이 신한카드 승인 실패 왜 튀었어?
get_attempt_breakdownlist_failed_attemptsget_routing_events
23:10~23:40 신한카드 망 지연이 원인으로 보입니다.
- 해당 구간 실패율 18.4% (직전 1시간 0.9%)
- 실패의 92%가 타임아웃, 다른 카드사는 정상
- 23:14 이후 신한 거래 412건은 토스로 선제 우회돼 승인
개발자 가이드
PG 두 곳, 연동은 한 번
승인 파라미터, 웹훅 규격, 재시도 로직을 PG별로 따로 짤 필요가 없습니다.
멱등성 기본 내장
모든 요청에 Idempotency-Key가 자동으로 붙습니다. 더블 탭이나 네트워크 재전송에도 이중 결제가 생기지 않습니다.
표준 상태와 웹훅
INIT → AUTHORIZED → PAID 하나의 상태 모델. 웹훅은 HMAC 서명과 함께 오고, 실패하면 1분부터 6시간까지 다섯 번 재전송합니다.
카드 정보는 거치지 않습니다
카드번호와 CVC는 PG 결제창에서 토큰화됩니다. WavPay 서버에는 저장되지 않습니다.
import { WavPay } from '@wavpay/sdk/server'; const wavpay = new WavPay({ secretKey: process.env.WAVPAY_SECRET_KEY }); // 1. 결제 생성: WavPay가 지금 가장 안정적인 PG를 고릅니다 const { checkout } = await wavpay.payments.create({ orderId: 'ORD-1022', orderName: '프리미엄 구독', amount: 100000, method: 'CARD', successUrl, failUrl, }); // 2. 결제창 인증 후 successUrl에서 승인 const { payment, nextAction } = await wavpay.payments.confirm( paymentId, { providerTxId, amount: 100000 }, ); // PG 장애로 실패하면 nextAction에 2순위 PG 결제창 정보가 담겨 옵니다
도입 효과
개발, 운영, 재무팀의
반복 업무를 줄입니다
인프라·운영팀
새벽 PG 장애에 온콜로 깨지 않아도 됩니다
BEFORE심야 타임아웃, 카드사 점검 때마다 결제 이탈과 수동 대응
AFTERAI 사전 감지와 서킷 브레이커로 자동 우회, 상황은 Slack으로 공유
재무·정산팀
엑셀 세 개를 나란히 띄우는 아침이 사라집니다
BEFORE양사 어드민에서 정산 파일을 받아 자사 DB와 건별 대조
AFTER3-Way 자동 대사와 원인 리포트로 차액만 확인
FAQ
자주 묻는 질문
기존 토스페이먼츠·나이스페이 계약을 그대로 쓸 수 있나요?
네. WavPay는 가맹점이 직접 맺은 PG 계약과 키를 그대로 사용합니다. 정산 대금도 PG에서 가맹점으로 바로 지급되고, WavPay는 그 위에서 라우팅과 대사를 담당합니다.
일반 카드 결제도 고객 재입력 없이 우회되나요?
빌링키(자동결제)는 고객 개입 없이 바로 우회됩니다. 일반 결제는 카드 인증 토큰이 PG끼리 호환되지 않아, 승인 단계에서 장애가 나면 2순위 PG 결제창에서 한 번 더 인증받습니다. 결제창을 열기 전에 장애 조짐이 보이면 처음부터 안정적인 PG로 보내 이런 상황 자체를 줄입니다.
카드번호 같은 민감 정보를 WavPay가 저장하나요?
아니요. 카드번호와 CVC는 PG 결제창에서 토큰화되며 WavPay 서버를 거치지 않습니다. 결제 승인·취소 이력은 수정과 삭제가 불가능한 감사 로그로 보관합니다.
AI가 결제 승인 여부를 판단하나요?
아니요. 승인은 언제나 PG가 합니다. AI는 어느 PG로 보낼지, 실패한 결제를 다시 시도할지, 정산 차액의 원인이 무엇인지를 판단하는 데 쓰입니다. 승인 경로는 규칙과 학습된 분류 결과로 즉시 처리되어 AI 호출 때문에 느려지지 않습니다.
정산 대사는 어떤 데이터로 하나요?
가맹점 주문 데이터, WavPay 승인 내역, PG 확정 정산 원장 세 가지를 매일 새벽 대조합니다. 토스페이먼츠는 정산 조회 API로, 나이스페이는 정산 파일 업로드로 수집합니다.