DEV WIKI
백엔드 · 플랫폼

토스페이먼츠

토스페이먼츠 결제 흐름에서 결제 화면 복귀만으로 주문 완료를 확정하지 말고, 상점이 보관한 orderId 또는 paymentKey를 이용해 승인 결과와 주문 기록을 구분해 확인해야 합니다.

적용 범위
토스페이먼츠의 공개 기능과 본문에 적은 설정·운영 조건
출처 확인일
2026-07-27
최종 검토
2026-07-27
수정일
2026-07-27
오류·수정 제보 (새 창에서 열림)

플랫폼 정의

토스페이먼츠의 결제 승인 API는 결제를 검증하고 승인하며, 승인된 결제는 paymentKey 또는 orderId로 조회할 수 있습니다. 결제 취소, 승인 재시도, 주문 상태 변경은 결제 정보와 고객 영향이 있으므로 이 문서에서 자동으로 실행하지 않습니다.

결제 화면을 마쳤는데 주문 상태를 확인할 수 없다면 토스페이먼츠 결제 뒤 주문 상태를 확인할 수 없음에서 확인에 필요한 식별자와 안전한 전달 자료를 먼저 정리하세요.

자주 발생하는 오류·증상

관련 체크리스트

국내 PG 결제 분석 태그 운영 확인표

국내 PG 결제에서 분석 태그 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 데이터베이스 연결 운영 확인표

국내 PG 결제에서 데이터베이스 연결 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 DNS 레코드 운영 확인표

국내 PG 결제에서 DNS 레코드 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 파일 업로드 운영 확인표

국내 PG 결제에서 파일 업로드 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 로그인·세션 운영 확인표

국내 PG 결제에서 로그인·세션 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 메일 발송·수신 운영 확인표

국내 PG 결제에서 메일 발송·수신 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 파일 권한 운영 확인표

국내 PG 결제에서 파일 권한 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 리디렉션 운영 확인표

국내 PG 결제에서 리디렉션 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 런타임 버전 운영 확인표

국내 PG 결제에서 런타임 버전 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 검색 색인 운영 확인표

국내 PG 결제에서 검색 색인 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

국내 PG 결제 SSL·도메인 운영 확인표

국내 PG 결제에서 SSL·도메인 문제가 발생했을 때 변경 전에 관찰값과 설정 위치를 확인하는 국내 운영 점검표입니다.

참고 자료

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

토스페이먼츠 · 공식 자료 · 확인 범위: 결제 승인 결과와 paymentKey 또는 orderId 조회 기능을 제공합니다., orderId는 주문을 식별하는 값으로 상점이 보관해야 합니다. · 확인일: 2026-07-27

최근 검토된 문서