AlphaCount Developers
API referenceRevenue share

Report revenue paid elsewhere

POST
/revenue-events

Revenue AlphaCount does not book itself — paid outside its invoices and outside a connected Stripe account. Idempotent by (source, external_ref): a repeat answers 200 with the first event. Do not report revenue AlphaCount sees already; it would count twice. A refund is a negative event with reverses_ref. Scope partner:revenue:write.

Authorization

apiKey partner:revenue:write
headerAuthorizationBearer <ab_…>

An API key from Integrations → Connect AI assistants (MCP) → New access, bound to exactly one company. Each operation names the scope the key must carry.

Scope: partner:revenue:write

Header Parameters

AlphaCount-Version?string

The API version to use. Default: the current one.

Request Body

application/json
  1. body

POST /revenue-events — revenue AlphaCount cannot see itself (paid elsewhere). Idempotent by (source, external_ref). Negative with reverses_ref for a refund of an earlier event.

currency?Currency
Default"EUR"
customer*
external_ref*External Ref
Match^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,254}$
lines?array<>|null
net_amount*Net Amount
Match^-?\d{1,9}(\.\d{1,2})?$
paid_at*Paid At
Formatdate
partner_ref?|null
reverses_ref?|null
service_period*
source*Source
Match^[a-z0-9][a-z0-9_-]{0,49}$

Response Body

OK

application/json
  1. response
customer_id*string|null
id*Id
net_cents*Net Cents
paid_at*Paid At
Formatdate
processed*Processed

Shares computed already.

service_period_start*Service Period Start
Formatdate
source_id*Source Id
Example Request
curl -X POST 'https://app.alphacount.ai/api/partner/v1/revenue-events' \  -H 'Authorization: Bearer ab_...' \  -H 'Content-Type: application/json' \  -d '{  "customer": {    "external_ref": "org-3",    "source": "alphalearn"  },  "external_ref": "pay-77",  "net_amount": "200.00",  "paid_at": "2026-03-05",  "service_period": {    "end": "2026-03-31",    "start": "2026-03-01"  },  "source": "alphalearn"}'
Example Response
{  "customer_id": "00000000-0000-4000-8000-000000000002",  "id": "00000000-0000-4000-8000-000000000001",  "net_cents": 20000,  "paid_at": "2026-03-05",  "processed": true,  "service_period_start": "2026-03-01",  "source_id": "alphalearn:pay-77"}