status-interest.md

카드 무이자 조회

카드 무이자 조회 | 더 알아보기

Over-view

카드 무이자 조회 API는 카드사 무이자 정보를 응답 합니다.
무이자 조회 API를 통해 무이자 결제가 가능한 카드사와 금액구간 정보를 확인 할 수 있습니다.

샘플 코드

curl -X GET 'https://api.nicepay.co.kr/v1/card/interest-free?useAuth=true&ediDate={ISO 8601 형식 날짜 표현}' 
-H 'Content-Type: application/json' 
-H 'Authorization: Basic YWYwZDExNjIzNmRmNDM3ZjgzMT...'

요청 명세

GET /v1/card/interest-free?useAuth=false&ediDate={..} HTTP/1.1  
Host: api.nicepay.co.kr 
Authorization: Basic <credentials>  or Bearer <token>
Content-type: application/json;charset=utf-8

Parameter	Type	필수	Byte	설명
useAuth	Boolean	O	-	인증 거래 여부 true : 인증 / false : 비인증(빌링)
ediDate	String	O	-	전문생성일시 ISO 8601 형식
mid	String		10	상점 MID 일반적으로 사용하지 않지만, mid가 요청된 경우, 최우선하여 제공.(요청된 clientId하위 가맹점여부 검증 필수)
signData	String		256	위변조 검증 Data 생성규칙 : hex(sha256(ediDate + SecretKey)) - SecretKey는 가맹점관리자에 로그인 하여 확인 가능합니다.
returnCharSet	String		10	응답파라메터 인코딩 방식 가맹점 서버의 encoding 방식 전달 예시) utf-8(Default) / euc-kr

응답 명세

Content-type: application/json

Parameter	Type	필수	Byte	설명
resultCode	String	O	4	결과코드 0000 : 성공 / 그외 실패
resultMsg	String	O	100	결과메시지
ediDate	String		-	응답전문생성일시 ISO 8601 형식
signature	String		256	위변조 검증 데이터 - 유효한 거래건에 한하여 응답 - 생성규칙 : hex(sha256(ediDate+ SecretKey)) - 데이터 유효성 검증을 위해, 가맹점 수준에서 비교하는 로직 구현 권고 - SecretKey는 가맹점관리자에 로그인 하여 확인 가능합니다.

무이자 할부정보

Parameter			Type	필수	Byte	설명
interestFree			Array		-	제공되는 모든 무이자 할부정보 - NICEPAY에서 기본제공하는 무이자와 상점무이자가 merge된 정보 - 카드코드별 하나의 무이자 Object가 응답됩니다.
	cardCode		String	O	3	카드사 코드 신용카드사별 코드
	cardName		String	O	20	카드사 이름 예) 비씨
	freeInstallment		Array	O	-	무이자 할부 상세 정보
		minAmt	Integer	O	12	이벤트 적용 최소 금액 ex) 50000
		maxAmt	Integer	O	14	이벤트 적용 최대 금액 ex) 99999999999999
		installment	String	O	100	무이자 할부개월 콜론(:)을 구분자로 할부개월 나열 ex) 02:03:04:05 - 설명 : 2,3,4,5개월 무이자 할부 제공
		eventToDate	String	O	-	이벤트 제공 기한 ISO 8601 형식

더 알아보기

결제 개발을 위해 더 상세한 정보가 필요하다면📌 공통 탭의 정보를 활용하고,
API 개발을 위한 각 인터페이스의 개발 명세가 필요하다면 📚 문서 탭의 자료를 확인 해주세요.
개발이 완료되어 운영에 필요한 정보와 Tip은 ☸️ 운영 탭의 정보를 통해 확인이 가능 합니다.

📌 공통

개발 전 필요한 공통적인 가이드 입니다.

• 개발 준비 👉 회원가입 | API KEY확인 | 방화벽 정책 | IP 보안기능 | 타임아웃 정보
• API·JS SDK 👉 URI 목록 | JS SDK목록 | API KEY | API·JS SDK인증 | Basic auth | Bearer token
• TEST·샘플코드 👉 샌드박스 TEST | 샌드박스 활용 | 웹로그 디버깅 | 샘플코드
• 코드집 👉 HTTP-상태코드 | 카드코드 | 은행코드 | JS SDK 응답코드 | API 응답코드

📚 문서

API 명세와 코드가 포함된 기술문서 입니다.

• 결제·발급 👉 결제창 | 빌링 | 현금영수증 | Access token
• 조회 👉 거래 조회 | 약관 조회 | 카드 이벤트 조회 | 카드 무이자 조회
• 취소·환불·망취소 👉 취소·환불 | 망 취소
• 웹훅 👉 웹훅
• APP 👉 iOS | iOS Swift | iOS Objective-c | Android | Android java | Android kotlin

☸️ 운영

운영에 필요한 정보 입니다.

• 지원환경 👉 개발환경 | 지원 브라우저
• 오류관리 👉 오류관리
• 개발정보 👉 기능 요약 | KEY 정보 | ip보안(ip접근제한) | 웹훅 | 로그