Issue Cash Receipt

Cash receipt issuance is asynchronous. The API first returns 202 Accepted and an issuanceKey. Some results are finalized quickly. 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.

POST

cashReceipts

curl --request POST \
  --url https://xapi.bolta.io/v1/cashReceipts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "itemName": "Service fee",
  "issuer": {
    "businessRegistrationNumber": "1234567890",
    "organizationName": "Supplier Company",
    "representativeName": "Jane Doe",
    "telephone": "02-1234-5678"
  },
  "recipient": {
    "type": "PHONE",
    "value": "010-1234-5678"
  },
  "amount": {
    "supplyAmount": 100,
    "vatAmount": 10,
    "taxFreeAmount": 0
  }
}
'

{
  "issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

Authorizations

Authorization

string

header

required

Base64-encode your API key and pass it. Enter the API key as the username and leave the password empty.

Headers

Bolta-Client-Reference-Id

string

required

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

Required string length: 1 - 255

Pattern: \S

Bolta-Webhook-Test-Code

enum<string>

Use 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. Do not use this header in production (live). Cash receipt webhooks

Available options:

INVALID_ISSUER,

INVALID_RECIPIENT_IDENTIFIER,

UNKNOWN

Body

application/json

Cash receipt issuance request body

itemName

string

required

Item name (up to 20 characters)

Required string length: 1 - 20

Example:

"Service fee"

issuer

object

required

Information about the cash receipt supplier.

Show child attributes

recipient

object

required

Recipient information. Set value based on type. For detailed rules, see the Cash receipt guide.

Option 1
Option 2
Option 3

Show child attributes

amount

object

required

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.

Show child attributes

Response

The API accepted the issuance request. Check the final result via webhook or the status API.

issuanceKey

string

required

The cash receipt issuance key. Store the entire string as-is because its format and length may change.

Example:

"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"

curl --request POST \
  --url https://xapi.bolta.io/v1/cashReceipts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "itemName": "Service fee",
  "issuer": {
    "businessRegistrationNumber": "1234567890",
    "organizationName": "Supplier Company",
    "representativeName": "Jane Doe",
    "telephone": "02-1234-5678"
  },
  "recipient": {
    "type": "PHONE",
    "value": "010-1234-5678"
  },
  "amount": {
    "supplyAmount": 100,
    "vatAmount": 10,
    "taxFreeAmount": 0
  }
}
'

{
  "issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "traceId": "<string>"
}

Tax Invoice Issuance

Reverse Issuance

Issuer

Certificate

Tax Invoice Retrieval

Cash Receipt

Issue Cash Receipt

Authorizations

Headers

Body

Response