Create New Business Invoice

This endpoint creates a new business invoice under merchant's account.

POST/api/invoices/v1/businessAuth: Required

Request Body

invoiceCurrencystringRequired

Invoice items price currency. Can be eur, usd, or crypto assets (usdt, usdc, btc, eth, ton, sol, bnb, bch, ltc, trx).

itemsarrayRequired

List of invoice items. Each item should contain description and price.

invoiceNumberstringRequired

Invoice legal number. Can contain any symbols, should be unique per business invoice.

sellerobjectRequired

Seller's legal info block.

buyerobjectRequired

Buyer's legal info block.

More attributes

POST/api/invoices/v1/business

curl --location 'https://my.paidlys.com/api/invoices/v1/business' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_PUBLIC_TOKEN' \
  --data-raw '{
    "invoiceCurrency": "eur",
    "items": [
        {
            "description": "Product 1",
            "price": 100.50
        },
        {
            "description": "Product 2",
            "price": 1.00
        }
    ],
    "isMerchantPaysFee": true,
    "paymentCurrency": "usdt",
    "invoiceNumber": "INV-123",
    "seller": {
        "name": "Company Name",
        "address": "123 Business St, City, Country",
        "phone": "+1234567890",
        "taxId": "TAX123456"
    },
    "buyer": {
        "name": "Customer Name",
        "email": "customer@example.com",
        "address": "456 Customer Ave, City, Country",
        "phone": "+0987654321",
        "taxId": "CUST789012"
    },
    "taxes": [
        {
            "name": "VAT",
            "amount": 21.00
        }
    ],
    "notesToBuyer": "Thank you for your business!",
    "internalNotes": "Internal notes for accounting",
    "issueDate": "2024-01-15",
    "dueDate": "2024-02-15",
    "redirectURL": "https://google.com"
  }'

Response

idstring

Invoice identifier. Open on frontend: https://pay.my.paidlys.com/%invoice_id%.

statusstring

Current invoice state (see Invoice Statuses).

createdAtstring

Invoice creation date and time.

typestring

regular, unlimited, or Business.

companyobject

Merchant's company info: name, logoUrl, assets.

invoiceContentobject

Items list, prices, invoiceCurrency, paymentCurrency, isMerchantPaysFee.

invoiceNumberstring

Invoice legal number.

sellerobject

Seller info block.

buyerobject

Buyer info block.

taxesarray

Invoice taxes.

notesToBuyerstring

Notes for the client during invoice processing.

internalNotesstring

Internal notes for the merchant on Invoices detail page.

issueDatestring

Invoice legal issue date.

dueDatestring

Invoice legal expiration date.

redirectURLstring

Redirect URL after "Done" status.

EXAMPLE RESPONSE

{
    "id": "%invoice_id%",
    "status": "created",
    "createdAt": "2026-02-16T13:23:26.816Z",
    "type": "Business",
    "company": {
        "name": "%company_name%",
        "logoUrl": "%logo_url%",
        "assets": [
            { "asset": "btc", "isAllowed": false },
            { "asset": "eth", "isAllowed": true },
            { "asset": "usdt", "isAllowed": true },
            { "asset": "sol", "isAllowed": true },
            { "asset": "ton", "isAllowed": true },
            { "asset": "usdc", "isAllowed": true },
            { "asset": "bnb", "isAllowed": false },
            { "asset": "ltc", "isAllowed": false },
            { "asset": "near", "isAllowed": false },
            { "asset": "trx", "isAllowed": false },
            { "asset": "bch", "isAllowed": false }
        ]
    },
    "invoiceContent": {
        "invoiceCurrency": "eur",
        "items": [
            { "name": "Product 1", "price": "1000.5" },
            { "name": "Product 2", "price": "1" }
        ],
        "paymentCurrency": "usdt",
        "isMerchantPaysFee": true
    },
    "invoiceNumber": "INV-123",
    "seller": {
        "name": "Company Name",
        "address": "123 Business St, City, Country",
        "phone": "+1234567890",
        "taxId": "TAX123456"
    },
    "buyer": {
        "name": "Customer Name",
        "email": "customer@example.com",
        "address": "456 Customer Ave, City, Country",
        "phone": "+0987654321",
        "taxId": "CUST789012"
    },
    "taxes": [
        { "name": "VAT", "amount": 21 }
    ],
    "notesToBuyer": "Thank you for your business!",
    "internalNotes": "Internal notes for accounting",
    "issueDate": "2024-01-15",
    "dueDate": "2024-02-15",
    "redirectURL": "https://google.com"
}