즉시할인 쿠폰 조회
카드 발급사 기준으로 즉시할인 대상 카드사 및 즉시할인 조건을 조회하는 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 | 즉시할인 쿠폰 할인 금액(정률 쿠폰인 경우 결제 요청 금액 올린 경우만 포함) |
응답 예시
{
"resCd": "0000",
"resMsg": "정상",
"couponList": [
{
"couponJoinCd ": "016",
"couponJoinNm ": "국민카드",
"couponGid": "CPCHTT0001",
"calcAuthLimitRate": 0.0,
"standardAmount": 10000,
"couponAmount": 1000,
"couponRate": 10,
"discountType": "01",
"maxDiscountAmount": 15000
}
]
}