계좌이체 승인 API (인증분리)
계좌이체 인증(UI) 완료 후, 최종 결제 승인을 별도로 요청하는 API입니다.
인증 단계에서 받은 authTrdNo를 사용하여 승인을 요청합니다.
테스트용 키 정보
API 정보
POST/spay/APIService.do
Content-Type
application/json테스트
https://tbgw.settlebank.co.kr/spay/APIService.do운영
https://gw.settlebank.co.kr/spay/APIService.do요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
params 객체
└mchtIdAN(10)영문+숫자, 최대 10byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
nx_mid_il: 테스트 아이디└verAN(4)영문+숫자, 최대 4byte*전문의 버전
전문의 버전
*고정값
└methodA(2)영문, 최대 2byte*결제수단
결제수단
*고정값 (RA: 계좌이체)
└bizTypeAN(2)영문+숫자, 최대 2byte*업무 구분코드
업무 구분코드
*고정값 (B1: 승인)
└encCdN(2)숫자, 최대 2byte*암호화 구분 코드
암호화 구분 코드
*고정값
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유한 주문번호
상점에서 생성하는 고유한 주문번호
*반드시 인증 요청 시 생성한 주문번호와 동일해야 합니다.
└trdDtN(8)숫자, 최대 8byte*요청 일자 (YYYYMMDD)
요청 일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*요청 시간 (HHMMSS)
요청 시간 (HHMMSS)
└mobileYnA(1)영문, 최대 1byte모바일 여부
모바일 여부
Y: 모바일웹/앱 N: PC 또는 그 외└osTypeA(1)영문, 최대 1byteOS 구분
OS 구분
A: Android I: iOS W: Windows M: Mac E: 기타data 객체
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
NOTE
해쉬 생성 조합
trdDt + trdTm + mchtId + mchtTrdNo + trdAmt(평문) + hashKey
└authTrdNoAN(40)영문+숫자, 최대 40byte*인증 성공 시 헥토파이낸셜에서 전달받은 거래번호
인증 성공 시 헥토파이낸셜에서 전달받은 거래번호
└trdAmtN(12)숫자, 최대 12byte*
AES-256AES-256/ECB/PKCS5Padding + Base64거래금액거래금액
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
params 객체
└mchtIdAN(10)영문+숫자, 최대 10byte*상점아이디
nx_mid_il상점아이디
└verAN(4)영문+숫자, 최대 4byte*전문의 버전
0A19전문의 버전
└methodA(2)영문, 최대 2byte*결제수단
RA결제수단
└bizTypeAN(2)영문+숫자, 최대 2byte*업무 구분코드
B1업무 구분코드
└encCdN(2)숫자, 최대 2byte*암호화 구분 코드
23암호화 구분 코드
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점주문번호
ORDER20211231100000상점주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜 거래번호 (최종 승인 번호)
STFP_PGRAnx_mid_il00211021111808M1234567헥토파이낸셜 거래번호 (최종 승인 번호)
└trdDtN(8)숫자, 최대 8byte*요청 일자
20211231요청 일자
└trdTmN(6)숫자, 최대 6byte*요청 시간
100000요청 시간
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드 (0021: 성공, 0031: 실패)
0021거래상태코드 (0021: 성공, 0031: 실패)
└outRsltCdAN(4)영문+숫자, 최대 4byte*결과코드 (0000: 성공)
0000결과코드 (0000: 성공)
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*결과메시지
성공적으로 승인되었습니다.결과메시지
data 객체
└pktHashAN(64)영문+숫자, 최대 64byte*요청 시 hash 값 그대로 return
6056160d8f24c3ad15a015a0a666b5584c9471c2f8f56945482ca3e656bd0125요청 시 hash 값 그대로 return
└authTrdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜에서 발급한 고유한 거래번호 (인증 성공 시 응답한 거래번호)
SOFP_PGRAnx_mid_il00211021111808M1234567헥토파이낸셜에서 발급한 고유한 거래번호 (인증 성공 시 응답한 거래번호)
└prdtNmAHN(128)영문+한글+숫자, 최대 128byte*상품명
테스트상품상품명
└ordNmAHN(30)영문+한글+숫자, 최대 30byte주문자명 (인증 요청 시 받은 값이 없을 경우 공백으로 전달)
홍길동주문자명 (인증 요청 시 받은 값이 없을 경우 공백으로 전달)
└sellerNmAHN(128)영문+한글+숫자, 최대 128byte판매자명
헥토파이낸셜판매자명
└dpstrNmAHN(36)영문+한글+숫자, 최대 36byte통장인자명 (고객의 통장에 찍히는 통장인자명. 공백일 경우 sellerNm(판매자명)을 통장인자명으로 사용)
가맹점명_홍길동통장인자명 (고객의 통장에 찍히는 통장인자명. 공백일 경우 sellerNm(판매자명)을 통장인자명으로 사용)
└mchtCustIdAN(50)영문+숫자, 최대 50byte상점에서 보내주는 고유 고객아이디 혹은 유니크키
HongGilDong상점에서 보내주는 고유 고객아이디 혹은 유니크키
└trdAmtN(12)숫자, 최대 12byte*
AES-256AES-256/ECB/PKCS5Padding거래금액1000거래금액
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└fnCdAN(4)영문+숫자, 최대 4byte*출금은행 코드
11출금은행 코드
└fnNmAH(50)영문+한글, 최대 50byte*출금은행명
농협출금은행명
└notiUrlAN(250)영문+숫자, 최대 250byte*결제 후 결과 전달되는 페이지의 URL (Server To Server 연동 URL)
https://example.com/notiUrl결제 후 결과 전달되는 페이지의 URL (Server To Server 연동 URL)
└mchtParamAHN(4000)영문+한글+숫자, 최대 4000byte기타 주문 정보를 입력하는 상점 예약 필드
name=HongGilDong&age=25기타 주문 정보를 입력하는 상점 예약 필드
응답 전문 해쉬 코드
| 항목 | 조합 필드 |
|---|---|
| pktHash | 거래상태코드 + 요청일자 + 요청시간 + 상점아이디 + 상점주문번호 + 거래금액(평문) + 해쉬키 |
노티 전문
NOTE
노티 전문 참고
계좌이체 결제 노티 전문은 노티 전문 문서를 참고하세요.
