Ascend API

Authentication

For the no-code widget, open Settings → Developer API and copy the ready-made website key. For server-to-server API calls, create a private key and keep it on your server.

Authorization: Bearer ak_live_xxxxxxxxxxxxxxxx

Each key is scoped to one business. To work across businesses, mint a key per business.

Base URL

https://ascendinvoice.com/api/public/v1

Customers

curl https://ascendinvoice.com/api/public/v1/customers \
  -H "Authorization: Bearer ak_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Inc",
    "email": "billing@acme.com",
    "country": "IN"
  }'

curl https://ascendinvoice.com/api/public/v1/customers?limit=50 \
  -H "Authorization: Bearer ak_live_xxx"

Products

curl https://ascendinvoice.com/api/public/v1/products \
  -H "Authorization: Bearer ak_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Consulting hour",
    "unit_price": 5000,
    "default_tax_rate": 18,
    "currency": "INR",
    "type": "service"
  }'

Invoices

curl https://ascendinvoice.com/api/public/v1/invoices \
  -H "Authorization: Bearer ak_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "uuid-from-customers",
    "currency": "INR",
    "due_date": "2026-07-15",
    "status": "sent",
    "items": [
      { "description": "Consulting", "quantity": 4, "unit_price": 5000, "tax_rate": 18 }
    ]
  }'

curl https://ascendinvoice.com/api/public/v1/invoices?status=sent&limit=20 \
  -H "Authorization: Bearer ak_live_xxx"

Webhooks

Add an endpoint URL in Settings → Developer API. We'll POST JSON events with a signature header.

X-Ascend-Signature: t=1719500000,v1=<hex hmac>
X-Ascend-Event: invoice.paid
Content-Type: application/json

{
  "id": "evt_…",
  "type": "invoice.paid",
  "created": 1719500000,
  "data": { "invoice": { ... } }
}

Verify the signature with your endpoint's signing secret:

const [tPart, sigPart] = header.split(",");
const ts = tPart.split("=")[1];
const sig = sigPart.split("=")[1];
const expected = crypto
  .createHmac("sha256", SIGNING_SECRET)
  .update(`${ts}.${rawBody}`)
  .digest("hex");
// timing-safe compare(expected, sig)

Available events: invoice.created, invoice.sent, invoice.paid. Use * to receive all.

No-code connections

Open Settings → Developer API to generate a website key and copy a ready-made payment button, link, or QR code. No custom backend is needed.

For WordPress, paste the script in a Custom HTML block. For Shopify, add it to a Custom Liquid section. For Webflow, add it under Embed. The same snippet works on all three.

<script
  src="https://ascendinvoice.com/api/public/embed/ascend.js"
  data-key="YOUR_WEBSITE_KEY"
  data-amount="50000"
  data-currency="INR"
  data-description="Website design deposit"
  data-button-text="Pay ₹500"
></script>

data-amount is in the smallest currency unit (e.g. paise / cents). The widget opens in a modal, creates an invoice, and emails the customer a branded payment link.

Available data attributes:

data-key          required  Website key from Settings → Developer API
data-amount       required  Amount in smallest currency unit (cents/paise)
data-currency     optional  ISO-3 currency, default USD
data-description  optional  Line item description, default "Payment"
data-button-text  optional  Label on the injected button
data-theme        optional  "light" or "dark"

Errors

{ "error": { "code": "validation_error", "message": "..." } }

HTTP status codes: 200/201 success, 401 bad auth, 404 not found, 422 validation, 500 server error.