Quickstart

Some links point to the service guide, which is currently available in Korean only.

Before you begin

Issue a test API key

Create a test key under Developer Center > API Keys.Test keys start with test_, and every issuance request is simulated.

Register the certificate owner with the Register Issuer API. Use the returned issuerId with certificate-management APIs.

Use issuerId with the Retrieve Issuer Certificate Registration URL API, then register the certificate at the returned URL.

In the test environment you can use a test certificate, so you can test your integration even without a real certificate.

Top up credits (for live keys)

To call the API with a live key, you must top up credits in advance. You can top up at the Developer Center; if your credit balance is insufficient, API calls will fail.

Calls made with a test key (test_) are free and require no credit top-up. For detailed pricing, see the Pricing guide.

Your first API call

Once you have a test API key and have registered the issuer’s certificate, issue a tax invoice with the curl command below.

curl -X POST https://xapi.bolta.io/v1/taxInvoices/issue \
  -H "Authorization: Basic $(echo -n 'test_YOUR_API_KEY:' | base64)" \
  -H "Bolta-Client-Reference-Id: quickstart-unique-reference-id" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "YYYY-MM-DD",
    "purpose": "RECEIPT",
    "taxType": "TAXABLE",
    "supplier": {
      "identificationNumber": "1234567890",
      "organizationName": "Supplier Company",
      "representativeName": "Gildong Hong",
      "manager": {
        "email": "supplier@example.com"
      }
    },
    "supplied": {
      "identificationNumber": "0987654321",
      "organizationName": "Recipient Company",
      "representativeName": "Chulsoo Kim",
      "managers": [
        {
          "email": "recipient@example.com",
          "telephone": "010-1234-5678"
        }
      ]
    },
    "items": [
      {
        "date": "YYYY-MM-DD",
        "name": "Test item",
        "unitPrice": 10000,
        "quantity": 1,
        "supplyCost": 10000,
        "tax": 1000
      }
    ]
  }'

If you also include the recipient manager’s mobile phone number, a KakaoTalk notification (AlimTalk) announcing the tax invoice is sent.

Replace test_YOUR_API_KEY and both YYYY-MM-DD placeholders with real values before sending the request. Replace quickstart-unique-reference-id with a value that has not been used for another tax invoice request. Both date fields must be within the issuance deadline. The example identificationNumber values are placeholders that fail the checksum. Replace them with real business registration numbers.

Check the response

If the issuance request succeeds, an issuanceKey is returned.

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}

If you do not receive a response, do not resend the request. Use quickstart-unique-reference-id from the example with the client reference status API to check whether the request was accepted. Afterwards, a webhook sends an issuance-complete notification, and you can check the result with the Retrieve Tax Invoice API.

Next steps

Authentication guide

Learn more about API key authentication and request headers.

Calculating the issuance amount

See how per-item amounts are calculated, with examples.

Use cases

Explore scenarios such as B2B transactions, recurring billing, and reverse issuance.

API Reference

Explore the full API endpoint reference.

API Introduction

API Guides

Use Cases

SDK / No-code

Before you begin

Your first API call

Check the response

Next steps

Authentication guide

Calculating the issuance amount

Use cases

API Reference

​Before you begin

​Your first API call

​Check the response

​Next steps

Authentication guide

Calculating the issuance amount

Use cases

API Reference

Before you begin

Your first API call

Check the response

Next steps