⌨️현금영수증 단건발급 API

현금영수증을 발급할 수 있습니다.

Deprecated

이 문서는 더 이상 관리되지 않습니다.

PortOne 개발자센터를 이용해주세요.

현금영수증을 발급할 수 있습니다.

포트원을 통해 발생된 현금성 거래(가상계좌,게좌이체)의 포트원 거래번호(imp_uid)를 기준으로 현금영수증이 발급 됩니다. 현금영수증 발급 금액은 현금성 거래의 금액으로 자동 적용됩니다. 부분취소된 거래인 경우 남은 잔액으로 발급됩니다.

지원되는 PG사 확인하기

• KG 이니시스

• NHN KCP

• Settle Bank

• NICE Payments

• PayJoa(다우)

• KICC

• 헥토파이낸셜

• 케이에스넷

• 스마트로 - 신모듈

• 토스페이먼츠 - 신모듈

현금거래에 대한 현금영수증을 발급합니다.

POST https://api.iamport.kr/receipts/{imp_uid}

현금영수증 발행을 처리하는 포트원 API 입니다.

Path Parameters

Name	Type	Description
imp_uid*	String	포트원 거래번호

Request Body

Name	Type	Description
product_type*	String	현금영수증 발행대상 식별정보
identifier*	String	현금영수증 발행대상 식별정보
identifier_type	String	현금영수증 식별정보 구분코드 person : 주민등록번호 business : 사업자등록번호 phone : 휴대폰번호 taxcard : 국세청현금영수증카드
type	String	현금영수증 발행 구분코드 소득공제용(개인) : person 지출증빙용(법인) : company 기본값 : person
company_tel	String	발행 상점 고객센터 번호 (페이조아인 경우만 필수)
company_name	String	상점 사업자 명 (페이조아인 경우만 필수)
corp_reg_no	String	상점 사업자 번호 (페이조아인 경우만 필수)
buyer_name	String	구매자 이름
buyer_email	String	구매자 Email 주
buyer_tel	String	구매자 전화번호
tax_free	integer	면세금액

200: OK 성공

ReceiptResponse

code * integer

응답코드

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

message * string

응답메세지

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

response (ReceiptAnnotation, optional)

ReceiptAnnotation

imp_uid * string

포트원 거래번호

receipt_tid string

현금영수증 PG사 발행고유번호

apply_num * string

현금영수증 국세청 발행번호

type * string

현금영수증 발행대상 타입

• 개인 : person

• 사업자 : company

amount * integer

현금영수증 발행금액

vat * integer

부가세

receipt_url string

발행된 현금영수증 URL

applied_at * integer

현금영수증 발행시각 UNIX TIMESTAMP

cancelled_at integer

현금영수증 발행취소시각 UNIX TIMESTAMP

400: Bad Request 필수 파라미터가 누락된 경우, 결제완료(paid)가 아닌 결제 건에 대해 발행요청한 경우, 이미 현금영수증 발행된 건에 대해 요청한 경우

{
    // Response
}

401: Unauthorized 인증 Token이 전달되지 않았거나 유효하지 않은 경우

{
    // Response
}

500: Internal Server Error 현금영수증 발행에 실패한 경우

{
    // Response
}

주요 요청 파라미터 상세 설명

identifier * string

현금영수증 식별정보 구분코드

국세청현금영수증카드, 휴대폰번호, 주민등록번호, 사업자등록번호 를 기재합니다.

identifier_type * string

현금영수증 식별정보 구분코드

KICC, 세틀뱅크인 경우에만 필수

KG이니시스/NHN KCP/나이스페이먼츠/페이조아는 identifier 만으로 자동 처리

Response Model Schema

{
  "code": 0,
  "message": "string",
  "response": {
    "imp_uid": "string",
    "receipt_tid": "string",
    "apply_num": "string",
    "type": "person",
    "amount": 0,
    "vat": 0,
    "receipt_url": "string",
    "applied_at": 0,
    "cancelled_at": 0
 }
}

Swagger Test Link

https://api.iamport.kr/#!/receipts/issueReceipt