Query Instant Discount Coupons

This API checks for available card issuers and conditions for instant discounts based on the card issuer's policies.

Request

Important: Domain Difference

Please note that the API domain for this service differs from other APIs.

• Development Server: testpg.easypay.co.kr
• Production Server: pg.easypay.co.kr

Request URL

POST https://{Domain}/webpay/common/InquiryCouponAction.do?mall_id={Merchant ID}
Content-type: application/json; charset=euc-kr

Response

Parameters

Field Name	Type	Length	Required	Description
res_cd	String	4Byte	✅	Response Code (Success: “0000”)
res_msg	String	100Byte	✅	Response Message
coupon_datas	Array			Instant Discount Info (See coupon_datas below)

coupon_datas (Instant Discount Info)

Caution

• You must check the Coupon Exhaustion Rate and Minimum Purchase Amount before requesting a payment.

Field Name	Type	Length	Required	Description
card_cd	String	3Byte	✅	Target Card Code (See Window Card Codes)
card_nm	String	50Byte	✅	Card Name
coupon_id	String	10Byte	✅	Instant Discount Coupon Group ID (Required for Transaction Registration API)
calc_auth_limit_rate	Number		✅	Coupon Exhaustion Rate (%)
coupon_type	String	1Byte
standard_amt	Number		✅	Minimum Purchase Amount (Discount applies if amount >= this value)
discount_amt	Number		✅	Discount Amount

Response Example

{
   "res_cd": "0000",
   "res_msg": "Success",
   "coupon_datas": [
      {
         "card_cd": "008",
         "card_nm": "Hana Card",
         "coupon_id": "CP12345678",
         "calc_auth_limit_rate": 12.03,
         "standard_amt": 100000,
         "discount_amt": 1000
      },
      {
         "card_cd": "026",
         "card_nm": "BC Card",
         "coupon_id": "CP87654321",
         "calc_auth_limit_rate": 60.55,
         "standard_amt": 200000,
         "discount_amt": 2000
      }
   ]
}