Create a New WireGuard Subscription (Invoice Generation)

POST

/api/public/v1/subscription/create

Generates a Lightning invoice to purchase a 1, 3, 6, or 12-month WireGuard VPN tunnel in a chosen region.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Invoice created successfully

Bodyapplication/json

🟠400Bad Request

🟠429

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://tunnelsats.com/api/public/v1/subscription/create' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--data '{
    "serverId": "us-east",
    "duration": 1,
    "referralCode": "BOOST-123"
}'

Response Example

200 - Example 1

{
    "invoice": "lnbc30000n1p...",
    "paymentHash": "a1b2c3d4e5f6...",
    "amountSats": 12000,
    "amountUsd": "4.00",
    "expiry": "2026-09-01T20:00:00Z"
}

Modified at 2026-08-31 19:53:35

List Available WireGuard Servers & Regions

Claim WireGuard Configuration After Payment Settlement