결제는 완료됐는데 주문이 생성되지 않아요

결제 승인·상점 주문 기록·완료 화면이 서로 다를 때 결제 재시도 없이 단계별 상태를 확인하는 시작 Guide입니다. 오류 원문과 발생 환경이 일치하지 않으면 원인을 단정하지 않습니다.

먼저 기록할 것

1. 화면·브라우저 개발자 도구·서버 로그 중 어디에서 오류를 확인했는지 기록합니다.
2. 오류 문구·상태 코드·요청 주소·발생 시각을 가능한 한 원문 그대로 보존합니다.
3. 최근 배포·설정·도메인·플러그인·호스팅 변경 여부를 기록합니다.
4. 문의 자료에서는 비밀번호·토큰·쿠키·고객 정보·결제 정보를 제거합니다.

상황별 다음 단계

1. 토스페이먼츠 결제 뒤 주문 상태를 확인할 수 없으면 토스페이먼츠 결제 뒤 주문 상태를 확인할 수 없음을 확인합니다.
2. 토스페이먼츠 결제 승인 요청이 실패하면 토스페이먼츠 결제 승인 요청이 실패함을 확인합니다.
3. 토스페이먼츠 orderId가 상점 주문과 일치하지 않으면 토스페이먼츠 orderId가 상점 주문과 일치하지 않음을 확인합니다.

확인 순서

1. 문제를 재현하는 URL 또는 기능을 한 가지로 고정합니다.
2. 위 Problem의 관찰값과 현재 화면·로그가 일치하는지 비교합니다.
3. 한 번에 하나의 설정이나 코드만 확인하고, 변경 전 값을 보관합니다.
4. 수정 후 같은 브라우저·주소·기능에서 다시 확인합니다.

결제 승인과 주문 생성을 분리해 확인

관찰값	판정 기준	다음 확인
PG 화면은 승인이고 상점 주문이 없음	PG 승인 결과가 상점 서버의 주문 생성 트랜잭션으로 전달되지 않았을 수 있습니다.	승인 요청 응답, 서버 로그, 주문 생성 로그를 같은 orderId로 비교합니다.
승인 요청 자체가 실패함	인증 키·금액·주문 ID·결제 상태 중 하나가 PG 조건과 맞지 않는 상태입니다.	실패 코드와 승인 요청의 필드를 공식 문서와 대조합니다.
주문은 있으나 완료 화면만 실패함	주문 데이터와 브라우저 이동·콜백 처리가 분리된 상태입니다.	서버의 주문 상태와 클라이언트 완료 화면 요청을 따로 확인합니다.

결제가 완료된 경우 같은 결제를 반복 시도하거나 임의로 주문 상태를 수정하지 않습니다. PG의 승인 상태, paymentKey, orderId, 상점 주문 ID, 웹훅 수신 여부를 비밀 값 없이 기록합니다.

수정 후 재확인

1. 테스트 결제 또는 PG가 제공한 테스트 환경에서 승인 요청과 주문 생성을 한 번만 실행합니다.
2. PG 승인 응답, 상점 DB의 주문 상태, 완료 화면의 표시가 같은 주문 ID를 가리키는지 확인합니다.
3. 웹훅을 사용하는 경우 수신 시각·응답 코드·중복 처리 결과를 확인합니다.
4. 운영 결제는 금액·환불·주문 상태를 담당자가 확인한 뒤에만 해결로 기록합니다.

관련 점검표: 국내 PG 결제 승인·주문 상태 확인표

오진하지 않기

이 Guide의 제목이나 플랫폼 이름만으로 원인을 확정하지 않습니다. Problem 문서의 조건과 실제 관찰값이 다르면 설정을 변경하지 말고 오류 원문과 환경을 다시 기록합니다.