토스페이먼츠 orderId가 상점 주문과 일치하지 않음
결제 승인 결과는 있지만 상점 주문과 연결되지 않을 때 orderId를 비교합니다.
빠른 답변
- 우선 확인할 원인
- 결제창과 서버가 사용한 orderId를 비교하고, 승인 결과만으로 상점 주문을 완료 처리하지 않습니다.
- 먼저 확인할 항목
- 결제창 생성 시 orderId와 서버 저장값의 일치 여부를 확인합니다.
- 적용 범위
- 현재 증상과 본문에 적은 관찰 조건이 함께 확인된 경우
- 출처
- 토스페이먼츠
- 출처 확인일
- 2026-07-30
- 최종 검토
- 2026-07-30
- 수정일
- 2026-07-30
- 정정 이력
- 2026-07-29 이후 기록 없음
- 관련 기술
현재 증상
- 결제 뒤 주문 상태를 확인할 수 없음
먼저 확인할 항목
결제창 생성 시 orderId와 서버 저장값의 일치 여부를 확인합니다.
승인 응답의 orderId·paymentKey와 주문 조회 결과를 구분합니다.
불일치 시각과 단계를 기록하고 고객·비밀값은 기록하지 않습니다.
피해야 할 조치
주의
- 오류 원문·시각·환경만 기록하고 비밀번호, 토큰, 세션 쿠키, 결제 정보, 개인정보는 기록하지 않습니다.
- 운영 설정은 현재 값을 보관한 뒤 한 번에 한 항목만 수정합니다.
환경별 원인과 조치
적용 범위
이 문서는 관찰값이 함께 확인될 때 적용합니다. 오류 문구 하나만으로 원인을 확정하지 않습니다.
확인 절차
- 결제창 생성 시 orderId와 서버 저장값의 일치 여부를 확인합니다.
- 승인 응답의 orderId·paymentKey와 주문 조회 결과를 구분합니다.
- 불일치 시각과 단계를 기록하고 고객·비밀값은 기록하지 않습니다.
다음 조치
- orderId 생성·저장·승인 요청의 변환을 비교합니다.
- 승인 결과와 상점 기록을 대조하기 전 주문을 완료 처리하지 않습니다.
- 테스트 주문에서 같은 orderId가 연결되는지 확인합니다.
주의
- 운영 데이터와 인증 정보를 문서·로그·문의 자료에 포함하지 않습니다.
- 조건이 일치하지 않으면 이 문서의 조치를 적용하지 말고 원문과 환경을 보존합니다.
공식 근거
참고 자료
코어 API - 토스페이먼츠 개발자센터 (새 창에서 열림)
토스페이먼츠 · 공식 자료 · 확인 범위: orderId는 상점 주문 식별자로 사용됩니다., 승인된 결제는 paymentKey 또는 orderId로 조회할 수 있습니다. · 확인일: 2026-07-30