Skip to main content

Payment Method Inquiry

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

info

Request​

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

Parameters​

Field NameTypeLengthRequiredDescription
customerKeyString60Byte✅Simple Payment member unique key
payMethodTypeCodeListString60ByteSee Payment Method Codes
Empty: All, Credit Card: 11, Account: 21
payMethodDetailCodeListString100ByteCard Codes or Bank Codes
Empty: All
Request Example
{  
"customerKey": "{Simple Payment Member Unique Key}",
"payMethodTypeCodeList": "11",
"payMethodDetailCodeList": ""
}

Response​

Parameters​

Field NameTypeLengthRequiredDescription
resCdString4Byte✅Result Code (Normal: “0000”)
resMsgString1000Byte✅Result Message
payMethodInfoListArrayList of payment method details (See payMethodList below)

payMethodList (Payment Method Details)​

Field NameTypeLengthRequiredDescription
payMethodTypeCodeString2Byte✅See Payment Method Codes
payMethodDetailCodeString3Byte✅Card Codes or Bank Codes
displayNameString30ByteDetailed payment method name
nickNameString30ByteNickname set by the member for the payment method
easypayVirtualNoString60Byte✅Payment method virtual number
maskingNoString30Byte✅Masked (*) payment method number
imageUrlString256Byte✅Payment method image URL
sortOrderNumber✅Display order of the payment method
checkCardFlagString1ByteCheck card flag (Y/N) - Displayed if the method is a card
cardUserTypeString1BytePersonal/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"
}
]
}