IAiamport
receipts

현금영수증 발급(외부) API

포트원과 별개로 거래된 일반 현금결제에 대해, 포트원 내에 설정된 PG사로 현금영수증 발행 요청하는 API입니다.

 <h4>지원되는 PG사</h4>
 <ul> <li>KG이니시스
 </li> <li>NHN KCP
 </li> <li>나이스페이먼츠
 </li> <li>KICC
 </li> <li>헥토파이낸셜(구 세틀뱅크)
 </li> <li>토스페이먼츠 - 신모듈
 </li> <li>KSNET
 </li> <li>스마트로 - 신모듈
 </li><li>(신) 나이스페이
 </li><li>웰컴페이먼츠</li></ul>
post/receipts/external/{merchant_uid}

Request

Path parameters

merchant_uidstring required

현금영수증 발행을 위한 고객사 주문번호 (스마트로 - 신모듈의 경우, 특수문자 포함이 불가능합니다.) <br>고객사 주문번호는 현금거래 주문번호와 동일한 번호를 기재해야 추후 대사가 가능한점 유념하시기 바랍니다.

Request body application/x-www-form-urlencoded

channel_keystring required

현금영수증 발급 시 사용할 채널의 채널키

namestring required

현금영수증 발행 주문명

amountinteger required

현금영수증 발행 금액

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>

buyer_namestring

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

buyer_emailstring

구매자 Email

buyer_telstring

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

tax_freeinteger

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

vat_amountnumber

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

corp_reg_nostring

상점 사업자 번호 <br> (필수 : 웰컴페이먼츠)

pay_method'trans' | 'vbank'

결제건의 결제수단<br> (필수 : 웰컴페이먼츠) <ul><li>trans : 계좌이체 </li><li>vbank : 가상계좌</li></ul>

Response

현금영수증 발행 완료

codeinteger

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

messagestring

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

Changes

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