Initiate a Stripe payment for an invoice

Start a Stripe payment process for a specific invoice. This endpoint generates a secure payment link for checkout and returns a requestId for future follow-up.

Headers

Accept Example

Content-Type Example

Body

required

application/json

mode string · enum required

payment

setup

invoiceId string

returnUrl string required

cancelUrl string required

locale string · enum required

en

sv

requestId string

amount any

Responses

200

success boolean

timestamp string

requestId string

data object

POST https://cloud.hostup.se/api/billing/stripe-checkout

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/billing/stripe-checkout" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "payment",
    "invoiceId": "string",
    "returnUrl": "string",
    "cancelUrl": "string",
    "locale": "en",
    "requestId": "string",
    "amount": null
  }'

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "sessionId": "string",
    "sessionUrl": "string",
    "paymentType": "string"
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "sessionId": {
          "type": "string"
        },
        "sessionUrl": {
          "type": "string"
        },
        "paymentType": {
          "type": "string"
        }
      }
    }
  }
}

Request Body

{
  "mode": "payment",
  "invoiceId": "string",
  "returnUrl": "string",
  "cancelUrl": "string",
  "locale": "en",
  "requestId": "string",
  "amount": null
}