헥토파이낸셜 개발자센터
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

국세청 발급 오류 건에 대해 재처리를 등록하는 API입니다.

주의사항

자동재처리 가맹점

  • 영업담당자를 통해 자동재처리 가맹점으로 등록할 수 있습니다.
  • 국세청 오류코드에 따라 헥토파이낸셜에서 자동으로 재처리됩니다.
  • 자동재처리 시 자진발급번호로 발급됩니다.
  • 취소건 재처리는 원승인거래 등록번호로 발급됩니다.

자동재처리 가맹점이 아닌 경우

  • 오류내역 수신 시 재처리 API를 직접 호출해야 합니다.
  • API를 통해 재처리 요청한 거래는 승인번호와 발급일자가 신규 채번됩니다.

발급오류내역의 원거래 값을 사용하세요

reTrDt와 reAuthNo에는 재처리하려는 오류 거래의 발급일자와 승인번호를 입력합니다. 발급오류내역 조회 결과의 거래일시·승인번호와 가맹점에 보관한 원거래 정보를 대조한 뒤 요청하세요.
NOTE

승인번호 채번 기준

자동재처리 건은 발급일자가 국세청 등록 가능 기한(영업일 기준 3일전) 이내이면 최초 발급된 승인번호·발급일자로 재처리되고, 기한 초과 시 신규 채번됩니다. 반면 이 API로 직접 재처리 요청한 거래는 영업일 기준과 관계없이 항상 승인번호·발급일자가 신규 채번됩니다.

취소 재처리 시 주의사항

취소 재처리 시 identityGb, identity는 빈 값으로 전달하면 원거래 정보로 취소됩니다. 부분취소 시에도 동일하게 빈 값으로 전달하고 취소 금액만 계산하여 전달합니다.

API 정보

GET/POST/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo
Content-Type
요청application/x-www-form-urlencoded;charset=UTF-8
응답text/plain;charset=UTF-8
테스트https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo
운영https://cash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo

등록 재처리 요청 파라미터

기본 등록 API 파라미터에 재처리 관련 필드를 추가합니다.

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└midAN(10)영문+숫자, 최대 10byte*상점아이디
상점아이디
*헥토파이낸셜에서 발급받은 가맹점 ID
파라미터
타입
설명
예시
mid필수
AN(10)
상점아이디
* 헥토파이낸셜에서 발급받은 가맹점 ID
mid_test
└assortA(1)영문, 최대 1byte*승인구분
승인구분
0: 승인(등록)
파라미터
타입
설명
예시
assort필수
A(1)
승인구분
0: 승인(등록)
0
└transNoAN(50)영문+숫자, 최대 50byte*주문번호 (가맹점 고유번호)
주문번호 (가맹점 고유번호)
*날짜와 상관없이 동일 고유번호 발생 시 오류처리
파라미터
타입
설명
예시
transNo필수
AN(50)
주문번호 (가맹점 고유번호)
* 날짜와 상관없이 동일 고유번호 발생 시 오류처리
test115
└ordNmAHN(40)영문+한글+숫자, 최대 40byte주문자명
주문자명
*한글 입력 가능. 길이는 글자 수가 아닌 byte 기준입니다.
파라미터
타입
설명
예시
ordNm
AHN(40)
주문자명
* 한글 입력 가능. 길이는 글자 수가 아닌 byte 기준입니다.
테스트
└trDtAN(14)영문+숫자, 최대 14byte*거래일시 (yyyyMMddHHmmss)
거래일시 (yyyyMMddHHmmss)
파라미터
타입
설명
예시
trDt필수
AN(14)
거래일시 (yyyyMMddHHmmss)
20180401001200
└taxYnA(1)영문, 최대 1byte과세구분
과세구분
N: 과세 Y: 면세 G: 복합과세
*N(과세): amt에 과세금액, vat에 부가세 입력
Y(면세): amt에 면세금액, vat는 0 입력
G(복합과세): amt에 과세+면세금액, vat에 과세금액의 부가세 입력(vat 0원도 정상)
미입력(null): amt에 총 거래금액 입력 후 등록된 가맹점 정보 기준으로 자동계산
파라미터
타입
설명
예시
taxYn
A(1)
과세구분
N: 과세 / Y: 면세 / G: 복합과세
* N(과세): amt에 과세금액, vat에 부가세 입력 Y(면세): amt에 면세금액, vat는 0 입력 G(복합과세): amt에 과세+면세금액, vat에 과세금액의 부가세 입력(vat 0원도 정상) 미입력(null): amt에 총 거래금액 입력 후 등록된 가맹점 정보 기준으로 자동계산
N
└amtN(10)숫자, 최대 10byte*공급가액
공급가액
*과세: 과세금액, 면세: 면세금액, 복합과세: 과세+면세금액
파라미터
타입
설명
예시
amt필수
N(10)
공급가액
* 과세: 과세금액, 면세: 면세금액, 복합과세: 과세+면세금액
10000
└vatN(10)숫자, 최대 10byte*부가세
부가세
*과세: 부가세, 면세: 0, 복합과세: 과세금액의 부가세
파라미터
타입
설명
예시
vat필수
N(10)
부가세
* 과세: 부가세, 면세: 0, 복합과세: 과세금액의 부가세
1000
└svcAmtN(10)숫자, 최대 10byte*봉사료
봉사료
파라미터
타입
설명
예시
svcAmt필수
N(10)
봉사료
0
└bizRegNoN(10)숫자, 최대 10byte하위사업자번호
하위사업자번호
파라미터
타입
설명
예시
bizRegNo
N(10)
하위사업자번호
0001112222
└purposeA(1)영문, 최대 1byte*용도구분
용도구분
0: 소득공제 1: 지출증빙
*자진발급번호로 요청 시 0(소득공제)으로 입력
파라미터
타입
설명
예시
purpose필수
A(1)
용도구분
0: 소득공제 / 1: 지출증빙
* 자진발급번호로 요청 시 0(소득공제)으로 입력
0
└identityGbA(1)영문, 최대 1byte*현금영수증 등록번호 구분
현금영수증 등록번호 구분
1: 카드번호 (국세청 등록 카드) 2: 주민번호 3: 사업자번호 4: 휴대전화번호
*자진발급번호로 요청 시 4(휴대전화번호)로 입력
파라미터
타입
설명
예시
identityGb필수
A(1)
현금영수증 등록번호 구분
1: 카드번호 (국세청 등록 카드) / 2: 주민번호 / 3: 사업자번호 / 4: 휴대전화번호
* 자진발급번호로 요청 시 4(휴대전화번호)로 입력
4
└identityN(18)숫자, 최대 18byte*현금영수증 등록번호
현금영수증 등록번호
*identityGb 구분값에 맞는 등록번호 입력
숫자로만 입력
자진발급번호: 0100001234 (10자리, 010-0000-1234의 11자리 번호가 아님)
파라미터
타입
설명
예시
identity필수
N(18)
현금영수증 등록번호
* identityGb 구분값에 맞는 등록번호 입력 숫자로만 입력 자진발급번호: 0100001234 (10자리, 010-0000-1234의 11자리 번호가 아님)
0100001234
└deductionTypeA(1)영문, 최대 1byte추가공제 구분
추가공제 구분
Y: 대중교통 C: 문화비(도서,공연비,체육시설) T: 전통시장 B: 전통시장내 도서공연비
*해당 추가공제 거래에만 입력
문화비 소득공제 제공 단일사업자는 값을 생략해도 문화비로 처리
전통시장/전통시장 내 문화비로 지정한 사업자번호가 국세청에 등록되지 않은 경우 일반 소득공제로 처리
2025/07/01 이후 체육시설 사용료(수영장, 헬스 등)도 문화비(C)에 포함: 강습료 50%, 입장료와 대여료(수건, 운동복) 100% 공제
파라미터
타입
설명
예시
deductionType
A(1)
추가공제 구분
Y: 대중교통 / C: 문화비(도서,공연비,체육시설) / T: 전통시장 / B: 전통시장내 도서공연비
* 해당 추가공제 거래에만 입력 문화비 소득공제 제공 단일사업자는 값을 생략해도 문화비로 처리 전통시장/전통시장 내 문화비로 지정한 사업자번호가 국세청에 등록되지 않은 경우 일반 소득공제로 처리 2025/07/01 이후 체육시설 사용료(수영장, 헬스 등)도 문화비(C)에 포함: 강습료 50%, 입장료와 대여료(수건, 운동복) 100% 공제
-
└reYnA(1)영문, 최대 1byte*재처리여부
재처리여부
Y: 재처리요청
*재처리 요청 시 Y로 고정
파라미터
타입
설명
예시
reYn필수
A(1)
재처리여부
Y: 재처리요청
* 재처리 요청 시 Y로 고정
Y
└reTrDtN(8)숫자, 최대 8byte*재처리 원거래 발급일자 (yyyyMMdd)
재처리 원거래 발급일자 (yyyyMMdd)
*재처리할 오류 거래의 발급일자 입력
파라미터
타입
설명
예시
reTrDt필수
N(8)
재처리 원거래 발급일자 (yyyyMMdd)
* 재처리할 오류 거래의 발급일자 입력
20180401
└reAuthNoAN(9)영문+숫자, 최대 9byte*재처리 원거래 승인번호
재처리 원거래 승인번호
*재처리할 오류 거래의 승인번호 입력
파라미터
타입
설명
예시
reAuthNo필수
AN(9)
재처리 원거래 승인번호
* 재처리할 오류 거래의 승인번호 입력
F62624672

취소 재처리 요청 파라미터

취소건 재처리 시 등록 재처리와 동일한 기본 파라미터에 아래 추가 파라미터를 함께 전송합니다.

└assortA(1)영문, 최대 1byte*승인구분
승인구분
1: 취소
파라미터
타입
설명
예시
assort필수
A(1)
승인구분
1: 취소
1
└authNoAN(9)영문+숫자, 최대 9byte*원거래 승인번호
원거래 승인번호
파라미터
타입
설명
예시
authNo필수
AN(9)
원거래 승인번호
F67198300
└orgTrDtAN(14)영문+숫자, 최대 14byte*원거래 승인일시 (yyyyMMddHHmmss)
원거래 승인일시 (yyyyMMddHHmmss)
파라미터
타입
설명
예시
orgTrDt필수
AN(14)
원거래 승인일시 (yyyyMMddHHmmss)
20210316144106
└reYnA(1)영문, 최대 1byte*재처리여부
재처리여부
Y: 재처리요청
파라미터
타입
설명
예시
reYn필수
A(1)
재처리여부
Y: 재처리요청
Y
└reTrDtN(8)숫자, 최대 8byte*재처리 원거래 발급일자 (yyyyMMdd)
재처리 원거래 발급일자 (yyyyMMdd)
*재처리할 오류 거래의 발급일자 입력
파라미터
타입
설명
예시
reTrDt필수
N(8)
재처리 원거래 발급일자 (yyyyMMdd)
* 재처리할 오류 거래의 발급일자 입력
20210316
└reAuthNoAN(9)영문+숫자, 최대 9byte*재처리 원거래 승인번호
재처리 원거래 승인번호
*재처리할 오류 거래의 승인번호 입력
파라미터
타입
설명
예시
reAuthNo필수
AN(9)
재처리 원거래 승인번호
* 재처리할 오류 거래의 승인번호 입력
F62624672

응답 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└resultCdAN(4)영문+숫자, 최대 4byte*응답코드0000
응답코드
0000: 성공
파라미터
타입
설명
예시
resultCd필수
AN(4)
응답코드
0000: 성공
0000
└resultMsgAHN(100)영문+한글+숫자, 최대 100byte*응답메시지현금영수증 등록이 성공하였습니다.
응답메시지
파라미터
타입
설명
예시
resultMsg필수
AHN(100)
응답메시지
현금영수증 등록이 성공하였습니다.
└trTimeN(14)숫자, 최대 14byte*발급일시20180401001200
발급일시
*등록 재처리는 trDt 값, 취소 재처리는 API 요청일시가 반환됩니다. 가맹점에서 관리해야 합니다.
파라미터
타입
설명
예시
trTime필수
N(14)
발급일시
* 등록 재처리는 trDt 값, 취소 재처리는 API 요청일시가 반환됩니다. 가맹점에서 관리해야 합니다.
20180401001200
└authNoAN(9)영문+숫자, 최대 9byte*승인번호 (신규 채번)F62624676
승인번호 (신규 채번)
*가맹점 관리 필요
파라미터
타입
설명
예시
authNo필수
AN(9)
승인번호 (신규 채번)
* 가맹점 관리 필요
F62624676

등록 재처리 요청 예시

https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo
&mid=mid_test
&assort=0
&transNo=test115
&ordNm=테스트
&trDt=20180401001200
&taxYn=N
&amt=10000
&vat=1000
&svcAmt=0
&bizRegNo=0001112222
&purpose=0
&identityGb=4
&identity=0100001234
&deductionType=
&reYn=Y
&reTrDt=20180401
&reAuthNo=F62624672

취소 재처리 요청 예시

https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo
&mid=mid_test
&assort=1
&transNo=CA20210316144124
&trDt=20210316144124
&taxYn=N
&amt=9090
&vat=910
&svcAmt=0
&purpose=0
&identityGb=
&identity=
&deductionType=
&authNo=F67198300
&orgTrDt=20210316144106
&reYn=Y
&reTrDt=20210316
&reAuthNo=F62624672

응답 예시

성공

{
  "trTime": "20180401001200",
  "resultCd": "0000",
  "authNo": "F62624676",
  "resultMsg": "현금영수증 등록이 성공하였습니다."
}

실패

{
  "trTime": "",
  "resultCd": "1118",
  "authNo": "",
  "resultMsg": "재처리를 위한 원거래 정보가 없습니다."
}

재처리 관련 오류코드

코드메시지설명
1118재처리를 위한 원거래 정보가 없습니다.원거래 없음
1119자동재처리 대상 건입니다.자동재처리 대상
1120이미 재처리 요청된 내역이 있습니다.중복 재처리 요청
1121parameter 확인이 필요합니다.파라미터 오류

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub
API 테스트