Credit

Purchase credit

POST/v1/billing/credit/purchase

Creates an invoice for a credit purchase of the requested amount.

curl --request POST \
  --url https://api.serverside.com/v1/billing/credit/purchase \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123
}
'

{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2026-01-15T09:30:00Z",
    "dueDate": "2026-01-15T09:30:00Z",
    "status": "UNPAID",
    "type": "STANDARD",
    "currency": "<string>",
    "invoiceNumber": 123,
    "orderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "billedFrom": {
      "name": "<string>",
      "address1": "<string>",
      "address2": "<string>",
      "city": "<string>",
      "region": "<string>",
      "postalCode": "<string>",
      "countryCode": "<string>",
      "vatNumber": "<string>",
      "emailAddress": "<string>",
      "phoneNumber": "<string>"
    },
    "billedTo": {
      "name": "<string>",
      "address1": "<string>",
      "address2": "<string>",
      "city": "<string>",
      "region": "<string>",
      "postalCode": "<string>",
      "countryCode": "<string>",
      "vatNumber": "<string>",
      "emailAddress": "<string>",
      "phoneNumber": "<string>"
    },
    "taxBreakdown": [
      {
        "name": "<string>",
        "rate": 123,
        "amount": 123,
        "taxId": "<string>"
      }
    ],
    "items": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "title": "<string>",
        "subscriptionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "periodStart": "2026-01-15T09:30:00Z",
        "periodEnd": "2026-01-15T09:30:00Z",
        "subtotal": 123,
        "discount": 123,
        "taxTreatment": "STANDARD",
        "taxRate": 123,
        "taxAmount": 123,
        "total": 123
      }
    ],
    "transactions": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "transactionReference": "<string>",
        "amount": 123,
        "currency": "<string>",
        "createdAt": "2026-01-15T09:30:00Z",
        "paymentProvider": "STRIPE",
        "status": "PENDING"
      }
    ],
    "subtotal": 123,
    "discount": 123,
    "taxes": 123,
    "total": 123,
    "amountDue": 123
  }
}

Authorizations

Authorizationstringheaderrequired
Organization API key (org_...), created in the cloud console at https://cloud.serverside.com and shown once, sent as Authorization: Bearer <key>. It authenticates as the organization.

Required permission: organization.billing.pay

Body

application/json

amountinteger<int64>required

Response

201 · application/json

Created

successbooleanrequired
Allowed values:true
dataobject | nullrequired

Authorizations

Body

Response

Footer