본문으로 건너뛰기

나의 결제내역

GET/my-reservations

로그인한 사용자의 예약/결제 내역을 조회합니다. 로그인 필요.

로그인 응답과 동일

이 API의 응답은 로그인 성공 시 반환되는 데이터와 완전히 동일한 구조입니다. 로그인 후 시간이 지나 결제/취소가 발생했을 때, 재로그인 없이 최신 내역을 갱신하기 위해 사용합니다.

Headers

이름필수설명
CookieO세션 쿠키 (로그인 필요)

200 OK — 조회 성공

{
"status": "success",
"errorType": null,
"errorCode": null,
"message": null,
"data": [
{
"id": 142,
"status": "DONE",
"method": "카드",
"branch": "Gwanghwamun",
"roomNo": "3",
"startDateTime": "2026/03/05 14:00",
"endDateTime": "2026/03/05 15:50",
"amount": 12000,
"paymentDoneDateTime": "2026/03/05 12:30:41",
"virtualaccountBankName": null,
"virtualaccountAccountNumber": null,
"virtualaccountDueDate": null
},
{
"id": 143,
"status": "WAITING_FOR_DEPOSIT",
"method": "가상계좌",
"branch": "Yeouido",
"roomNo": "1",
"startDateTime": "2026/03/06 10:00",
"endDateTime": "2026/03/06 11:50",
"amount": 15000,
"paymentDoneDateTime": "2026/03/05 18:00:22",
"virtualaccountBankName": "신한은행",
"virtualaccountAccountNumber": "12345678901234",
"virtualaccountDueDate": "2026/03/06 09:30"
},
{
"id": 141,
"status": "CANCELED",
"method": "간편결제",
"branch": "Ku",
"roomNo": "2",
"startDateTime": "2026/03/04 10:00",
"endDateTime": "2026/03/04 11:50",
"amount": 8000,
"paymentDoneDateTime": "2026/03/03 15:00:33",
"virtualaccountBankName": null,
"virtualaccountAccountNumber": null,
"virtualaccountDueDate": null
}
]
}
필드타입Nullable설명
idLongN결제 고유 ID
statusStringNDONE: 결제 완료(가상계좌 입금 완료 포함) / WAITING_FOR_DEPOSIT: 가상계좌 입금 전 / CANCELED: 결제취소 완료
methodStringN카드 / 간편결제 / 가상계좌 / 가상계좌(네이버 스마트플레이스) / 휴대폰 / 계좌이체
branchStringN지점 영문명 (지점 코드 참고)
roomNoStringN예약된 방 번호
startDateTimeStringN이용 시작 시간 (YYYY/MM/DD HH:mm)
endDateTimeStringN이용 종료 시간 (YYYY/MM/DD HH:mm)
amountintN결제 완료 금액 또는 가상계좌 입금 필요 금액 (원). CANCELED 상태에서도 취소 전 원래 결제 금액이 그대로 반환됩니다.
paymentDoneDateTimeStringN결제/처리 시간 (YYYY/MM/DD HH:mm:ss) — 로그인 응답의 동일 필드 참고
virtualaccountBankNameStringY가상계좌 은행명 — 가상계좌 결제가 아닌 경우 null
virtualaccountAccountNumberStringY가상계좌 번호 — 가상계좌 결제가 아닌 경우 null
virtualaccountDueDateStringY가상계좌 입금 기한 (YYYY/MM/DD HH:mm) — 가상계좌 결제가 아닌 경우 null
정렬 기준

결제/처리 시간(paymentDoneDateTime) 내림차순으로 정렬됩니다. 상태별 기준 시각:

  • 결제완료(DONE): 토스 결제 승인 시각
  • 입금대기(WAITING_FOR_DEPOSIT): 가상계좌 발급 요청 시각
  • 취소(CANCELED): 취소 처리 시각