즉시할인 쿠폰 조회

카드 발급사 기준으로 즉시할인 대상 카드사 및 즉시할인 조건을 조회하는 API 입니다.

주의사항

즉시할인 쿠폰 소진율 및 기준금액을 반드시 확인하여 결제 요청하시기 바랍니다.

요청

주의

API 도메인을 확인하여 요청 바랍니다.

개발 서버: testpgapi.easypay.co.kr
운영 서버: pgapi.easypay.co.kr

요청 URL
POST https://{API 도메인}/api/etc/inquiryCoupon
Content-type: application/json; charset=utf-8

주의사항

조회조건으로 cardCd(카드사코드)와 cardBin(카드BIN) 중 하나만 요청해주시기 바랍니다.

파라미터

필드명	타입	길이	필수여부	설명
mallId	String	8Byte	✅	KICC에서 부여한 상점ID
cardCd	String	3Byte		카드사 코드(발급사 기준) (카드사 코드 참고)
cardBin	String	8Byte		카드 BIN(카드번호 앞 8자리)
amount	Number			결제 요청 금액

요청 예시
{  
    "mallId": "{상점ID}", 
    "cardBin" : "12345678",
    "amount" : "51004"
}

응답

파라미터

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지
couponList	Array		즉시할인 정보 (아래 couponList 참조)

couponList(즉시할인 쿠폰 정보)

필드명	타입	길이	설명
couponJoinCd	String	3Byte	즉시할인 쿠폰 제휴사 코드(카드사 코드) (카드사 코드 참고)
couponJoinNm	String	50Byte	카드사명
couponGid	String	10Byte	즉시할인 쿠폰 그룹ID
calcAuthLimitRate	Number		즉시할인 쿠폰 소진율
standardAmount	Number		즉시할인 기준금액(기준금액 이상일 경우 즉시할인 가능)
discountType	String	2Byte	즉시할인 쿠폰 구분(정률:01, 정액:02)
maxDiscountAmount	Number		최대 할인 금액(정률 쿠폰에만 포함)
couponRate	Number		즉시할인 쿠폰 할인율(정률 쿠폰에만 포함)
couponAmount	Number		즉시할인 쿠폰 할인 금액(정률 쿠폰인 경우 결제 요청 금액 올린 경우만 포함)
discountRoundingUnit	String	2Byte	정률쿠폰 할인금액 반올림 단위(정률 쿠폰 discountType=01에만 포함) Default: 소수점 첫째 자리 반올림(1원 단위로 처리) 01: 1원자리 반올림(10원 단위로 처리) 02: 10원 자리 반올림(100원 단위로 처리)

응답 예시
{
  "resCd": "0000",
  "resMsg": "정상",
  "couponList": [
    {
      "couponJoinCd ": "016",
      "couponJoinNm ": "국민카드",
      "couponGid": "CPCHTT0001",
      "calcAuthLimitRate": 0.0,
      "standardAmount": 10000,
      "couponAmount": 1000,
      "couponRate": 10,
      "discountType": "01",
      "maxDiscountAmount": 15000
    }
  ]
}

요청​

파라미터​

응답​

파라미터​

couponList(즉시할인 쿠폰 정보)​

요청

파라미터

응답

파라미터

couponList(즉시할인 쿠폰 정보)