헥토파이낸셜 개발자센터

휴대폰 자동결제 API

휴대폰 자동결제는 1회차 결제 승인 이후, 발급된 인증키(billKey)로 다음 회차에 다시 결제하는 방식의 서비스입니다.

테스트용 키 정보

API 정보

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

주의 사항

NOTE

월자동 결제 흐름

1) 1회차 결제창 요청 (autoPayType='M') → 2) billKey 발급 → 3) 2회차부터 이 API로 결제
  • 1회차 결제 시 autoPayType 요청 파라미터에 M을 설정하면 billKey가 발급됩니다.
  • 2회차 결제 시 발급받은 billKey를 요청 파라미터에 세팅하여 결제 요청합니다.
  • 2회차 결제 시의 거래금액과 상품명은 1회차 결제와 동일해야 합니다.

요청 파라미터

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

params 객체

└mchtIdAN(10)영문+숫자, 최대 10byte*
헥토파이낸셜에서 부여하는 고유 상점아이디
nxhp_sb_ma: 월자동결제 테스트
└verAN(4)영문+숫자, 최대 4byte*
전문의 버전
*고정값
└methodA(2)영문, 최대 2byte*
결제수단
*고정값 (MP: 휴대폰결제)
└bizTypeAN(2)영문+숫자, 최대 2byte*
업무 구분코드
*고정값 (B1: 자동연장)
└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 + trdAmt(평문) + hashKey
└emailAN(60)영문+숫자, 최대 60byte*
고객 이메일 주소
└mUserIdAHN(50)영문+한글+숫자, 최대 50byte*
상점 고객아이디
└crcCdA(3)영문, 최대 3byte*
통화구분
*고정값
└trdAmtN(12)숫자, 최대 12byte*AES-256AES-256/ECB/PKCS5Padding + Base64
거래금액 (1회차 결제와 동일해야 함)
└prdtNmAHN(128)영문+한글+숫자, 최대 128byte*
상품명 (1회차 결제와 동일해야 함)
└sellerNmAHN(50)영문+한글+숫자, 최대 50byte
판매자명
└ordNmAHN(50)영문+한글+숫자, 최대 50byte*
주문자명
└billKeyAN(50)영문+숫자, 최대 50byte*
헥토파이낸셜에서 발급한 빌키

응답 파라미터

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

params 객체

└mchtIdAN(10)영문+숫자, 최대 10byte*nxhp_sb_ma
상점아이디
└verAN(4)영문+숫자, 최대 4byte*0A19
전문의 버전
└methodA(2)영문, 최대 2byte*MP
결제수단
└bizTypeAN(2)영문+숫자, 최대 2byte*B1
업무 구분코드
└encCdN(2)숫자, 최대 2byte*23
암호화 구분 코드
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*ORDER20211231100000
상점주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*STFP_PGMPnxhp_sb_ma0211129135810M1494620
헥토파이낸셜 거래번호
└trdDtN(8)숫자, 최대 8byte*20211231
요청일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*100000
요청시간 (HHMMSS)
└outStatCdAN(4)영문+숫자, 최대 4byte*0021
거래상태코드 (성공/실패)
0021: 성공 0031: 실패
└outRsltCdAN(4)영문+숫자, 최대 4byte*0000
결과코드
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*정상적으로 처리되었습니다.
결과메시지

data 객체

└pktHashAN(64)영문+숫자, 최대 64byte*f395b6725a9a18...
요청시 hash 값 그대로 return
└telCoA(3)영문, 최대 3byteAES-256AES-256/ECB/PKCS5PaddingSKT
통신사
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└trdAmtN(12)숫자, 최대 12byte*AES-256AES-256/ECB/PKCS5Padding1000
거래금액
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└billKeyAN(50)영문+숫자, 최대 50byte*MO0123456789
요청 시 값 그대로 return
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?