Issue Cash Receipt

This API is used to issue a cash receipt independently (Standalone Issuance) without an underlying payment transaction.

Request

Request URL

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

Note

Supports API Idempotency (See API Idempotency)

Caution

Since the final issuance process takes time, you must set the timeout to 30 seconds.

Parameters

Field Name	Type	Length	Required	Description
directCashReceiptnfo	Object		✅	Cash Receipt Info (See directCashReceiptnfo below)

directCashReceiptnfo (Cash Receipt Info)

Field Name	Type	Length	Required	Description
mallId	String	8Byte	✅	Merchant ID assigned by KICC
shopTransactionId	String	60Byte	✅	Merchant Transaction ID (API Idempotency Key)
shopReqDate	String	8Byte	✅	Request Date (yyyyMMdd)
shopOrderNo	String	40Byte	✅	Merchant Order No.
goodsName	String	50Byte		Product Name
amount	Number		✅	Total Amount
serviceAmount	Number		✅	Service Fee
vatAmount	Number		✅	VAT
customerName	String	20Byte		Customer Name
customerMail	String	20Byte		Customer Email
issueType	String	2Byte	✅	Issue Purpose "01": Tax Deduction (Individual) "02": Expenditure Proof (Business) "03": Voluntary Issuance (Request with "0100001234")
authType	String	50Byte	✅	Auth Type "01": Credit Card, "03": Mobile No, "04": Biz No, "05": Cash Receipt Card
authValue	String	50Byte	✅	Identity Data (Numbers only) Use "0100001234" for Voluntary Issuance
subMallUsed	String	50Byte		Use Sub-merchant ("1": Yes, "0": No)
subMallBuss	String	50Byte		Sub-merchant Business No. (Numbers only)
taxFlg	Number	4Byte		Complex Tax Flag (Set to “TG01” if used)
taxAmount	Number			Taxable Amount (Required for Complex Tax)
freeAmount	Number			Tax-free Amount (Required for Complex Tax)

Request Example

{  
    "directCashReceiptnfo": {
      "mallId": "{Merchant ID}", 
      "shopReqDate": "20251010",
      "shopTransactionId": "{API Idempotency Key}", 
      "shopOrderNo": "{Merchant Order No}",
      "amount": 5000,
      "serviceAmount": 0,
      "vatAmount": 0,
      "issueType": "03",
      "authType": "03",
      "authValue": "0100001234",
      "subMallUsed": "0"
    }
}

Response

Parameters

Field Name	Type	Length	Required	Description
resCd	String	4Byte	✅	Response Code (Success: “0000”)
resMsg	String	1000Byte	✅	Response Message
shopTransactionId	String	60Byte	✅	Returns the value sent in the request
mallId	String	8Byte		Merchant ID assigned by KICC
shopOrderNo	String	40Byte		Returns the value sent in the request
pgCno	String	20Byte		PG Transaction ID
amount	Number			Total Amount
approvalNo	String	50Byte		Cash Receipt Approval Number
transactionDate	String	14Byte		Transaction Date/Time (yyyyMMddHHmmss)

Response Example

{  
  "resCd": "0000", 
  "resMsg": "Cash Receipt Issued Successfully", 
  "mallId": "{Merchant ID}", 
  "pgCno": "{PG Transaction ID}", 
  "shopTransactionId": "{Requested API Idempotency Key}", 
  "shopOrderNo": "{Requested Merchant Order No}", 
  "amount": 51004, 
  "approvalNo": "20210326090200"
}