결제수단 조회

이지페이 간편결제 회원의 고유키(Customer Key)로 간편결제 등록된 결제수단을 조회하는 API 입니다.

정보

• 본 API는 VAN 결제를 위해 제공되는 서비스 입니다.
• 온라인 비대면 결제는 VAN 결제 > 간편결제 가이드를 참조하세요.

요청

요청 URL

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

파라미터

필드명	타입	길이	필수여부	설명
customerKey	String	60Byte	✅	간편결제 회원 고유키
payMethodTypeCodeList	String	60Byte		결제수단 코드 참고, 전체조회: 빈값 신용카드: 11, 계좌: 21
payMethodDetailCodeList	String	100Byte		카드코드 또는 은행코드, 전체조회: 빈값

{  
  "customerKey": "{간편결제 회원 고유키}", 
  "payMethodTypeCodeList": "11", 
  "payMethodDetailCodeList": ""
}

응답

파라미터

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지
payMethodInfoList	Array		결제수단 상세정보 목록 (아래 payMethodList 참조)

payMethodList(결제수단 상세정보 목록)

필드명	타입	길이	설명
payMethodTypeCode	String	2Byte	거래인증 등록요청 시 필수 필드(결제수단 코드 참고)
payMethodDetailCode	String	3Byte	거래인증 등록요청 시 필수 필드(카드코드 또는 은행코드)
displayName	String	30Byte	세부 결제수단 명칭
nickName	String	30Byte	회원이 설정한 결제수단 별칭
easypayVirtualNo	String	60Byte	결제수단 가상번호 거래인증 등록요청 시 필수 필드
maskingNo	String	30Byte	마스킹(*)된 결제수단 번호
imageUrl	String	256Byte	결제수단 이미지 URL
sortOrder	Number		결제수단 노출 순서
checkCardFlag	String	1Byte	체크카드 여부(Y/N) 결제수단이 카드일 경우 노출
cardUserType	String	1Byte	개인/법인 구분 (개인: “P”, 법인: “C”)

응답 예시

{
  "resCd": "0000",
  "resMsg": "정상처리",
  "payMethodInfoList": [
    {
      "payMethodTypeCode": "11",
      "payMethodDetailCode": "016",
      "displayName": "신용카드",
      "nickName": "KB국민카드",
      "easypayVirtualNo": "{결제수단 가상번호}",
      "maskingNo": "445612******1234",
      "imageUrl": "{결제수단 이미지 URL}",
      "sortOrder": 1,
      "checkCardFlag": "Y",
      "cardUserType": "P"      
    },
    {
      "payMethodTypeCode": "11",
      "payMethodDetailCode": "026",
      "displayName": "신용카드",
      "nickName": "BC카드",
      "easypayVirtualNo": "{결제수단 가상번호}",
      "maskingNo": "565612******1234",
      "imageUrl": "{결제수단 이미지 URL}",
      "sortOrder": 2,
      "checkCardFlag": "Y",
      "cardUserType": "P"      
    }
  ]
}