Payment Method Inquiry

This API retrieves the list of payment methods registered by a Simple Payment member using their Customer Key.

Note

• This API is provided for PG payment services.
• You must obtain the Merchant ID (mallId) from your sales representative to use this service.

Request

Request URL

POST https://{API Domain}/easypay/user/paymentMethodInfo.do
Content-type: application/json; charset=euc-kr

Parameters

Field Name	Type	Length	Required	Description
mallId	String	8Byte	✅	Merchant ID assigned by KICC
customerKey	String	60Byte	✅	Simple Payment User Unique Key
payMethodTypeCodeList	String	60Byte		Payment Method Type Filter Empty: All, "11": Credit Card, "21": Account (See PayMethod Code)
payMethodDetailCodeList	String	100Byte		Issuer/Bank Code Filter Empty: All (See Card Code or Bank Code)

Request Example

{  
  "mallId": "{Merchant ID}", 
  "customerKey": "{Simple Payment User Unique Key}", 
  "payMethodTypeCodeList": "11", 
  "payMethodDetailCodeList": ""
}

Response

Parameters

Field Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Result Code (Success: “0000”)
resMsg	String	1000Byte	✅	Result Message
payMethodInfoList	Array			Payment Method Detail List (See payMethodInfoList below)

payMethodInfoList (Payment Method Detail List)

Field Name	Type	Length	Required	Description
payMethodTypeCode	String	2Byte	✅	See PayMethod Code
payMethodDetailCode	String	3Byte	✅	See Card Code or See Bank Code
displayName	String	30Byte		Payment Method Display Name
nickName	String	30Byte		User-defined Nickname
easypayVirtualNo	String	60Byte	✅	Payment Method Virtual Number (Important)
maskingNo	String	30Byte	✅	Masked Number (e.g., ****1234)
imageUrl	String	256Byte	✅	Payment Method Icon/Image URL
sortOrder	Number		✅	Display Sort Order
checkCardFlag	String	1Byte		Check Card Flag (Y/N) (If type is Card)
cardUserType	String	1Byte		Card User Type Personal: “P”, Corporate: “C”
installmentInfoList	Array			Installment Info (For Credit Cards, PG only) (See installmentInfoList below)
cardPointInfo	Object			Card Point Info (For Credit Cards) (See cardPointInfo below)

payMethodList > installmentInfoList (Installment Info)

Field Name	Type	Length	Required	Description
basisAmount	Number		✅	Minimum Amount Required for Installment
freeInstallmentMonthList	Array			List of Interest-Free Months e.g., [2,3,4,5,6]
installmentMonthList	Array			List of Available Installment Months e.g., [2,3...12]

payMethodList > cardPointInfo (Card Point Info)

Field Name	Type	Length	Required	Description
isPointEnabled	Boolean		✅	Point Usage Availability true: Can use points (Display checkbox)

Response Example

{
  "resCd": "0000",
  "resMsg": "Success",
  "payMethodInfoList": [
    {
      "payMethodTypeCode": "11",
      "payMethodDetailCode": "016",
      "displayName": "Credit Card",
      "nickName": "KB Kookmin Card",
      "easypayVirtualNo": "{Payment Method Virtual Number}",
      "maskingNo": "445612******1234",
      "imageUrl": "{Image URL}",
      "sortOrder": 1,
      "checkCardFlag": "Y",
      "cardUserType": "P",
      "installmentInfoList": [
        {
          "basisAmount": 50000,
          "freeInstallmentMonthList": [2,3,4,5,6],
          "installmentMonthList": [2,3,4,5,6,7,8,9,10,11,12]
        }
      ],
      "cardPointInfo": {
        "isPointEnabled": true
      }
    },
    {
      "payMethodTypeCode": "11",
      "payMethodDetailCode": "027",
      "displayName": "Credit Card",
      "nickName": "Hyundai Card",
      "easypayVirtualNo": "{Payment Method Virtual Number}",
      "maskingNo": "545312******1234",
      "imageUrl": "{Image URL}",
      "sortOrder": 1,
      "checkCardFlag": "Y",
      "cardUserType": "P",
      "installmentInfoList": [
        {
          "basisAmount": 10000,
          "freeInstallmentMonthList": [2,3,4,5,6],
          "installmentMonthList": [2,3,4,5,6,7,8,9,10,11,12]
        }
      ],
      "cardPointInfo": {
        "isPointEnabled": true
      }
    }
  ]
}