헥토파이낸셜 개발자센터

포인트다모아 결제 (결제창 방식)

포인트다모아는 고객이 보유한 다양한 포인트(통신사 포인트, 카드사 포인트 등)를 통합하여 결제할 수 있는 서비스입니다.

테스트용 키 정보

API 정보

POST/point/main.do
Content-Typeapplication/x-www-form-urlencoded
테스트https://tbnpg.settlebank.co.kr/point/main.do
운영https://npg.settlebank.co.kr/point/main.do

주의 사항

NOTE

결제 처리 방식

일반적으로 결제창에서 인증과 승인이 한 번에 처리됩니다 (outStatCd: 0021). 가맹점 요청에 따라 인증/승인 분리형으로 운영할 수 있으며, 분리형의 경우 인증 성공 시 outStatCd: 0061이 반환되고 certNotiUrl로 인증 결과가 전달됩니다. 이후 가맹점이 별도로 승인 API를 호출하여 결제를 완료합니다.

테스트 환경 IP 허용 안내

포인트다모아 테스트 환경에서는 결제창 원천사인 포인트 허브에 IP 허용 신청이 필요합니다. 서버 IP가 아닌 결제창에 접근하는 브라우저(클라이언트) IP 기준이며, 헥토파이낸셜이 아닌 포인트 허브 측에 직접 요청하셔야 합니다.
  • 통신사 포인트, 카드사 포인트 등 다양한 포인트를 통합 사용 가능합니다.
  • 고객 인증이 필요한 경우 CI 정보가 필요할 수 있습니다.
  • 부분 취소는 지원하지 않습니다. 취소가 필요한 경우 전체 취소 후 재승인해 주세요.

요청 파라미터

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

필수 파라미터

└mchtIdAN(10)영문+숫자, 최대 10byte*
헥토파이낸셜에서 부여하는 고유 상점아이디
nxpt_kt_il: 포인트다모아 테스트
└methodAN(20)영문+숫자, 최대 20byte*
결제 구분 코드
*고정값
└trdDtN(8)숫자, 최대 8byte*
요청일자 (yyyyMMdd)
└trdTmN(6)숫자, 최대 6byte*
요청시간 (HH24MISS)
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*
상점에서 생성하는 고유 주문번호 (한글 제외)
└mchtNameAHN(100)영문+한글+숫자, 최대 100byte*
상점한글명
└mchtENameAN(100)영문+숫자, 최대 100byte*
상점영문명
└pmtPrdtNmAHN(128)영문+한글+숫자, 최대 128byte*
결제상품명
└trdAmtN(12)숫자, 최대 12byte*AES-256AES-256/ECB/PKCS5Padding + Base64
거래금액
└notiUrlAN(250)영문+숫자, 최대 250byte*
결제 후 결과 전달되는 페이지의 URL (Server To Server 연동 URL)
└nextUrlAN(250)영문+숫자, 최대 250byte*
결제 결과 화면으로 전환되는 URL
*결제창 내 버튼 클릭 시 리다이렉트 됩니다. outStatCd 값으로 결제 성공(0021)/실패(0031) 여부를 확인하세요.
└cancUrlAN(250)영문+숫자, 최대 250byte*
고객이 결제창의 X 버튼 클릭 시 리다이렉트 되는 URL
*브라우저 종료, 뒤로가기 등은 감지되지 않습니다.
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA256 방식으로 생성한 해쉬값
NOTE

해쉬 생성 조합

mchtId + method + mchtTrdNo + trdDt + trdTm + trdAmt(평문) + hashKey

선택 파라미터

└mchtCustNmAHN(30)영문+한글+숫자, 최대 30byteAES-256AES-256/ECB/PKCS5Padding + Base64
고객명
└mchtCustIdAN(50)영문+숫자, 최대 50byteAES-256AES-256/ECB/PKCS5Padding + Base64
상점 고객아이디
└custIpAN(15)영문+숫자, 최대 15byte
고객 IP 주소
└emailAN(60)영문+숫자, 최대 60byteAES-256AES-256/ECB/PKCS5Padding + Base64
고객 이메일 주소
└mchtParamAHN(4000)영문+한글+숫자, 최대 4000byte
상점 예약 필드 (결과 전달시 그대로 return)
└prdtTermN(14)숫자, 최대 14byte
상품제공기간 (yyyyMMddHHmmss, 값이 없으면 일반결제로 표기)
└clipCustNmAHN(30)영문+한글+숫자, 최대 30byteAES-256AES-256/ECB/PKCS5Padding + Base64
포인트다모아 고객명
└clipCustCiAN(100)영문+숫자, 최대 100byteAES-256AES-256/ECB/PKCS5Padding + Base64
포인트다모아 CI
└clipCustPhoneNoN(11)숫자, 최대 11byteAES-256AES-256/ECB/PKCS5Padding + Base64
포인트다모아 휴대폰번호
└certNotiUrlAN(250)영문+숫자, 최대 250byte
인증결과 URL (Server To Server 연동 URL, 특정상점만 사용)
└skipCdA(1)영문, 최대 1byte
약관동의 스킵여부
└multiPayAN(2)영문+숫자, 최대 2byte
포인트 복합결제 (신용카드 복합결제 시 사용)
MP: 복합결제

응답 파라미터

결제 완료 또는 실패 시 nextUrl로, 고객이 결제창 내 X 버튼을 클릭하면 cancUrl로 리다이렉트되며 아래 파라미터가 전달됩니다. 브라우저 종료 및 뒤로가기는 감지되지 않습니다.

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

공통 응답

└mchtIdAN(10)영문+숫자, 최대 10byte*nxpt_kt_il
상점아이디
└outStatCdAN(4)영문+숫자, 최대 4byte*0021
거래상태코드
0021: 성공 0061: 인증 성공 (인증/승인 분리형) 0031: 실패
└outRsltCdAN(4)영문+숫자, 최대 4byte*0000
결과코드
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*정상적으로 처리되었습니다.
결과메시지
└methodAN(20)영문+숫자, 최대 20byte*point
결제수단
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*POINT20211231100000
상점 주문번호
└mchtCustIdAN(50)영문+숫자, 최대 50byteAES-256AES-256/ECB/PKCS5PaddingHongGilDong
상점 고객아이디
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└trdNoAN(40)영문+숫자, 최대 40byte*STFP_PGCPnxpt_kt_il0211129135810M1494620
헥토파이낸셜 거래번호
└trdAmtN(12)숫자, 최대 12byte*AES-256AES-256/ECB/PKCS5Padding1000
거래금액
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└mchtParamAHN(4000)영문+한글+숫자, 최대 4000bytename=HongGilDong&age=25
요청으로 받은 필드값을 응답으로 Bypass
└authDtN(14)숫자, 최대 14byte20211231100000
승인일시

노티 전문 (결과통보)

결제 완료 후 헥토파이낸셜에서 가맹점으로 노티(결과통보)가 전송됩니다.

NOTE

노티 전문 확인

포인트다모아 결제 결과통보 파라미터와 처리 방법은 노티 전문 문서를 참고하세요.
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?