Partner Provisioning

Create a customer and place an order

Create (or identify) an end customer and place a PENDING order with an UNPAID proforma invoice, in a single call, for partner-allowed products only.

Does not charge or provision anything on its own — the invoice is settled by the end customer via the returned pay_url (or bank transfer), and everything after (invoicing, payment reconciliation, renewals) is handled automatically.

An Idempotency-Key header is REQUIRED — send your own order id; a retry with the same key returns the original result instead of creating a duplicate.

Returns customer_id, customer_created, order_number, status (pending), invoice_id, invoice_number (the proforma), total, currency and pay_url.

post/v1/partner/provision

Request

  • Base URL: https://developers.servera.co.uk
  • URL: https://developers.servera.co.uk/v1/partner/provision
  • Auth: HTTP bearer

Headers

Idempotency-Keystring nullable

Request body

referencestring nullable

Your own order reference (also used as idempotency anchor in notes).

send_emailsboolean

Send the end customer the verification + order emails.

link_if_existsboolean

If a customer with this email already exists in Servera but is not yet owned by this partner, link (adopt) it and place the order instead of returning 409. Use for returning customers who already have a Servera account.

start_datestring nullable

Optional service start date (YYYY-MM-DD) for the whole order. When set, recurring services are billed from this date (registration + next_due anchor here, and the invoice period shows [start_date, start_date+cycle)) instead of the payment date. Must be today or later. Omit to start billing from the payment date.

Example request

{
  "customer": {
    "company_name": "UAB Pavyzdys",
    "company_number": "300000000",
    "country": "LT",
    "email": "klientas@pavyzdys.lt",
    "first_name": "Vardas",
    "language": "lt",
    "last_name": "Pavardė",
    "tax_id": "LT100000000000"
  },
  "items": [
    {
      "billing_cycle": "onetime",
      "product_id": 2872,
      "quantity": 12
    },
    {
      "billing_cycle": "annually",
      "product_id": 2877,
      "quantity": 12
    }
  ],
  "reference": "PO-2026-001",
  "send_emails": true,
  "start_date": "2026-09-27"
}

Response

Successful Response

customer_idinteger required
customer_createdboolean
order_idinteger required
order_numberstring required
status'pending' | 'active' | 'cancelled' | 'refunded' required
invoice_idinteger nullable
invoice_numberstring nullable
totalnumber required
currencystring
pay_urlstring nullable
referencestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.