---
title: "결제 히스토리 목록 조회"
method: GET
path: "/v2/payment/payment-histories"
tags: ["Payment"]
---

# 결제 히스토리 목록 조회

`GET /v2/payment/payment-histories`

사용자의 결제 내역을 기간별로 조회합니다. 결제 상태, 금액, 결제 수단 등의 정보를 페이징 방식으로 확인할 수 있습니다.

## Query parameters

- `page` number, nullable
- `limit` number, nullable
- `startDate` string, date-time, nullable
- `endDate` string, date-time, nullable

## Response `200`

결제 히스토리 목록 조회 요청의 처리 결과입니다. 결제 내역 목록과 페이징 정보가 포함됩니다.

- object — 결제 히스토리 목록 조회 요청의 처리 결과입니다. 결제 내역 목록과 페이징 정보가 포함됩니다.
  - `code` number, required — 요청 처리 결과 코드
  - `message` string, required — 요청 처리 결과에 대한 설명 메시지
  - `data` object, required
    - `histories` object[], required — 조회 조건에 맞는 결제 내역 목록입니다. 각 항목에는 결제 정보와 상태가 포함됩니다.
      - `id` number, nullable, required — 결제 내역 ID입니다. 이 ID로 특정 결제를 조회하거나 관리할 수 있습니다.
      - `amount` number, nullable, required — 실제 결제된 금액입니다. 단위는 원(KRW)이며, 부가세가 포함된 최종 결제 금액입니다.
      - `chargeStatus` 'CHARGE_COMPLETE' | 'CANCEL_PENDING' | 'CANCEL_FAILED' | 'CANCEL_COMPLETE', required — 결제 상태 - CHARGE_COMPLETE: 결제 완료, - CANCEL_PENDING: 취소 대기, - CANCEL_FAILED: 취소 실패, - CANCEL_COMPLETE: 취소 완료
      - `chargeMethod` 'VACCOUNT' | 'CREDIT_CARD' | 'BANK_TRANSFER', required — 결제 수단 - VACCOUNT: 가상계좌, - CREDIT_CARD: 신용카드, - BANK_TRANSFER: 계좌이체
      - `proofDocumentType` 'CASH_RECEIPT' | 'TAX_INVOICE' | 'NONE', required — 증빙서류 유형 - CASH_RECEIPT: 현금영수증, - TAX_INVOICE: 세금계산서, - NONE: 미발행
      - `proofDocumentId` string, nullable, required — 발행된 증빙서류 ID입니다.
      - `memo` string — 해당 결제에 대한 관리자의 메모나 특이사항입니다. 추가 할인이나 특별 조건 등을 기록합니다.
      - `createdAt` string, date-time, nullable, required — 결제가 최초 생성된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
      - `updatedAt` string, date-time, nullable, required — 결제 정보가 마지막으로 수정된 날짜와 시간입니다. 상태 변경이나 정보 업데이트 시 갱신됩니다.
      - `expiredAt` string, date-time, nullable, required — 결제의 유효기간 만료 날짜와 시간입니다. 가상계좌의 경우 입금 기한을 의미합니다.
    - `totalCount` number, required — 검색 조건에 맞는 전체 결제 이력의 총 개수입니다. 페이징 처리를 위해 사용됩니다.
    - `totalPages` number, required — 전체 페이지 수입니다. 현재 페이지 크기를 기준으로 계산된 총 페이지 개수입니다.
    - `currentPage` number, required — 현재 조회 중인 페이지 번호입니다. 1부터 시작하는 페이지 인덱스입니다.
    - `hasNextPage` boolean, required — 다음 페이지가 존재하는지 여부입니다. true이면 더 많은 데이터가 있음을 의미합니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/revisions/525dedc81a05/schema)