주문번호와 결제 식별자

어떤 값을 저장해야 하나요?

자체 주문과 PG 결제를 연결할 값을 저장해야 조회·취소·고객 문의를 정확히 처리할 수 있어요. PG 응답 필드에서 누가 값을 생성하는지, 주문 전체인지 결제 시도인지 개별 취소인지 확인하세요.

결제 흐름 예시

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

승인번호와의 차이

고객 영수증의 승인번호와 PG API에서 조회·취소에 요구하는 식별자는 다를 수 있어요. 화면에서 보이는 번호를 임의로 API에 넣지 말고 문서가 지정한 값을 사용하세요. 필드명이 ‘키’라고 해서 모두 시크릿 키인 것도 아니에요.

설계에서 확인할 점

주문 재시도와 결제 재시도를 어떻게 구분할지 먼저 정하세요. 서로 다른 PG를 사용한다면 사업자 구분도 함께 저장하는 것이 좋아요. 고객이 전달한 번호만 믿기보다 로그인 사용자와 주문의 소유 관계를 서버에서 확인해야 해요.