---
title: "결제금액 사전등록 API"
method: POST
path: "/payments/prepare"
tags: ["payments.validation"]
---

# 결제금액 사전등록 API

`POST /payments/prepare`

(포트원 javascript사용)인증방식의 결제를 진행할 때 결제금액 위변조시 결제진행자체를 block하기 위해 결제예정금액을 사전등록하는 기능입니다.
     * <br>이 API를 통해 사전등록된 고객사 주문번호(merchant_uid)에 대해, IMP.request_pay()에 전달된 merchant_uid가 일치하는 주문의 결제금액이 다른 경우 PG사 결제창 호출이 중단됩니다.

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