Skip to main content
POST

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

​
Supplier-Key
string
required

Enter the supplierKey from the supplier registration API (POST /v1/suppliers). The request body issuer.businessRegistrationNumber must match the business registration number linked to this key. Glossary | Authentication guide

​
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 you retry with the same value and an identical request, the API returns the existing result. If the request content or type differs, the API returns 409 Conflict. To check the status later, pass this value as clientReferenceId. Authentication guide

​
Bolta-Webhook-Test-Code
enum<string>

Use this header only to reproduce a failure webhook with a test key. Enter a failure code, and the API sends the corresponding failure webhook. Do not use this header in production (live). Webhook events

Available options:
INVALID_ISSUER,
INVALID_RECIPIENT_IDENTIFIER,
ORIGINAL_ISSUANCE_FAILED,
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. Set businessRegistrationNumber to the business registration number linked to Supplier-Key.

​
recipient
object
required

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

​
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.

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"