영수증(매출전표) 조회 API (인증)
가맹점에서 영수증(매출전표) 조회를 위해 호출하는 API입니다. 호출 결과로 구매 인증 UI 가 제공되며, 구매자가 인증 정보를 입력하면 매출전표를 확인할 수 있습니다.
테스트용 키 정보
API 정보
POST/api/cpnRcptInq.do
Content-Type
application/x-www-form-urlencoded테스트
https://tb-nspay.settlebank.co.kr/api/cpnRcptInq.do운영
https://nspay.settlebank.co.kr/api/cpnRcptInq.do주의 사항
NOTE
구매 인증 매출전표 조회
이 API는 구매 인증 단계가 포함된 매출전표 조회입니다. 호출하면 구매 인증 화면(UI)이 반환되고, 구매자가 구매자명+금액 또는 이메일을 입력해 본인 확인을 거친 뒤 매출전표를 조회합니다. 인증 단계 없이 바로 매출전표를 받으려면 무인증 버전을 사용하세요. 영수증(매출전표) 조회 (무인증) 보기
도메인 주의
이 API는 domain2(tb-nspay / nspay)를 사용합니다.
- 조회하려는 거래의 결제수단(
method)과 헥토파이낸셜 거래번호(trdNo)를 정확히 전달해야 합니다. - 응답은 데이터가 아닌 구매 인증 화면이므로, 브라우저에서 폼 전송(Form Submit) 방식으로 호출합니다.
요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└mchtIdAN(10)영문+숫자, 최대 10byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
└methodAN(2)영문+숫자, 최대 2byte*결제수단
결제수단
CA: 신용카드 RA: 계좌이체 VA: 가상계좌 MP: 휴대폰 TM: 티머니 CG: 문화상품권 SG: 스마트문상 BG: 도서문화상품권 HM: 해피머니 TC: 틴캐시 CP: 포인트 다모아 PZ: 간편결제*조회할 거래의 결제수단 코드. 하단 결제수단 코드 표 참고
└trdDtN(8)숫자, 최대 8byte*거래일자 (yyyyMMdd)
거래일자 (yyyyMMdd)
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜에서 부여하는 고유 거래번호
헥토파이낸셜에서 부여하는 고유 거래번호
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
NOTE
해쉬 생성 조합
mchtId + trdNo + hashKey
응답
요청한 거래의 구매 인증 화면(UI) 이 응답으로 반환됩니다. 구매인증 단계에서 조회하려는 결제건의 구매자명 + 금액 또는 이메일 을 입력하면 영수증(매출전표)을 조회할 수 있습니다. 별도의 데이터 응답 전문은 없습니다.
결제수단 코드
| 코드 | 결제수단 | 코드 | 결제수단 |
|---|---|---|---|
CA | 신용카드 | RA | 계좌이체 |
VA | 가상계좌 | MP | 휴대폰 |
TM | 티머니 | CG | 문화상품권 |
SG | 스마트문상 | BG | 도서문화상품권 |
HM | 해피머니 | TC | 틴캐시 |
CP | 포인트 다모아 | PZ | 간편결제 |
API 테스트