결제수단 조회

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

정보

• 본 API는 PG 결제를 위해 제공되는 서비스 입니다.
• 영업담당자를 통해 사용할 가맹점ID(mallId)를 필히 발급받기 바랍니다.

요청

요청 URL

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

파라미터

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

{  
  "mallId": "{KICC에서 부여한 가맹점ID}", 
  "customerKey": "{간편결제 회원 고유키}", 
  "payMethodTypeCodeList": "11", 
  "payMethodDetailCodeList": ""
}

응답

파라미터

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

payMethodInfoList(결제수단 상세목록)

필드명	타입	길이	설명
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”)
installmentInfoList	Array		결제수단(신용카드) 할부정보(KICC PG 사용 시 노출) 아래 installmentInfoList 참조
cardPointInfo	Object		카드사 포인트 정보 결제수단이 카드일 경우 노출 (아래 cardPointInfo 참조)

payMethodList > installmentInfoList(결제수단 할부정보)

필드명	타입	길이	설명
basisAmount	Number		할부가능 최소 기준금액
freeInstallmentMonthList	Array		무이자 할부 가능한 개월 수 예) [2,3,4,5,6]
installmentMonthList	Array		유이자 할부 가능한 개월 수 예) [2,3,4,5,6,7,8,9,10,11,12]

payMethodList > cardPointInfo(카드사 포인트 정보)

필드명	타입	길이	설명
isPointEnabled	Boolean		카드사 포인트 사용가능여부 true: 포인트 사용가능(checkbox 노출필요)

응답 예시

{
  "resCd": "0000",
  "resMsg": "정상처리",
  "payMethodInfoList": [
    {
      "payMethodTypeCode": "11",
      "payMethodDetailCode": "016",
      "displayName": "신용카드",
      "nickName": "KB국민카드",
      "easypayVirtualNo": "{결제수단 가상번호}",
      "maskingNo": "445612******1234",
      "imageUrl": "{결제수단 이미지 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": "신용카드",
      "nickName": "현대카드",
      "easypayVirtualNo": "{결제수단 가상번호}",
      "maskingNo": "545312******1234",
      "imageUrl": "{결제수단 이미지 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
      }
    }
  ]
}