---
title: "결제금액 단건조회 API"
method: GET
path: "/payments/prepare/{merchant_uid}"
tags: ["payments.validation"]
---

# 결제금액 단건조회 API

`GET /payments/prepare/{merchant_uid}`

POST 결제금액 사전등록 API 로 이미 등록되어있는 사전등록 결제정보를 조회합니다

## Path parameters

- `merchant_uid` string, required

## Response `200`

정상 조회

- PaymentPrepareResponse — 사전에 등록된 결제 예정 정보. 바로 아래 PaymentPrepare structure를 확인하세요
  - `code` integer — 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string — code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` PaymentPrepareAnnotation
    - `merchant_uid` string — 고객사 주문번호
    - `amount` number — 결제 예정 금액
    - `currency` string — 결제 예정 통화

## Other responses

- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우

---

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