API Documentation
All API
Service
현금영수증 발행 요청Sync
Version: v1
Version: v1
POST
/api/v1/cash-receipt/approve
선불카드로 발생한 거래 건에 대해서 현금영수증을 발행할 수 있습니다. 현금영수증 거래 건마다 발행이 필요합니다. 소득공제가 완료된 카드로 발생한 거래는 현금영수증을 발행할 수 없습니다.
Request Headers
Request Parameters
Encrypted|
Check out
Guidelines
for more information.Response Headers
X-KM-Correlation-Id
string
Required
Length : 20
Transaction number for tracking trasncription
- Form : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7digit, Hex String
X-KM-Crypto-Key-Id
string
Optional
Length : 32
Data encryption/decryption key ID
- Given ID from creating the service provider's project
- If it is passed as a callback, the first key issued among the keys issued to the service provider is used.
Response Parameters
Encrypted|
Check out
Guidelines
for more information.resultCode
string
Required
Length : 4
| 응답코드 | 응답 메세지 |
| 0000 | 정상 응답 |
| 9960 | 기관코드값이 미입력 |
| 9962 | 거래일시값이 미입력 |
| 9963 | 거래일시값이 오입력 |
| 9964 | 전문일련번호값이 미입력 |
| 9965 | 전문일련번호값이 오입력 |
| 9979 | 내부 서버오류 |
| 9980 | 내부 통신오류 |
| 9985 | SECR_KEY 미입력. |
| 9986 | REQ_DATA 값이 미입력 되었습니다. |
| 9987 | KEY 값이 미입력 되었습니다. |
| 9988 | KEY 값이 올바르지 않습니다. |
| 9989 | 허용된 아이피가 아닙니다. |
| 9990 | 잘못된 제휴기관코드입니다. |
| 9998 | JSON 파싱 오류( 입력값 JSON 형식인지 확인 필요) |
| A100 | 전문전송일자 오류 당일 거래 아님 |
| A110 | 업체명 오류 |
| A120 | 사업자번호 오류 |
| A130 | 사업자번호 LEN 오류 |
| A140 | 개시일 오류 |
| A150 | 개시일 LEN 오류 |
| A160 | 개시일 포맷 오류 |
| A170 | 개시일 과거일자 오류 |
| A180 | 가맹점등록 마감(23시50분) |
| A190 | 담당자 전화번호 오류 |
| A200 | 담당자 이메일 오류 |
| A210 | 대표자명 오류 |
| A220 | 콜센터 전화번호 오류 |
| A230 | 가맹점 주소 오류 |
| A240 | 미등록 대표기관 |
| A250 | 대표가맹점원장 DB 오류 |
| A260 | 가맹점원장 DB 오류 |
| A270 | 가맹점원장 DB 오류 |
| A280 | 불량사업자 |
| A290 | 불량사업자원장 DB 오류 |
| B100 | 거래일시 오류(2일전 매출자료 등록불가) |
| B110 | 사업자번호 LEN 오류 |
| B120 | 거래일시 LEN 오류 |
| B130 | 거래일시 포맷 오류 |
| B140 | 신분확인 숫자 오류 |
| B150 | 신분확인 오류 |
| B160 | 신분확인 체크 오류 |
| B163 | 수기입력 신분확인 체크 오류 |
| B170 | 거래자구분 오류 |
| B180 | 거래금액합계 불일치 |
| B190 | 거래금액 0원 이하 |
| B200 | 가맹점 상태 오류 |
| B203 | 도서공연비 구분 오류 |
| B210 | 미등록 가맹점 |
| B220 | 불량사업자 |
| B230 | 원승인거래 사업자번호 상이 |
| B240 | 원거래 거래금액 상이 |
| B250 | 원거래 신분확인번호 상이 |
| B260 | 불량사업자 |
| C100 | 사업자번호 LEN 오류 |
| C110 | 거래일시 LEN 오류 |
| C120 | 원승인번호 LEN 오류 |
| C130 | 원승인번호 오류 |
| C140 | 원승인번호 오류 |
| C150 | 거래금액합계 불일치 |
| C160 | 거래금액 0원 이하 |
| C170 | 가맹점 상태 오류 |
| C180 | 미등록 가맹점 |
| C190 | 불량사업자 |
| C200 | 원승인거래 없음 |
| C210 | 원승인거래 사업자번호 상이 |
| C220 | 원승인거래 기관코드 상이 |
| C230 | 원거래 승인상태 오류!! |
| C240 | 취소가능 승인금액 부족 |
| NTS0 | 소비자요청으로 이미 정정된 데이타(88자료) |
| NTS1 | 신분확인정보 자릿수 오류 |
| NTS2 | 카드정보 자릿수 오류 |
| NTS3 | 불량사업자와 거래한 현금결제내역 |
| NTS4 | 매출금액 입력오류(5,000원 미만건) |
| NTS5 | 승인번호 중복 및 오류 |
| NTS6 | 매출일자(D-3) 오류 |
| NTS7 | 가맹점 사업자등록번호 미등록 오류 |
| NTS8 | Layout 오류(Record 항목별 입력 값 오류) |
| NTSA | 삭제요청한 데이타 없음(88자료) |
| NTSB | 사업자번호는 소비자소득공제 불가 |
| NTSC | 취소: 원승인거래 없음 |
| NTSD | 취소: 원승인일자,원승인번호 미입력 |
| NTSG | 취소: 취소금액이 승인금액을 초과 |
resultMessage
string
Required
Length : 50
조회결과 메시지
nrNumber
string
Required
Length : 18
현금 영수증 승인 요청할 결제 번호
transactionSeqNo
string
Required
Length : 12
거래일련번호
approvalNo
string
Required
Length : 9
승인번호
corpNo
string
Required
Length : 10
사업자번호 - 입력 값 그대로
approvalDate
string
Required
Length : 6
거래일자 - 입력 값 그대로
approvalTime
string
Required
Length : 6
거래시간 - 입력 값 그대로
supAmount
string
Required
Length : 9
공급가액 - 입력 값 그대로
vat
string
Required
Length : 9
부가세 - 입력 값 그대로
serviceFee
string
Required
Length : 9
봉사료 - 입력 값 그대로
totalFee
string
Required
Length : 9
거래금액합계(공급가액 + 부가세 + 봉사료)
approvalDiv
string
Required
Length : 1
거래구분 - 입력 값 그대로
idNo
string
Required
Length : 20
신분확인 - 입력 값 그대로
manYn
string
Required
Length : 1
신분확인번호구분 - 입력 값 그대로
Response Code
Detailed classification and addition of error for unseccessful withfrawal
200
Error code
000_000
Message
Success.
Description
성공
Test Data
200 - Success
200 - Success
Loading ...
Request
Loading...
Response
Click Try It!
to start a Request and see the Response here!
User RegisterSearch for Member InformationMember Password Reset and ChangeMember Information ChangeMembership CancellationChecking Log in ID checkActivation of Dormant MemberSearch for Terms and Conditions ListTerms and Conditions Agreement/WithdrawalCI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회Financial Institution List InquiryReal Name Verification for Account holderAuthentication code generation before ARS authentication.Bank account registration via PGSearch for Account Registration StatusBalance Limit Increase(Individual card)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제Microdeposit Verification(1 KRW)Microdeposit Verification CheckApplication for Issuance and Delivery of Prepaid CardCancellation of Card ApplicationReissuance of Prepaid Card (Replacement Issuance)Reissuance & Renewal of Prepaid Card to be ExpiredSearch for Card Delivery StatusSearch for Mobile Card Application Information Linkable to Physical CardPhysical Card RegistrationSearch for CardUnregistered card inquiryModification of the Card’s StateDiscarding a CardBalance Limit Increase(Individual card)Balance Limit Increase(Coporate card)Inquiry of Coporate Card Identification StatusApplying For Income Tax DeductionInquiry of Card Tax Deduction StatusCard-User Mapped InquiryCard Product ID Inquiry주카드 설정카드에 연결된 가상계좌 조회Application for Issuance and Delivery of Debit CardCancellation of Card ApplicationSearch for Card Delivery StatusPhysical Card RegistrationSearch for CardModification of the Card’s StateModification of the Card’s LimitDiscarding a CardApplying For Income Tax DeductionInquiry of Card Tax Deduction Status주카드 설정Issuance of Disposable TokenChargeCancellation of ChargeChecking Result of Charge & Cancellation of ChargeChecking Transaction History기준 하한 및 월정액 자동 충전 활성화기준 하한 자동 충전 등록기준 하한 및 월정액 자동 충전 목록 조회기준 하한 자동 충전 수정월 정액 자동 충전 등록월 정액 자동 충전 수정기준 하한 및 월정액 자동 충전 등록 해제결제 시 자동 충전 등록결제 시 자동 충전 등록 해제결제 시 자동 충전 목록 조회Issuance of Disposable TokenSearch for Refund FeeRefundChecking Refund ResultSystem RechargingSystem Recharging CancelSystem RefundSystem Partial Refund신용카드 충전 거래 생성신용카드 충전 취소 요청편의점 충전/출금 요청Deposit Transaction InquiryDeposit Balance InquiryIssuance of Disposable TokenPaymentCancellation of PaymentNetwork Cancellation of Payment Checking Transaction HistoryChecking History of Point TransactionSearch for CardReservations & Cancellations of Point UseChecking History of Point Transaction관리자 포인트 지급관리자 포인트 환수Stamp card accumulation history inquiryCheck the list of stamp cards held by memberInquiry the list of mileage cards owned by member.Mileage card accumulation history inquiryTransfer to CardTransfer to Card ReceivingCard Transfer RejectionCard Transfer CancellationIssuance of Disposable Token for ATMATM Withdrawal ReservationATM Withdrawal Reservation CancelATM withdrawal information inquiry선불카드 선물하기선불카드 선물하기 취소선불카드 선물하기 유효성 검증선불카드 선물하기 수락선불카드 선물하기 거절받은 카드/쿠폰 선물 목록 조회보낸 카드/쿠폰 선물 목록 조회카드 선물 수락 V2카드 선물하기 V2Transfer card balanceBalance Transfer Card Information Inquiry현금영수증 발행 요청현금영수증 발행 취소현금영수증 국세청 승인오류 요청현금영수증 식별 정보 등록현금영수증 식별 정보 조회현금영수증 식별 정보 삭제현금영수증 가맹점 등록현금영수증 가맹점 수정Creation of merchant groupsMerchant Group ModifyMerchant Group InquiryMerchant Information InquiryAdding merchants to merchant groupsMerchant removal from merchant groups신용카드 자동충전 설정(기준 하한)신용카드 자동충전 설정(월정액)신용카드 자동충전 활성화신용카드 자동충전 목록 조회신용카드 자동충전 설정 해제신용카드 자동 충전 설정 변경카드 상품 전체 조회 (관리자용)카드 상품 상세 조회 (관리자용)발급 카드 목록 조회 (관리자용)카드 상품 생성 API (관리자용)카드 선물 내역 조회 (관리자용)
