헥토파이낸셜 개발자센터
Products서비스
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
API & SDKAPI & SDK
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그블로그
FAQFAQ
서비스 상태
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그
기술 블로그 및 소식
FAQ
자주 묻는 질문
서비스 상태
서비스 장애 및 점검 현황
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트

신용카드 결제 (직호출 방식) API

카드사 인증창을 직접 호출하여 결제를 진행하는 방식입니다. 일반 결제창과 달리 중간 UI 없이 바로 카드사 인증 화면으로 이동합니다.

테스트용 키 정보

암호화 키: pgSettle30y739r82jtd709yOfZ2yK5K
해시 생성 키: ST1009281328226982205
* 운영 환경에서는 헥토파이낸셜에서 별도 제공하는 키를 사용해야 합니다.

API 정보

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

일반 결제창과의 차이점

NOTE

직호출 방식의 특징

직호출 방식은 결제수단 선택 화면 없이 바로 카드사 인증창으로 이동합니다. 할부개월수(instmtMon)를 지정하면 해당 값으로 바로 결제가 진행됩니다.
구분일반 결제창 (/card/main.do)직호출 (/card/cardDirect.do)
UI 흐름결제수단 선택 → 카드사 인증바로 카드사 인증
할부개월수선택 리스트 노출요청값으로 바로 결제
용도일반적인 결제 연동간소화된 결제 플로우

주의 사항

상점아이디 속성에 따른 화면 분기

상점아이디가 일반 인증 결제로 설정되어 있는 경우 카드사 인증창이 나타나고, 비인증 또는 구인증으로 설정되어 있는 경우 카드정보 입력창이 나타납니다.
  • 신용카드 빌키(billKey)를 내려받고자 하는 경우, 빌키 서비스를 영업 담당자를 통해 별도 신청해야 합니다.
  • 빌키를 발급받은 경우, 해당 빌키로 2회차 결제 API 요청하면 됩니다. (신용카드 빌키 결제 API 참고)
  • 매출전표의 발행금액은 가맹점에서 전송하는 파라미터를 기준으로 표기됩니다.
    • 예) 과세 가맹점에서 거래금액 1,000원을 전송하는 경우
      • 거래금액만 전송: 과세 909, 부가세 91로 표기
      • 과세금액 900, 부가세금액 100 전송: 과세 900, 부가세 100으로 표기

요청 파라미터

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

필수 파라미터

└mchtIdAN(10)영문+숫자, 최대 10byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
nxca_jt_il: 인증 nxca_jt_bi: 비인증 nxca_ks_gu: 구인증
파라미터
타입
설명
예시
mchtId필수
AN(10)
헥토파이낸셜에서 부여하는 고유 상점아이디
nxca_jt_il: 인증 / nxca_jt_bi: 비인증 / nxca_ks_gu: 구인증
nxca_jt_il
└methodAN(20)영문+숫자, 최대 20byte*PG 서비스에 해당하는 결제 구분 코드
PG 서비스에 해당하는 결제 구분 코드
*고정값
파라미터
타입
설명
예시
method필수
AN(20)
PG 서비스에 해당하는 결제 구분 코드
* 고정값
card
└cardGbAN(4)영문+숫자, 최대 4byte*특정카드사 코드. 직호출 방식에서 특정 카드사 인증창을 호출하기 위한 필수값
특정카드사 코드. 직호출 방식에서 특정 카드사 인증창을 호출하기 위한 필수값
*카드사 코드는 카드사 코드 참조 페이지를 확인하세요.
파라미터
타입
설명
예시
cardGb필수
AN(4)
특정카드사 코드. 직호출 방식에서 특정 카드사 인증창을 호출하기 위한 필수값
* 카드사 코드는 카드사 코드 참조 페이지를 확인하세요.
SSC
└trdDtN(8)숫자, 최대 8byte*요청일자 (yyyyMMdd)
요청일자 (yyyyMMdd)
파라미터
타입
설명
예시
trdDt필수
N(8)
요청일자 (yyyyMMdd)
20211231
└trdTmN(6)숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
파라미터
타입
설명
예시
trdTm필수
N(6)
요청시간 (HH24MISS)
100000
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유 주문번호 (한글 제외)
상점에서 생성하는 고유 주문번호 (한글 제외)
파라미터
타입
설명
예시
mchtTrdNo필수
AN(100)
상점에서 생성하는 고유 주문번호 (한글 제외)
ORDER20211231100000
└mchtNameAHN(100)영문+한글+숫자, 최대 100byte*상점한글명
상점한글명
파라미터
타입
설명
예시
mchtName필수
AHN(100)
상점한글명
헥토파이낸셜
└mchtENameAN(100)영문+숫자, 최대 100byte*상점영문명
상점영문명
파라미터
타입
설명
예시
mchtEName필수
AN(100)
상점영문명
Hecto Financial
└pmtPrdtNmAHN(128)영문+한글+숫자, 최대 128byte*결제상품명
결제상품명
파라미터
타입
설명
예시
pmtPrdtNm필수
AHN(128)
결제상품명
테스트상품
└trdAmtN(12)숫자, 최대 12byte*AES-256AES-256/ECB/PKCS5Padding + Base64거래금액 (USD 사용시 100을 곱하여 전달)
거래금액 (USD 사용시 100을 곱하여 전달)
*KRW: 1000 / USD: ex) $1.00 → 100
파라미터
타입
설명
예시
trdAmt필수
N(12)
AES-256
거래금액 (USD 사용시 100을 곱하여 전달)
* KRW: 1000 / USD: ex) $1.00 → 100
1000
└notiUrlAN(250)영문+숫자, 최대 250byte*결제 후 결과 전달되는 페이지의 URL (Server To Server 연동 URL)
결제 후 결과 전달되는 페이지의 URL (Server To Server 연동 URL)
파라미터
타입
설명
예시
notiUrl필수
AN(250)
결제 후 결과 전달되는 페이지의 URL (Server To Server 연동 URL)
https://example.com/notiUrl
└nextUrlAN(250)영문+숫자, 최대 250byte*결제 결과 화면으로 전환되는 URL
결제 결과 화면으로 전환되는 URL
*결제창 내 버튼 클릭 시 리다이렉트 됩니다. outStatCd 값으로 결제 성공(0021)/실패(0031) 여부를 확인하세요.
파라미터
타입
설명
예시
nextUrl필수
AN(250)
결제 결과 화면으로 전환되는 URL
* 결제창 내 버튼 클릭 시 리다이렉트 됩니다. outStatCd 값으로 결제 성공(0021)/실패(0031) 여부를 확인하세요.
https://example.com/nextUrl
└cancUrlAN(250)영문+숫자, 최대 250byte*고객이 결제창의 X 버튼 클릭 시 리다이렉트 되는 URL
고객이 결제창의 X 버튼 클릭 시 리다이렉트 되는 URL
*브라우저 종료, 뒤로가기 등은 감지되지 않습니다.
파라미터
타입
설명
예시
cancUrl필수
AN(250)
고객이 결제창의 X 버튼 클릭 시 리다이렉트 되는 URL
* 브라우저 종료, 뒤로가기 등은 감지되지 않습니다.
https://example.com/cancUrl
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)
SHA256 방식으로 생성한 해쉬값
파라미터
타입
설명
예시
pktHash필수
AN(200)
SHA-256
SHA256 방식으로 생성한 해쉬값
-
NOTE

해쉬 생성 조합

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

선택 파라미터

└mchtCustNmAHN(30)영문+한글+숫자, 최대 30byteAES-256AES-256/ECB/PKCS5Padding + Base64고객명
고객명
파라미터
타입
설명
예시
mchtCustNm
AHN(30)
AES-256
고객명
홍길동
└mchtParamAHN(4000)영문+한글+숫자, 최대 4000byte기타 주문 정보를 입력하는 상점 예약 필드
기타 주문 정보를 입력하는 상점 예약 필드
파라미터
타입
설명
예시
mchtParam
AHN(4000)
기타 주문 정보를 입력하는 상점 예약 필드
name=HongGilDong&age=25
└emailAN(60)영문+숫자, 최대 60byteAES-256AES-256/ECB/PKCS5Padding + Base64이메일 주소
이메일 주소
파라미터
타입
설명
예시
email
AN(60)
AES-256
이메일 주소
HongGilDong@example.com
└prdtTermN(14)숫자, 최대 14byte상품제공기간 (yyyyMMddHHmmss). 값이 없으면 일반결제로 표기
상품제공기간 (yyyyMMddHHmmss). 값이 없으면 일반결제로 표기
파라미터
타입
설명
예시
prdtTerm
N(14)
상품제공기간 (yyyyMMddHHmmss). 값이 없으면 일반결제로 표기
20221231235959
└mchtCustIdAN(50)영문+숫자, 최대 50byteAES-256AES-256/ECB/PKCS5Padding + Base64상점에서 보내주는 고유 고객아이디 혹은 유니크키
상점에서 보내주는 고유 고객아이디 혹은 유니크키
파라미터
타입
설명
예시
mchtCustId
AN(50)
AES-256
상점에서 보내주는 고유 고객아이디 혹은 유니크키
HongGilDong
└taxTypeCdA(1)영문, 최대 1byte면세여부. 공백일 경우 상점 설정에 따름
면세여부. 공백일 경우 상점 설정에 따름
N: 과세 Y: 면세 G: 복합과세
파라미터
타입
설명
예시
taxTypeCd
A(1)
면세여부. 공백일 경우 상점 설정에 따름
N: 과세 / Y: 면세 / G: 복합과세
N
└taxAmtN(12)숫자, 최대 12byteAES-256AES-256/ECB/PKCS5Padding + Base64과세금액 (복합과세일 경우 필수)
과세금액 (복합과세일 경우 필수)
파라미터
타입
설명
예시
taxAmt
N(12)
AES-256
과세금액 (복합과세일 경우 필수)
909
└vatAmtN(12)숫자, 최대 12byteAES-256AES-256/ECB/PKCS5Padding + Base64부가세금액 (복합과세일 경우 필수)
부가세금액 (복합과세일 경우 필수)
파라미터
타입
설명
예시
vatAmt
N(12)
AES-256
부가세금액 (복합과세일 경우 필수)
91
└taxFreeAmtN(12)숫자, 최대 12byteAES-256AES-256/ECB/PKCS5Padding + Base64비과세금액 (복합과세일 경우 필수)
비과세금액 (복합과세일 경우 필수)
파라미터
타입
설명
예시
taxFreeAmt
N(12)
AES-256
비과세금액 (복합과세일 경우 필수)
0
└svcAmtN(12)숫자, 최대 12byteAES-256AES-256/ECB/PKCS5Padding + Base64신용카드 봉사료
신용카드 봉사료
파라미터
타입
설명
예시
svcAmt
N(12)
AES-256
신용카드 봉사료
-
└instmtMonN(2)숫자, 최대 2byte할부개월수. 직호출 방식에서는 요청된 할부 개월 수로 바로 결제 진행
할부개월수. 직호출 방식에서는 요청된 할부 개월 수로 바로 결제 진행
00: 일시불 2~12: 할부개월수
*00: 일시불, 2~12: 할부개월수
파라미터
타입
설명
예시
instmtMon
N(2)
할부개월수. 직호출 방식에서는 요청된 할부 개월 수로 바로 결제 진행
00: 일시불 / 2~12: 할부개월수
* 00: 일시불, 2~12: 할부개월수
00
└cardTypeN(1)숫자, 최대 1byte카드결제타입
카드결제타입
3: 앱카드 전용가능 카드사[신한/삼성/현대/KB/농협/롯데]
파라미터
타입
설명
예시
cardType
N(1)
카드결제타입
3: 앱카드 전용가능 카드사[신한/삼성/현대/KB/농협/롯데]
3
└chainUserIdAN(100)영문+숫자, 최대 100byte현대카드 PayShot ID. 카드사와 직접 제휴계약 진행 후 사용 가능
현대카드 PayShot ID. 카드사와 직접 제휴계약 진행 후 사용 가능
파라미터
타입
설명
예시
chainUserId
AN(100)
현대카드 PayShot ID. 카드사와 직접 제휴계약 진행 후 사용 가능
-
└appSchemeAN(100)영문+숫자, 최대 100byte앱스키마 (AppScheme://~) 형식. 자체앱을 구축하는 경우 사용
앱스키마 (AppScheme://~) 형식. 자체앱을 구축하는 경우 사용
파라미터
타입
설명
예시
appScheme
AN(100)
앱스키마 (AppScheme://~) 형식. 자체앱을 구축하는 경우 사용
PAYAPPNAME://
└custIpAN(15)영문+숫자, 최대 15byte고객 IP주소. 상점 서버의 IP가 아닌, 고객 기기의 IP주소. IPv4 형식으로 입력 (IPv6 불가)
고객 IP주소. 상점 서버의 IP가 아닌, 고객 기기의 IP주소. IPv4 형식으로 입력 (IPv6 불가)
파라미터
타입
설명
예시
custIp
AN(15)
고객 IP주소. 상점 서버의 IP가 아닌, 고객 기기의 IP주소. IPv4 형식으로 입력 (IPv6 불가)
127.0.0.1

응답 파라미터

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

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└mchtIdAN(10)영문+숫자, 최대 10byte*헥토파이낸셜에서 부여하는 고유 상점아이디nxca_jt_il
헥토파이낸셜에서 부여하는 고유 상점아이디
nxca_jt_il: 인증 nxca_jt_bi: 비인증 nxca_ks_gu: 구인증
파라미터
타입
설명
예시
mchtId필수
AN(10)
헥토파이낸셜에서 부여하는 고유 상점아이디
nxca_jt_il: 인증 / nxca_jt_bi: 비인증 / nxca_ks_gu: 구인증
nxca_jt_il
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드 (성공/실패)0021
거래상태코드 (성공/실패)
0021: 성공 0031: 실패
파라미터
타입
설명
예시
outStatCd필수
AN(4)
거래상태코드 (성공/실패)
0021: 성공 / 0031: 실패
0021
└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드. 거래상태가 '0031'일 경우, 상세 코드 전달0000
거절코드. 거래상태가 '0031'일 경우, 상세 코드 전달
*거절 코드 표 참고
파라미터
타입
설명
예시
outRsltCd필수
AN(4)
거절코드. 거래상태가 '0031'일 경우, 상세 코드 전달
* 거절 코드 표 참고
0000
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*결과메세지 (URL Encoding, UTF-8)정상적으로 처리되었습니다.
결과메세지 (URL Encoding, UTF-8)
파라미터
타입
설명
예시
outRsltMsg필수
AHN(200)
결과메세지 (URL Encoding, UTF-8)
정상적으로 처리되었습니다.
└methodAN(20)영문+숫자, 최대 20byte*PG 서비스에 해당하는 결제 구분 코드card
PG 서비스에 해당하는 결제 구분 코드
*고정값
파라미터
타입
설명
예시
method필수
AN(20)
PG 서비스에 해당하는 결제 구분 코드
* 고정값
card
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유 주문번호 (한글 제외)ORDER20211231100000
상점에서 생성하는 고유 주문번호 (한글 제외)
파라미터
타입
설명
예시
mchtTrdNo필수
AN(100)
상점에서 생성하는 고유 주문번호 (한글 제외)
ORDER20211231100000
└mchtCustIdAN(50)영문+숫자, 최대 50byteAES-256AES-256/ECB/PKCS5Padding상점에서 보내주는 고유 고객아이디 혹은 유니크키HongGilDong
상점에서 보내주는 고유 고객아이디 혹은 유니크키
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
파라미터
타입
설명
예시
mchtCustId
AN(50)
AES-256
상점에서 보내주는 고유 고객아이디 혹은 유니크키
* 실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
HongGilDong
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜 거래번호STFP_PGCAnxca_jt_il0211129135810M1494620
헥토파이낸셜 거래번호
파라미터
타입
설명
예시
trdNo필수
AN(40)
헥토파이낸셜 거래번호
STFP_PGCAnxca_jt_il0211129135810M1494620
└trdAmtN(12)숫자, 최대 12byte*AES-256AES-256/ECB/PKCS5Padding거래금액1000
거래금액
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
파라미터
타입
설명
예시
trdAmt필수
N(12)
AES-256
거래금액
* 실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
1000
└mchtParamAHN(4000)영문+한글+숫자, 최대 4000byte요청으로 받은 필드값을 응답으로 Bypassname=HongGilDong&age=25
요청으로 받은 필드값을 응답으로 Bypass
파라미터
타입
설명
예시
mchtParam
AHN(4000)
요청으로 받은 필드값을 응답으로 Bypass
name=HongGilDong&age=25
└authDtN(14)숫자, 최대 14byte결제 승인 일시20211231100000
결제 승인 일시
파라미터
타입
설명
예시
authDt
N(14)
결제 승인 일시
20211231100000
└authNoN(15)숫자, 최대 15byte신용카드 승인 번호30001234
신용카드 승인 번호
파라미터
타입
설명
예시
authNo
N(15)
신용카드 승인 번호
30001234
└intMonN(2)숫자, 최대 2byte신용카드 할부 개월 수00
신용카드 할부 개월 수
파라미터
타입
설명
예시
intMon
N(2)
신용카드 할부 개월 수
00
└fnNmAH(20)영문+한글, 최대 20byte신용카드 카드사명우리카드
신용카드 카드사명
파라미터
타입
설명
예시
fnNm
AH(20)
신용카드 카드사명
우리카드
└fnCdAN(4)영문+숫자, 최대 4byte신용카드 카드사 코드LTC
신용카드 카드사 코드
파라미터
타입
설명
예시
fnCd
AN(4)
신용카드 카드사 코드
LTC
└pointTrdNoAN(40)영문+숫자, 최대 40byte고객이 포인트 결제를 했을 경우 포인트 결제 건 거래번호STFP_PGCAnxca_jt_il0211129135810M1494620
고객이 포인트 결제를 했을 경우 포인트 결제 건 거래번호
파라미터
타입
설명
예시
pointTrdNo
AN(40)
고객이 포인트 결제를 했을 경우 포인트 결제 건 거래번호
STFP_PGCAnxca_jt_il0211129135810M1494620
└pointTrdAmtN(12)숫자, 최대 12byteAES-256AES-256/ECB/PKCS5Padding고객이 포인트 결제를 했을 경우 포인트 결제 금액1000
고객이 포인트 결제를 했을 경우 포인트 결제 금액
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
파라미터
타입
설명
예시
pointTrdAmt
N(12)
AES-256
고객이 포인트 결제를 했을 경우 포인트 결제 금액
* 실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
1000
└cardTrdAmtN(12)숫자, 최대 12byteAES-256AES-256/ECB/PKCS5Padding고객이 할인 받은 금액 또는 포인트금액을 제외한 신용카드 결제금액4000
고객이 할인 받은 금액 또는 포인트금액을 제외한 신용카드 결제금액
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
파라미터
타입
설명
예시
cardTrdAmt
N(12)
AES-256
고객이 할인 받은 금액 또는 포인트금액을 제외한 신용카드 결제금액
* 실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
4000
└billKeyAN(50)영문+숫자, 최대 50byte*빌키 서비스 이용시 발급되는 자동결제키. 2회차 결제 시 사용SBILL_0123456789
빌키 서비스 이용시 발급되는 자동결제키. 2회차 결제 시 사용
*영업 담당자를 통해 별도 신청 필요
파라미터
타입
설명
예시
billKey필수
AN(50)
빌키 서비스 이용시 발급되는 자동결제키. 2회차 결제 시 사용
* 영업 담당자를 통해 별도 신청 필요
SBILL_0123456789

노티 전문 (결과통보)

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

NOTE

노티 전문 확인

신용카드 결제 결과통보 파라미터와 처리 방법은 노티 전문 문서를 참고하세요.
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub
API 테스트