현금영수증 발행

현금영수증 단독 발행 API 입니다.

요청

요청 URL

POST https://{API 도메인}/directapi/trades/directCashReceiptApproval
Content-type: application/json; charset=utf-8

참고

API 멱등성 지원 대상 (API 멱등성 참조)

주의사항

최종 발행이 완료되기까지 시간이 걸리므로 timeout을 30초로 설정해야 합니다.

파라미터

필드명	타입	길이	필수여부	설명
directCashReceiptnfo	Object		✅	현금영수증 발행정보(아래 refundInfo 참조)

directCashReceiptnfo(현금영수증 발행정보)

필드명	타입	길이	필수여부	설명
mallId	String	8Byte	✅	KICC에서 부여한 상점ID
shopTransactionId	String	60Byte	✅	상점 거래고유번호 (API 멱등성 키)
shopReqDate	String	8Byte	✅	등록요청 일자(yyyyMMdd)
shopOrderNo	String	40Byte	✅	상점 주문번호
goodsName	String	50Byte		상품명
amount	Number		✅	총 결제금액
serviceAmount	Number		✅	봉사료
vatAmount	Number		✅	부가세
customerName	String	20Byte		고객명
customerMail	String	20Byte		고객메일
issueType	String	2Byte	✅	현금영수증 발행용도 "01": 소득공제 "02": 지출증빙 "03": 자진발급 "0100001234"로 요청
authType	String	50Byte	✅	인증구분 "01": 신용카드, "03":휴대폰번호, "04": 사업자번호, "05": 현금영수증 전용카드
authValue	String	50Byte	✅	인증번호(숫자만 허용) 자진발급 요청 시 "0100001234"
subMallUsed	String	50Byte		하위 상점 사용여부 "1": 사용, "0": 미사용
subMallBuss	String	50Byte		하위 상점 사업자번호(숫자만 허용)
taxFlg	Number	4Byte		복합과세 사용 시 “TG01”로 설정
taxAmount	Number			과세금액(복합과세 요청 시 필수)
freeAmount	Number			비과세금액(복합과세 요청 시 필수)

요청 예시

{  
    "directCashReceiptnfo": {
      "mallId": "{상점ID}", 
      "shopReqDate": "20251010",
      "shopTransactionId": "{API 멱등성 키}", 
      "shopOrderNo": "{상점 주문번호}",
      "amount": 5000,
      "serviceAmount": 0,
      "vatAmount": 0,
      "issueType": "03",
      "authType": "03",
      "authValue": "0100001234",
      "subMallUsed": "0"
    }
}

응답

파라미터

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지
shopTransactionId	String	60Byte	전송한 값 그대로 사용
mallId	String	8Byte	KICC에서 부여한 상점ID
shopOrderNo	String	40Byte	전송한 값 그대로 사용
pgCno	String	20Byte	PG 거래고유번호 발행취소 시 필수필들 입니다.
amount	Number		총 결제금액
approvalNo	String	50Byte	현금영수증 발행 승인번호
transactionDate	String	14Byte	거래일시(yyyyMMddhhmmss)

요청 예시

{  
  "resCd": "0000", 
  "resMsg": "현금영수증 정상 발급", 
  "mallId": "{상점ID}", 
  "pgCno": "{PG 거래고유번호}", 
  "shopTransactionId": "{요청한 API 멱등성 키}", 
  "shopOrderNo": "{요청한 상점 주문번호}", 
  "amount": 51004, 
  "approvalNo": "20210326090200"
}