⌨️결제금액 사전등록 API

인증 결제시 결제금액을 사전등록 하여 금액 위변조로 인한 결제사고를 예방합니다.

Deprecated

이 문서는 더 이상 관리되지 않습니다.

PortOne 개발자센터를 이용해주세요.

인증결제를 진행할 때 결제금액 위변조 시 결제진행자체를 block 하기 위해 결제예정금액을 사전등록하는 기능

결제 금액을 사전 등록합니다.

POST https://api.iamport.kr/payments/prepare

사전등록된 가맹점 주문번호(merchant_uid)에 대해, IMP.request_pay()에 전달된 merchant_uid가 일치하는 주문의 결제금액이 다른 경우 PG사 결제창 호출이 중단됩니다

Request Body

Name	Type	Description
merchant_uid*	String	가맹점 주문번호
amount*	double	결제 예정금액

200: OK 성공

PaymentPrepareResponse

code * integer

응답코드

0이면 정상적인 조회, 0 이 아닌 값이면 message를 확인해봐야 합니다

message * string

응답메세지

code 값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다

response (PaymentPrepareAnnotation, optional)

PaymentPrepareAnnotation

merchant_uid * string

가맹점 주문번호

amount * number

결제 예정 금액

401: Unauthorized 인증 Token이 전달되지 않았거나 유효하지 않은 경우

Response Model Schema

{
  "code": 0,
  "message": "string",
  "response": {
    "merchant_uid": "string",
    "amount": 0
  }
}

Swagger Test Link

https://api.iamport.kr/#!/payments.validation/preparePayment