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 processed virtually.

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 the supplier’s supplierKey, 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 "Supplier-Key: YOUR_SUPPLIER_KEY" \
  -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, YOUR_SUPPLIER_KEY, and both YYYY-MM-DD placeholders with real values before sending the request. Supplier-Key takes the supplierKey of the supplier (issuer) itself that issues the tax invoice. The recipient (supplied party) information goes in the supplied field of the request body. Both date fields must be within the issuance deadline; if you are unsure, try today’s date.

Check the response

If the issuance request succeeds, an issuanceKey is returned.

{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}

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