Create Subscription

POST

/api/public/v1/subscription/create

Creates Lightning invoice for new subscription.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://tunnelsats.com/api/public/v1/subscription/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "serverId": "eu-de",
    "duration": 1,
    "referralCode": null
}'

Response Example

{
    "success": true,
    "orderId": "order-abc123",
    "paymentHash": "a1b2c3d4e5f6...",
    "invoice": "lnbc10u1p3...",
    "amount_sats": 1000,
    "description": "TunnelSats VPN - 1 month (eu-de)",
    "expiresAt": "2026-01-01T10:30:00.000Z"
}

Modified at 2026-02-10 21:55:30

List Servers

Check Status / Heal