헥토파이낸셜 개발자센터

포인트다모아 승인 API (인증/승인 분리)

포인트다모아 결제창에서 인증만 완료한 후, 가맹점 서버에서 승인을 별도로 요청하는 API입니다. 결제창에서 outStatCd=0061(인증 성공)을 받은 후 이 API로 승인을 요청합니다.

테스트용 키 정보

API 정보

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

주의 사항

인증/승인 분리 방식

이 API는 결제창에서 인증 완료(outStatCd=0061) 후 승인을 별도로 요청하는 방식입니다.
  • 결제창에서 인증 성공 시 outStatCd=0061을 반환합니다.
  • 반드시 인증 시 사용한 상점주문번호(mchtTrdNo)를 승인 요청에 사용해야 합니다.
  • 인증거래번호(authTrdNo)는 인증 응답에서 받은 거래번호를 사용합니다.

요청 파라미터

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

params 객체

└mchtIdAN(10)영문+숫자, 최대 10byte*
헥토파이낸셜에서 부여하는 고유 상점아이디
nxpt_kt_il: 포인트다모아 테스트
└verAN(4)영문+숫자, 최대 4byte*
전문의 버전
*고정값
└methodA(2)영문, 최대 2byte*
결제수단
*고정값 (CP: 포인트다모아)
└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
└authTrdNoAN(40)영문+숫자, 최대 40byte*
인증 시 헥토파이낸셜에서 발급한 거래번호
└trdAmtN(12)숫자, 최대 12byte*AES-256AES-256/ECB/PKCS5Padding + Base64
거래금액

응답 파라미터

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

params 객체

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

data 객체

└pktHashAN(64)영문+숫자, 최대 64byte*980f95d9b059dd15394eeb39...
요청시 hash 값 그대로 return
└authTrdNoAN(40)영문+숫자, 최대 40byte*SOFP_PGCPnxpt_kt_il0211021111808M1234567
인증 시 헥토파이낸셜에서 발급한 거래번호
└trdAmtN(12)숫자, 최대 12byte*AES-256AES-256/ECB/PKCS5Padding1000
거래금액
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.

노티 전문 (헥토파이낸셜 -> 가맹점)

NOTE

노티 전문 참고

포인트다모아 승인 API 노티 전문은 휴대폰결제 노티 전문(24.4)과 동일합니다.
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?