나의 결제내역
GET/my-reservations
로그인한 사용자의 예약/결제 내역을 조회합니다. 로그인 필요.
로그인 응답과 동일
이 API의 응답은 로그인 성공 시 반환되는 데이터와 완전히 동일한 구조입니다. 로그인 후 시간이 지나 결제/취소가 발생했을 때, 재로그인 없이 최신 내역을 갱신하기 위해 사용합니다.
Request
Response
- 200
- 401
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 | 설명 |
|---|---|---|---|
id | Long | N | 결제 고유 ID |
status | String | N | DONE: 결제 완료(가상계좌 입금 완료 포함) / WAITING_FOR_DEPOSIT: 가상계좌 입금 전 / CANCELED: 결제취소 완료 |
method | String | N | 카드 / 간편결제 / 가상계좌 / 가상계좌(네이버 스마트플레이스) / 휴대폰 / 계좌이체 |
branch | String | N | 지점 영문명 (지점 코드 참고) |
roomNo | String | N | 예약된 방 번호 |
startDateTime | String | N | 이용 시작 시간 (YYYY/MM/DD HH:mm) |
endDateTime | String | N | 이용 종료 시간 (YYYY/MM/DD HH:mm) |
amount | int | N | 결제 완료 금액 또는 가상계좌 입금 필요 금액 (원). CANCELED 상태에서도 취소 전 원래 결제 금액이 그대로 반환됩니다. |
paymentDoneDateTime | String | N | 결제/처리 시간 (YYYY/MM/DD HH:mm:ss) — 로그인 응답의 동일 필드 참고 |
virtualaccountBankName | String | Y | 가상계좌 은행명 — 가상계좌 결제가 아닌 경우 null |
virtualaccountAccountNumber | String | Y | 가상계좌 번호 — 가상계좌 결제가 아닌 경우 null |
virtualaccountDueDate | String | Y | 가상계좌 입금 기한 (YYYY/MM/DD HH:mm) — 가상계좌 결제가 아닌 경우 null |
정렬 기준
결제/처리 시간(paymentDoneDateTime) 내림차순으로 정렬됩니다. 상태별 기준 시각:
- 결제완료(
DONE): 토스 결제 승인 시각 - 입금대기(
WAITING_FOR_DEPOSIT): 가상계좌 발급 요청 시각 - 취소(
CANCELED): 취소 처리 시각
401 Unauthorized — 로그인 필요
{
"status": "error",
"errorType": "LoginFailException",
"errorCode": null,
"message": "인증되지 않은 사용자입니다.",
"data": null
}