⌨️프로모션 적용금액 획득 API

할인이 적용된 최종 결제금액을 획득할수 있는 API 입니다.

현재 진행되고 있는 프로모션 할인금액정보를 획득합니다.

해당 API 를 이용하여 할인금액이 적용된 결제 금액정보를 획득할 수 있습니다. 해당 정보를 이용하여 가맹점 주문페이지에서 최종 결제전에 결제예정 금액과 할인금액 및 할인율 정보를 표시할 수 있습니다.

현재 가능한 프로모션 및 할인 금액 계산을 가져옵니다

GET https://api.iamport.kr/promotion/current

할인이 적용된 최종 결제금액을 획득할 수 있습니다.

Query Parameters

Name	Type	Description
amount*	double	결제금액
merchant_uid	String	주문번호

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

{
    // Response
}

200: OK 성공

CurrentPromotionsAnnotation

code * integer

응답코드

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

message * string

응답메세지

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

response (Array[CurrentPromotionDetailAnnotation], optional )

CurrentPromotionDetailAnnotation

issuer string

카드사 고유번호

amount string

할인된 금액

start string

시작일시

end string

종료일시

promotion_id * string

프로모션 ID

discount (Array[Discount])

할인정보

Discount

amount string

정액 할인 금액

percent string

정율 할인율

max_discount string

최대 할인 금액

min_amount string

최소 결제 금액

Response Model Schema

HTTP status 200

{
  "code": 0,
  "message": "string",
  "response": [
    {
      "issuer": "string",
      "amount": "string",
      "discount": {
        "amount": "string",
        "percent": "string",
        "max_discount": "string",
        "min_amount": "string"
      },
      "start": "string",
      "end": "string",
      "promotion_id": "string"
    }
  ]
}