토스페이먼츠 · 나이스페이 듀얼 PG

PG 연동부터
결제 승인까지 한 번에

PG 두 곳을 하나의 API로 연동하고, 한쪽에 장애가 나면 다른 PG로 자동 우회해요. 결제내역 · 취소 · 정산 대사 · 웹훅까지 WAVPAY 콘솔 하나로.

내 서비스
WAVPAY
PG
가맹점 서버
ORD-1042프리미엄 플랜 1개월200
ORD-1043원두 정기배송200
ORD-1044스니커즈 외 1건200
0곳
하나의 API로 붙는 PG
0초
응답 지연 시 다른 PG로 자동 우회
0회
웹훅 자동 재전송
0-Way
정산 자동 대사
결제 연동 API

한 번 연동하면
PG 두 곳이 같이 붙어요

토스페이먼츠와 나이스페이의 서로 다른 승인 · 웹훅 규격을 하나의 JSON API로 맞췄어요.

  • Idempotency-Key 로 중복 탭 · 재전송에도 한 번만 승인
  • 카드 · 간편결제(네이버페이 · 카카오페이 · 토스페이) · 가상계좌 · 자동결제
  • 카드번호는 결제창에서 토큰화 — 내 서버에 남기지 않아요
연동 문서 보기
server.ts
// PG가 몇 곳이든 요청은 하나. WAVPAY가 지금 가장 안정적인 PG를 고른다
POST /v1/payments
Authorization: Basic base64(clientKey:secretKey)
Idempotency-Key: ord_1042_pay // 중복 탭 · 재전송에도 한 번만 승인
{ "orderId": "ORD-1042", "amount": 29000,
"method": "card", "orderName": "프리미엄 플랜 1개월",
"successUrl": "https://shop.example.com/pay/success" }
200 PAIDprovider: TOSS · paymentKey: pay_k3j9…
PG 자동 우회

PG에 장애가 나도
결제는 멈추지 않아요

1순위 PG가 3초 넘게 응답하지 않거나 장애를 돌려주면, 같은 결제를 다른 PG로 자동 승인해요.

  • PG 우선순위와 우회 조건을 콘솔에서 설정
  • 타임아웃 건은 자동 망취소로 이중 승인 방지
  • 우회된 결제는 원래 PG와 사유까지 기록
데모 콘솔 보기
PG 상태 · 최근 5분 응답 시간자동 우회 켜짐
토스페이먼츠1순위지연 감지 · 3.2초
나이스페이2순위정상 · 0.4초
ORD-1044토스페이먼츠 응답 3초 초과 → 망취소
ORD-1044나이스페이로 자동 우회 승인 · 129,000원
가맹점 콘솔

결제 · 취소 · 환불을
한 화면에서

PG가 달라도 결제내역은 한 목록으로. 기간 · 결제수단 · PG로 바로 찾고 엑셀로 내려받아요.

  • 전체 취소 · 부분 취소를 콘솔에서 바로
  • 정기결제(빌링키) 회차 관리와 가상계좌 입금 확인
  • 대표 · 관리자 · 조회 전용 권한과 변경 이력
데모 콘솔 보기
결제 대시보드오늘 · 이번주 · 이번달
오늘 순매출
₩12,846,500
▲ 8.2%
승인 건수
1,312건
▲ 4.1%
승인율
98.7%
▲ 0.6%
ORD-1042토스페이먼츠 · 카드₩29,000결제완료
ORD-1038나이스페이 · 카카오페이₩15,000부분취소
정산 대사

정산 대사,
이제 엑셀 없이

PG의 D+1 정산 원장과 내 주문 · 승인 내역을 매일 자동으로 대조해요.

  • 주문 DB ↔ 승인 내역 ↔ PG 정산 원장 3-Way 대조
  • 수수료 차액 · 정산 누락 건을 원인과 함께 알림
  • PG별 입금 예정일을 정산 달력으로
정산 화면 보기
11월 정산 · 대사PG 정산 원장 D+1 자동 수집
일월화수목금토
1
2
33,130만
42,500만
53,650만
62,980만
7
8
97,160만
103,610만
113,160만
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
일치1,284건수수료 차액2건 · 4,180원정산 누락0건
웹훅 · 보안

결제 결과를
내 서버로 바로

승인 · 취소 · 입금을 웹훅으로 알리고, 실패하면 알아서 다시 보내요.

  • HMAC 서명으로 위조 요청 차단
  • 최대 5회 자동 재전송과 콘솔에서 1클릭 재전송
  • 연동키별 IP 허용목록 · 만료 · 폐기
웹훅 가이드
웹훅 전송 로그x-wavpay-signature: t=…,v1=…
payment.paid200
vbank.deposited200
payment.canceled503 → 재시도
payment.canceled200 (2회차)
HMAC-SHA256 서명IP 허용목록카드번호 미저장

주요 결제수단과 국내 카드사 모두

어느 PG로 승인돼도 결과는 같은 형태로 받아요.

신용카드체크카드네이버페이카카오페이토스페이가상계좌자동결제 · 빌링부분 취소현금영수증
토스페이먼츠나이스페이신한카드KB국민카드삼성카드현대카드BC카드롯데카드하나카드NH농협카드

결제는 WAVPAY에 맡기고
서비스에 집중하세요