DEV WIKI
백엔드 · 문제 해결 가이드

결제 뒤 주문 상태를 확인할 수 없어요

토스페이먼츠 결제 뒤 주문 상태가 불명확할 때 고객 화면·승인 응답·상점 주문 기록·웹훅을 구분하는 가이드입니다.

빠른 답변

결제 화면을 마쳤다고 주문 완료가 확정되지는 않습니다. orderId·승인 응답·상점 주문 기록·웹훅 처리 결과를 비교하고, 승인·취소·재결제처럼 금액에 영향을 주는 행동은 상태 확인 전 실행하지 않습니다.

적용 범위
이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
출처 확인일
2026-07-27
최종 검토
2026-08-05
수정일
2026-08-05
대상
쇼핑몰 운영자, 웹 에이전시, 프리랜서
오류·수정 제보 (새 창에서 열림)

이 가이드가 맞는 경우

  • 결제 뒤 주문 상태를 확인할 수 없음

상황별 다음 단계

호스팅사·개발자에게 전달할 내용

변경 전 기록

  • 결제 시각, 상점의 orderId 보관 여부, 고객 화면, 주문 기록, 승인 결과 중 확인된 범위를 전달합니다.
  • 시크릿 키, 결제 수단 정보, paymentKey 전체, 주문자 개인정보는 전달하지 않습니다.

알아둘 점

“결제는 됐는데 주문이 안 보여요”로 검색하는 상황에서 사용합니다. 결제 화면 복귀, 승인 API 응답, 상점 주문 기록, 웹훅 처리 중 어느 단계까지 확인됐는지 분리합니다.

먼저 기록할 것

  1. 고객 개인정보 없이 결제 시각·상점 orderId·금액·통화의 보관 여부를 기록합니다.
  2. 고객 화면·승인 API 응답·상점 주문 기록·웹훅 처리 결과의 확인 범위를 구분합니다.
  3. 승인 응답의 HTTP 상태·오류 코드·orderId 일치 여부를 기록합니다.
  4. 시크릿 키·결제 수단 정보·paymentKey 전체를 공유하지 않으며, 상태 확인 전 재승인·취소·재결제를 실행하지 않습니다.
관찰값다음 문서
토스 승인 결과·상점 주문 상태 중 하나를 확인할 수 없음토스페이먼츠 결제 뒤 주문 상태를 확인할 수 없음
결제 전 주문 폼 제출 결과가 없음폼 제출 뒤 완료 결과를 확인할 수 없음
복귀 뒤 승인 API가 오류 코드·메시지를 반환함토스페이먼츠 승인 실패
승인 orderId와 상점 주문 식별자가 다름토스페이먼츠 orderId 불일치

수정 후 재확인

  1. 결제 제공자의 거래 조회와 상점 주문 기록을 같은 orderId 기준으로 대조합니다.
  2. 웹훅 재전송이나 상태 동기화 뒤 주문 상태·금액·중복 주문 여부를 확인합니다.
  3. 정상 상태가 확인된 뒤에만 고객 안내나 후속 금액 처리를 진행합니다.

참고 자료

코어 API - 토스페이먼츠 개발자센터 (새 창에서 열림)

토스페이먼츠 · 공식 자료 · 확인 범위: guide-branch-toss-payments-order-status · 확인일: 2026-07-27

Sending form data - MDN Web Docs (새 창에서 열림)

MDN Web Docs (Mozilla) · 공식 자료 · 확인 범위: HTML form의 action과 method는 제출 요청의 대상과 방법을 정합니다. · 확인일: 2026-07-27