---
title: "결제 상세내역 조회 API"
method: GET
path: "/payments/{imp_uid}/balance"
tags: ["payments"]
---

# 결제 상세내역 조회 API

`GET /payments/{imp_uid}/balance`

포트원 거래고유번호로 결제수단별 금액 상세정보를 확인합니다.(현재, PAYCO결제수단에 한해 제공되고 있습니다. 타 PG사의 경우 파라메터 검증 등 검토/협의 단계에 있습니다.

## Path parameters

- `imp_uid` string, required

## Response `200`

정상 조회

- PaymentBalanceResponse — 결제 상세정보. 바로 아래 Payment structure를 확인하세요
  - `code` integer — 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string — code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` PaymentBalanceResponseAnnotation
    - `amount` number, required — 최초 총 결제금액
    - `cash_receipt` PaymentBalanceAnnotation, required
      - `tax_free` number, required — 면세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
      - `supply` number, required — 과세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
      - `vat` number, required — 부가세액 (환불시 마이너스 차감된 최종 금액 반환)
      - `service` number, required — 봉사료 (환불시 마이너스 차감된 최종 금액 반환)
    - `primary` PaymentBalanceAnnotation, required
      - `tax_free` number, required — 면세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
      - `supply` number, required — 과세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
      - `vat` number, required — 부가세액 (환불시 마이너스 차감된 최종 금액 반환)
      - `service` number, required — 봉사료 (환불시 마이너스 차감된 최종 금액 반환)
    - `secondary` PaymentBalanceAnnotation, required
      - `tax_free` number, required — 면세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
      - `supply` number, required — 과세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
      - `vat` number, required — 부가세액 (환불시 마이너스 차감된 최종 금액 반환)
      - `service` number, required — 봉사료 (환불시 마이너스 차감된 최종 금액 반환)
    - `discount` PaymentBalanceAnnotation, required
      - `tax_free` number, required — 면세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
      - `supply` number, required — 과세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
      - `vat` number, required — 부가세액 (환불시 마이너스 차감된 최종 금액 반환)
      - `service` number, required — 봉사료 (환불시 마이너스 차감된 최종 금액 반환)
    - `histories` PaymentBalanceHistoriesAnnotation[] — PaymentBalance 이력
      - `cash_receipt` PaymentBalanceAnnotation, required
        - `tax_free` number, required — 면세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
        - `supply` number, required — 과세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
        - `vat` number, required — 부가세액 (환불시 마이너스 차감된 최종 금액 반환)
        - `service` number, required — 봉사료 (환불시 마이너스 차감된 최종 금액 반환)
      - `primary` PaymentBalanceAnnotation, required
        - `tax_free` number, required — 면세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
        - `supply` number, required — 과세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
        - `vat` number, required — 부가세액 (환불시 마이너스 차감된 최종 금액 반환)
        - `service` number, required — 봉사료 (환불시 마이너스 차감된 최종 금액 반환)
      - `secondary` PaymentBalanceAnnotation, required
        - `tax_free` number, required — 면세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
        - `supply` number, required — 과세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
        - `vat` number, required — 부가세액 (환불시 마이너스 차감된 최종 금액 반환)
        - `service` number, required — 봉사료 (환불시 마이너스 차감된 최종 금액 반환)
      - `discount` PaymentBalanceAnnotation, required
        - `tax_free` number, required — 면세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
        - `supply` number, required — 과세 공급가액 (환불시 마이너스 차감된 최종 금액 반환)
        - `vat` number, required — 부가세액 (환불시 마이너스 차감된 최종 금액 반환)
        - `service` number, required — 봉사료 (환불시 마이너스 차감된 최종 금액 반환)
      - `created` integer — Balance정보가 등록된 시각 UNIX timestamp

## Other responses

- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404` — 유효하지 않은 imp_uid
- `405` — 허용되지 않는 HTTP METHOD

---

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