결제 뒤 주문 상태를 확인할 수 없어요
토스페이먼츠 결제 뒤 주문 상태가 불명확할 때 고객 화면·승인 응답·상점 주문 기록·웹훅을 구분하는 가이드입니다.
빠른 답변
결제 화면을 마쳤다고 주문 완료가 확정되지는 않습니다. orderId·승인 응답·상점 주문 기록·웹훅 처리 결과를 비교하고, 승인·취소·재결제처럼 금액에 영향을 주는 행동은 상태 확인 전 실행하지 않습니다.
- 적용 범위
- 이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
- 출처 확인일
- 2026-07-27
- 최종 검토
- 2026-08-05
- 수정일
- 2026-08-05
- 정정 이력
- 2026-07-29 이후 기록 없음
- 대상
- 쇼핑몰 운영자, 웹 에이전시, 프리랜서
이 가이드가 맞는 경우
- 결제 뒤 주문 상태를 확인할 수 없음
상황별 다음 단계
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 결제 시각, 상점의 orderId 보관 여부, 고객 화면, 주문 기록, 승인 결과 중 확인된 범위를 전달합니다.
- 시크릿 키, 결제 수단 정보, paymentKey 전체, 주문자 개인정보는 전달하지 않습니다.
알아둘 점
“결제는 됐는데 주문이 안 보여요”로 검색하는 상황에서 사용합니다. 결제 화면 복귀, 승인 API 응답, 상점 주문 기록, 웹훅 처리 중 어느 단계까지 확인됐는지 분리합니다.
먼저 기록할 것
- 고객 개인정보 없이 결제 시각·상점
orderId·금액·통화의 보관 여부를 기록합니다. - 고객 화면·승인 API 응답·상점 주문 기록·웹훅 처리 결과의 확인 범위를 구분합니다.
- 승인 응답의 HTTP 상태·오류 코드·orderId 일치 여부를 기록합니다.
- 시크릿 키·결제 수단 정보·
paymentKey전체를 공유하지 않으며, 상태 확인 전 재승인·취소·재결제를 실행하지 않습니다.
| 관찰값 | 다음 문서 |
|---|---|
| 토스 승인 결과·상점 주문 상태 중 하나를 확인할 수 없음 | 토스페이먼츠 결제 뒤 주문 상태를 확인할 수 없음 |
| 결제 전 주문 폼 제출 결과가 없음 | 폼 제출 뒤 완료 결과를 확인할 수 없음 |
| 복귀 뒤 승인 API가 오류 코드·메시지를 반환함 | 토스페이먼츠 승인 실패 |
승인 orderId와 상점 주문 식별자가 다름 | 토스페이먼츠 orderId 불일치 |
수정 후 재확인
- 결제 제공자의 거래 조회와 상점 주문 기록을 같은
orderId기준으로 대조합니다. - 웹훅 재전송이나 상태 동기화 뒤 주문 상태·금액·중복 주문 여부를 확인합니다.
- 정상 상태가 확인된 뒤에만 고객 안내나 후속 금액 처리를 진행합니다.
참고 자료
코어 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