정기결제 해지 API

등록된 정기결제를 해지합니다.


정기결제 해지

등록된 정기결제를 해지합니다.

API 정보

POST/v1/api/regular/unreg
Content-Typeapplication/json; charset=UTF-8
테스트https://tbnpay.settlebank.co.kr/v1/api/regular/unreg
운영https://npay.settlebank.co.kr/v1/api/regular/unreg

요청 파라미터

hdInfoAN(50)영문+숫자, 최대 50byte*
전문정보 코드
*고정값
mchtIdAN(8)영문+숫자, 최대 8byte*
상점아이디
mchtTrdNoAN(100)영문+숫자, 최대 100byte*
상점 주문번호 (한글 제외)
mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
고객아이디
reqDtN(8)숫자, 최대 8byte*
요청일자 (yyyyMMdd)
reqTmN(6)숫자, 최대 6byte*
요청시간 (HH24MISS)
rglChrgKeyAN(32)영문+숫자, 최대 32byte*
정기결제용으로 생성된 유니크한 키
custIpAN(15)영문+숫자, 최대 15byte
가맹점 서버의 IP가 아닌 고객 기기의 IP 주소
pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 해쉬값
NOTE

해쉬 생성 조합

mchtId + mchtCustId + reqDt + reqTm + rglChrgKey + hashKey

응답 파라미터

outStatCdAN(4)영문+숫자, 최대 4byte*0021
거래상태코드
0021: 성공 0031: 실패
outRsltCdAN(4)영문+숫자, 최대 4byte*0000
거절코드
*ST08: 이미 등록된 계좌일 경우 등록된 계좌 정보 전달
outRsltMsgAN(300)영문+숫자, 최대 300byte*정상처리되었습니다.
결과메시지
mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Paddingkimhecto
고객아이디
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
mchtTrdNoAN(100)영문+숫자, 최대 100byte*OID201902210001
상점 주문번호
*한글 제외
trdNoAN(40)영문+숫자, 최대 40byte*STFP_FIRM12345678901234567890
거래번호

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?