---
title: "결제금액 단건 수정 API"
method: PUT
path: "/payments/prepare"
tags: ["payments.validation"]
---

# 결제금액 단건 수정 API

`PUT /payments/prepare`

POST 결제금액 사전등록 API 로 이미 등록된 결제사전정보에 대해 금액을 수정하는 기능입니다.

## 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이 전달되지 않았거나 유효하지 않은 경우
- `404` — 요청된 merchant_uid 로 등록된 결제사전정보를 찾을 수 없는 경우

---

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