Payment Method Inquiry

This API retrieves the list of payment methods registered for Simple Payment using the member's Customer Key.

info

• This API is provided specifically for VAN payment services.
• For online non-face-to-face payments, please refer to the VAN Payment > Simple Payment Guide.

Request

Request URL

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

Parameters

Field Name	Type	Length	Required	Description
customerKey	String	60Byte	✅	Simple Payment member unique key
payMethodTypeCodeList	String	60Byte		See Payment Method Codes Empty: All, Credit Card: 11, Account: 21
payMethodDetailCodeList	String	100Byte		Card Codes or Bank Codes Empty: All

Request Example

{  
  "customerKey": "{Simple Payment Member Unique Key}", 
  "payMethodTypeCodeList": "11", 
  "payMethodDetailCodeList": ""
}

Response

Parameters

Field Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Result Code (Normal: “0000”)
resMsg	String	1000Byte	✅	Result Message
payMethodInfoList	Array			List of payment method details (See payMethodList below)

payMethodList (Payment Method Details)

Field Name	Type	Length	Required	Description
payMethodTypeCode	String	2Byte	✅	See Payment Method Codes
payMethodDetailCode	String	3Byte	✅	Card Codes or Bank Codes
displayName	String	30Byte		Detailed payment method name
nickName	String	30Byte		Nickname set by the member for the payment method
easypayVirtualNo	String	60Byte	✅	Payment method virtual number
maskingNo	String	30Byte	✅	Masked (*) payment method number
imageUrl	String	256Byte	✅	Payment method image URL
sortOrder	Number		✅	Display order of the payment method
checkCardFlag	String	1Byte		Check card flag (Y/N) - Displayed if the method is a card
cardUserType	String	1Byte		Personal/Corporate classification Personal: “P”, Corporate: “C”

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": "{Payment Method Image URL}",
      "sortOrder": 1,
      "checkCardFlag": "Y",
      "cardUserType": "P"      
    },
    {
      "payMethodTypeCode": "11",
      "payMethodDetailCode": "026",
      "displayName": "Credit Card",
      "nickName": "BC Card",
      "easypayVirtualNo": "{Payment Method Virtual Number}",
      "maskingNo": "565612******1234",
      "imageUrl": "{Payment Method Image URL}",
      "sortOrder": 2,
      "checkCardFlag": "Y",
      "cardUserType": "P"      
    }
  ]
}