간편 정기결제 상태조회 API
카카오페이 빌키의 상태를 조회하는 API입니다.
테스트용 키 정보
API 정보
POST/spay/APIPZSubsStatus.do
Content-Type
application/json테스트
https://tbgw.settlebank.co.kr/spay/APIPZSubsStatus.do운영
https://gw.settlebank.co.kr/spay/APIPZSubsStatus.do주의 사항
NOTE
빌키 상태조회
상태조회를 통해 빌키의 유효성을 확인할 수 있습니다.
- 빌키 삭제는 별도 API(
/spay/APIPZSubsDelKey.do)를 사용합니다.
요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
params 객체
└mchtIdAN(10)영문+숫자, 최대 10byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
hecto_test: 정기결제 테스트└verAN(4)영문+숫자, 최대 4byte*전문의 버전
전문의 버전
*고정값
└methodA(2)영문, 최대 2byte*결제수단
결제수단
*고정값 (PZ: 간편결제)
└bizTypeAN(2)영문+숫자, 최대 2byte*업무 구분코드
업무 구분코드
*고정값 (S1: 상태조회)
└encCdN(2)숫자, 최대 2byte*암호화 구분 코드
암호화 구분 코드
*고정값
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유한 주문번호
상점에서 생성하는 고유한 주문번호
└trdDtN(8)숫자, 최대 8byte*요청일자 (yyyyMMdd)
요청일자 (yyyyMMdd)
└trdTmN(6)숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
└mobileYnA(1)영문, 최대 1byte모바일 여부
모바일 여부
Y: 모바일웹/앱 N: PC 또는 그 외└osTypeA(1)영문, 최대 1byteOS 구분
OS 구분
A: Android I: iOS W: Windows M: Mac E: 기타data 객체
└pktHashAN(64)영문+숫자, 최대 64byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
NOTE
해쉬 생성 조합
trdDt + trdTm + mchtId + mchtTrdNo + hashKey
└corpPayCodeAN(40)영문+숫자, 최대 40byte*간편결제사 ID
간편결제사 ID
KKP: 카카오페이 NVP: 네이버페이└billKeyAN(50)영문+숫자, 최대 50byte*헥토파이낸셜에서 발급한 빌키
헥토파이낸셜에서 발급한 빌키
└pmtOrdN(3)숫자, 최대 3byte결제수단 순번
결제수단 순번
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
params 객체
└mchtIdAN(10)영문+숫자, 최대 10byte*상점아이디
hecto_test상점아이디
└verAN(4)영문+숫자, 최대 4byte전문의 버전
0A19전문의 버전
└methodA(2)영문, 최대 2byte결제수단
PZ결제수단
└bizTypeAN(2)영문+숫자, 최대 2byte업무 구분코드
S1업무 구분코드
└encCdN(2)숫자, 최대 2byte*암호화 구분 코드
23암호화 구분 코드
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점주문번호
ORDER20211231100000상점주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜 거래번호
STFP_PGPZnx_mid_hd0230315153232M1196602헥토파이낸셜 거래번호
└trdDtN(8)숫자, 최대 8byte*요청일자 (YYYYMMDD)
20211231요청일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*요청시간 (HHMMSS)
100000요청시간 (HHMMSS)
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드 (성공/실패)
0021거래상태코드 (성공/실패)
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*결과코드
0000결과코드
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*결과메시지
정상적으로 처리되었습니다.결과메시지
data 객체
└pktHashAN(64)영문+숫자, 최대 64byte*요청시 hash 값 그대로 return
f395b6725a9a18...요청시 hash 값 그대로 return
노티 전문
NOTE
노티 없음
간편 정기결제 상태조회 API는 노티 전문이 없습니다. 응답 전문으로 결과를 확인해 주세요.
