주문번호와 결제 식별자

Order ID / Payment ID / Transaction ID

함께 찾는 표현: 주문번호, 결제키, 거래번호, orderId, paymentKey, TID

한눈에 보는 정의

주문번호는 상점의 주문을 구분해요. 결제 식별자는 PG의 결제 건을 구분해요. 승인·취소 같은 개별 거래에는 다른 식별자가 붙을 수 있어요.

작성: 이성연 (대표) · 검토일: 2026-10-06

이 문서에서

가맹점의 주문과 PG의 결제를 연결하는 값을 저장해야 조회·취소·고객 문의를 정확히 처리할 수 있어요. 각 값을 누가 생성하는지, 주문·결제 건·개별 거래 중 무엇을 구분하는지 연동 문서에서 확인해요.

PG마다 이름은 다르지만 보통 아래처럼 나눠요.

구분	용도
주문번호	가맹점이 생성해 주문을 구분해요.
결제 식별자	PG가 발급하는 결제 건의 고유 값이에요. 결제 상태가 바뀌어도 유지돼요.
거래 식별자	한 결제에서 발생한 승인·취소 거래를 하나씩 구분해요.

상품 두 개를 한 번에 결제한 뒤 각각 반품하면 결제 건은 하나여도 취소 거래가 두 번 발생할 수 있어요. 원래 결제의 식별자만 저장하면 어느 취소 작업이 성공했는지 구분하기 어려워요. 주문·결제·각 취소 거래를 연결해 기록해 둬요.

영수증에 표시된 카드 승인번호는 PG API가 조회·취소에 쓰는 식별자와 다를 수 있어요. API를 호출할 때는 연동 문서가 지정한 값을 넣어요. 필드명에 ‘키’가 들어가도 모두 시크릿 키를 뜻하지는 않아요.

새 주문을 만드는 경우와 같은 결제를 다시 시도하는 경우를 어떻게 구분할지 정해요. 여러 PG를 사용한다면 각 결제를 처리한 PG도 함께 저장해요. 고객이 전달한 번호로 조회·취소할 때는 해당 고객의 주문이 맞는지 서버에서 확인해요.

현재 PG 조건과 새 견적을 비교해 보세요

서포트비에서 한 번의 요청으로 여러 PG사의 견적을 받아 수수료와 정산 조건을 비교할 수 있어요.