---
title: "결제 히스토리 상세 조회"
method: GET
path: "/v2/payment/payment-histories/{historyId}"
tags: ["Payment"]
---

# 결제 히스토리 상세 조회

`GET /v2/payment/payment-histories/{historyId}`

특정 결제 내역의 상세 정보를 조회합니다. 결제 상태, 취소 내역, 증빙서류 정보 등을 확인할 수 있습니다.

## Path parameters

- `historyId` number, nullable, required

## Response `200`

결제 히스토리 상세 조회 요청의 처리 결과입니다. 요청한 결제 내역의 모든 상세 정보가 포함됩니다.

- object — 결제 히스토리 상세 조회 요청의 처리 결과입니다. 요청한 결제 내역의 모든 상세 정보가 포함됩니다.
  - `code` number, required — 요청 처리 결과 코드
  - `message` string, required — 요청 처리 결과에 대한 설명 메시지
  - `data` object, required
    - `history` 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 — 결제의 유효기간 만료 날짜와 시간입니다. 가상계좌의 경우 입금 기한을 의미합니다.

---

[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)