IAiamport
receipts

현금영수증 단건발급 API

포트원을 통해 발생된 현금성 거래<b>(가상계좌, 계좌이체)</b>의 포트원 거래고유번호(imp_uid)를 기준으로 현금영수증이 발급 됩니다.<br> imp_uid 거래를 처리하는데 사용된 PG설정값을 그대로 활용합니다.<br> (ex. KCP 거래건이면 KCP를 통해 현금영수증 발행 API처리)<br> 현금영수증 발급 금액은 현금성 거래의 금액으로 자동 적용됩니다. 부분취소된 거래인 경우 남은 잔액으로 발급됩니다.<br><br> <h4>지원되는 PG사</h4> <ul> <li>KG 이니시스</li> <li>NHN KCP</li> <li>나이스페이먼츠</li> <li>KICC</li> <li>헥토파이낸셜(구 세틀뱅크)</li> <li>키움페이(구 다우, 페이조아)</li> <li>토스페이먼츠 - 신모듈</li> <li>KSNET</li> <li>스마트로 - 신모듈</li><li>(신) 나이스페이</li><li>웰컴페이먼츠</li></ul>

post/receipts/{imp_uid}

Request

Path parameters

imp_uidstring required

포트원 거래 고유번호

Request body application/x-www-form-urlencoded

product_type'real' | 'digital'

현금영수증 발행 주문 상품구분<br>(필수 : KSNET) <ul><li>real: 실물상품 </li><li>digital: 디지털컨텐츠</li></ul>

identifierstring required

현금영수증 발행대상 식별정보. <br> 국세청현금영수증카드, 휴대폰번호, 주민등록번호, 사업자등록번호를 기재합니다.

identifier_type'person' | 'business' | 'phone' | 'taxcard'

현금영수증 식별정보 구분코드 <br> (필수 : KICC, 헥토파이낸셜(구 세틀뱅크))<br> KG이니시스/NHN KCP/나이스페이먼츠/키움페이(구 다우, 페이조아), 웰컴페이먼츠는 identifier 만으로 자동 처리<br><br> <ul><li>person : 주민등록번호 </li><li> business : 사업자등록번호 </li><li> phone : 휴대폰번호 </li><li> taxcard : 국세청현금영수증카드</li></ul>

type'person' | 'company'

현금영수증 발행 타입(대상). <ul><li>소득공제용(개인) : person </li><li>지출증빙용(법인) : company </li><li>기본값 : person</li></ul>

company_telstring

발행 상점 고객센터 번호 <br> (필수 : 키움페이(구 다우, 페이조아))

company_namestring

상점 사업자 명 <br> (필수 : 키움페이(구 다우, 페이조아))

corp_reg_nostring

상점 사업자 번호 <br> (필수 : 키움페이(구 다우, 페이조아), 웰컴페이먼츠)

buyer_namestring

구매자 이름 <br>(필수 : KSNET, 스마트로 - 신모듈) </br><b>(현금영수증 발행건 사후 추적을 위해 입력을 강력히 권장합니다.)</b>

buyer_emailstring

구매자 Email

buyer_telstring

구매자 전화번호 <br> (필수 : 스마트로 - 신모듈, 웰컴페이먼츠) <br> <b>(현금영수증 발행건 사후 추적을 위해 입력을 강력히 권장합니다.)</b>

tax_freeinteger

현금영수증 발행금액 중 면세금액<br>지정하지 않으면 0원으로 적용 <br> 발행금액의 1/11 이 부가세로 자동 적용되므로, 부가세금액 조정을 위해서는 tax_free 파라메터를 활용해주세요.

vatinteger

Deprecated 되었으므로 tax_free 파라메터를 사용해주세요.<br>부가세(지정하지 않으면 공급가액의 10%로 자동 적용)

vat_amountnumber

부가세 지정 고객사에 한해 현금영수증 발행 금액 중 부가세 금액으로 부가세를 지정할 수 있습니다.

Response

현금영수증 발행 완료

codeinteger

0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다

messagestring

code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다

Changes

No recorded changes to this operation across all 1 revision of this API.