Issue Cash Receipt
Cash receipt issuance is asynchronous. The API first returns 202 Accepted and an issuanceKey. A request that remains in progress or needs its issuance result confirmed can be finalized after 17:00 KST on the day following the request. Confirm issuance when the status API returns ISSUED or you receive CASH_RECEIPT_ISSUED.
For recipient types (recipient.type), the recipient identifier (recipient.value), and amount and validation rules, see the Cash receipt guide.
Authorizations
Append a colon to your API key, Base64-encode it, and put it in the header. Enter the API key as the username and leave the password empty.
Headers
Enter a client reference ID between 1 and 255 characters. The API uses this value as the idempotency key. If the same API key retries with the same client reference ID, request content, and request type, the API returns 202 Accepted with the existing request's issuanceKey. If the request content or type differs, the API returns 409 Conflict with IDEMPOTENCY_CONFLICT. To check the status later, pass this value as clientReferenceId. Authentication guide
1 - 255\SUse this header only to reproduce an issuance failure webhook with a test key. Enter an issuance failure code, and the API sends the corresponding failure webhook. Cash receipt webhooks
INVALID_ISSUER, INVALID_RECIPIENT_IDENTIFIER, UNKNOWN Body
Cash receipt issuance request body
Item name (up to 20 characters)
1 - 20"Service fee"
Information about the cash receipt supplier.
Recipient information. Set value based on type. For detailed rules, see the Cash receipt guide.
- Option 1
- Option 2
- Option 3
The issuance amount. Each field and the total (supplyAmount + vatAmount + taxFreeAmount) must be no greater than 9,999,999,999, and the total must be greater than 0.
Response
The API accepted the issuance request.
The cash receipt issuance key. Its format and length may change, so store the entire string as is.
"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"