토스페이먼츠 결제 뒤 주문 상태를 확인할 수 없음

적용 범위

이 문서는 토스페이먼츠 결제 화면을 마친 뒤 상점 주문 완료 여부를 확인하지 못하는 상황의 확인 순서를 다룹니다. 카드 승인 여부, 상점 주문 생성, 재고 처리, 환불·취소 가능 여부는 서로 다른 상태이며 이 문서에서 하나로 단정하지 않습니다.

토스페이먼츠는 결제 승인 API와 paymentKey, orderId 조회 기능을 제공합니다. orderId는 상점이 생성하고 보관하는 주문 식별자입니다. 결제 화면의 복귀 URL은 결제 요청 결과를 받는 단계일 수 있으므로, 복귀 화면만 보고 최종 주문 완료로 판단하지 않습니다.

변경 없이 확인할 항목

1. 고객 정보 없이 결제 시도 시각, 상점의 orderId 보관 여부, 결제 화면 복귀 여부를 기록합니다.
2. 개발 또는 결제 담당자는 해당 식별자로 확인 가능한 승인 결과와 상점 주문 기록을 각각 확인합니다.
3. 고객 화면, 결제 승인 결과, 상점 주문 기록 중 어느 단계가 일치하지 않는지 분리합니다.
4. API 오류가 있다면 HTTP 상태 코드와 오류 식별자만 기록하고, 시크릿 키와 전체 요청 본문은 기록하지 않습니다.

결제에 대한 주의와 다음 문서

결제 승인 재시도, 취소, 금액 수정, 고객 재결제 요청은 금전과 주문 상태를 바꿀 수 있습니다. 확인 자료만으로 이러한 작업을 자동 실행하거나 안내하지 않습니다. 중복 결제 또는 금액 불일치가 의심되면 즉시 결제·주문 담당자에게 정해진 운영 절차로 전달하세요.

토스페이먼츠의 식별자와 조회 범위는 토스페이먼츠 문서에서 다시 확인할 수 있습니다. 문의나 예약 신청이 결제 단계에 도달하기 전 결과를 확인하지 못한 경우에는 문의·예약 신청 결과를 확인할 수 없어요를 먼저 사용하세요.