헥토파이낸셜 개발자센터

신용카드 빌키 삭제 API

1회차 응답으로 발급받은 빌키를 삭제하는 API입니다. 삭제된 빌키는 더 이상 사용할 수 없습니다.

테스트용 키 정보

주의 사항

NOTE

빌키 서비스 신청 안내

빌키 서비스는 영업 담당자를 통해 별도 신청이 필요합니다.
  • 삭제된 빌키는 복구할 수 없습니다.
  • 삭제 전 해당 빌키로 진행 중인 결제가 없는지 확인하세요.

API 정보

POST/spay/APICardActionDelkey.do
Content-Typeapplication/json
테스트https://tbgw.settlebank.co.kr/spay/APICardActionDelkey.do
운영https://gw.settlebank.co.kr/spay/APICardActionDelkey.do

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte

params 객체

└mchtIdAN(12)영문+숫자, 최대 12byte*
헥토파이낸셜에서 부여하는 고유 상점아이디
nxca_jt_bi: 비인증 nxca_ks_gu: 구인증
└verAN(4)영문+숫자, 최대 4byte*
전문의 버전
*고정값
└methodA(2)영문, 최대 2byte*
결제수단
*고정값
└bizTypeAN(2)영문+숫자, 최대 2byte*
업무 구분코드
*고정값 (빌키 삭제용)
└encCdN(2)숫자, 최대 2byte*
암호화 구분 코드
*고정값
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*
상점에서 생성하는 고유한 주문번호
└trdDtN(8)숫자, 최대 8byte*
현재 전문을 전송하는 일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*
현재 전문을 전송하는 시간 (HHMMSS)
└mobileYnA(1)영문, 최대 1byte
모바일 여부
Y: 모바일웹/앱 N: PC 또는 그 외
└osTypeA(1)영문, 최대 1byte
OS 구분
A: Android I: IOS W: Windows M: Mac E: 기타

data 객체

└pktHashAN(64)영문+숫자, 최대 64byte*SHA-256(실시간 생성)
SHA256 방식으로 생성한 해쉬값
NOTE

해쉬 생성 조합

trdDt + trdTm + mchtId + mchtTrdNo + "0" + hashKey
└billKeyAN(50)영문+숫자, 최대 50byte*
1회차 응답으로 발급받은 빌키
└etcInfoAN(12)영문+숫자, 최대 12byte
해지사유코드

응답 파라미터

params 객체

└mchtIdAN(12)영문+숫자, 최대 12byte*nxca_jt_bi
헥토파이낸셜에서 부여하는 고유 상점아이디
└verAN(4)영문+숫자, 최대 4byte*0A19
전문의 버전
*고정값
└methodA(2)영문, 최대 2byte*CA
결제수단
*고정값
└bizTypeAN(2)영문+숫자, 최대 2byte*A1
업무 구분코드
*빌키 삭제용 고정값
└encCdN(2)숫자, 최대 2byte*23
암호화 구분 코드
*고정값
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*ORDER20211231100000
상점에서 생성하는 고유한 주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*STFP_PGCAnxca_jt_il0211129135810M1494620
헥토파이낸셜에서 발급한 고유한 거래번호
└trdDtN(8)숫자, 최대 8byte*20211231
요청일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*100000
요청시간 (HHMMSS)
└outStatCdN(4)숫자, 최대 4byte*0021
거래상태코드 (성공/실패)
0021: 성공 0031: 실패
└outRsltCdN(4)숫자, 최대 4byte*0000
거절코드. 거래상태가 '0031'일 경우, 상세 코드 전달
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*정상적으로 처리되었습니다.
결과 메세지 전달 (URL Encoding, UTF-8)

data 객체

└pktHashAN(64)영문+숫자, 최대 64byte*
요청시 hash 값 그대로 return
└billKeyAN(50)영문+숫자, 최대 50byte*SBILL_0123456789
요청시 값 그대로 return
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?