Quickstart

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

Before you begin

Issue a test API key

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

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, use a test certificate instead of a real certificate to test your integration.

Top up points (for live keys)

To call the API with a live key, top up points at the Developer Center first. API calls fail if your balance is insufficient.

A test key (test_) deducts no points. 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, Bolta sends a KakaoTalk notification (AlimTalk) announcing the tax invoice.

Before sending the request, replace test_YOUR_API_KEY, both YYYY-MM-DD placeholders, and both identificationNumber values with real values. The example identificationNumber values fail the checksum. 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. Check the deadline with the Tax Invoice Issuance Deadline API.

Check the response

If the issuance request succeeds, the API returns an issuanceKey.

{
  "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. Bolta then sends an issuance-complete notification by webhook. You can also 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