Create a custom invoice (admin)

POST

/api/billing/create-custom-invoice

Administrative endpoint that creates a custom invoice with one or more line items for a given payment-provider customer. Authenticated with a platform admin key supplied via the X-Platform-Admin-Key header rather than a tenant API key.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Custom invoice created.

Bodyapplication/json

🟠400

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/billing/create-custom-invoice' \
--header 'X-Platform-Admin-Key;' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "customer_id": "cus_abc123",
    "items": [
        {
            "description": "Konsulenttimer",
            "amount": 1500
        },
        {
            "description": "Tilleggsminutter",
            "amount": 500
        }
    ],
    "currency": "nok"
}'

Response Example

200 - Example 1

{
    "invoice_id": "in_abc123",
    "hosted_invoice_url": "https://invoice.example.com/i/abc123",
    "invoice_pdf": "https://invoice.example.com/i/abc123/pdf",
    "amount_due": 2000,
    "currency": "nok",
    "status": "open"
}

Modified at 2026-07-08 19:01:40

Create a payment link (admin)

Resolve white-label branding for a host