admin

`POST /admin/identities/{email}/subscription`: record the billed truth for an identity's subscription. Operator-only, written by the Stripe webhook; idempotent per Stripe event id.

post/admin/identities/{email}/subscription

Request

  • Base URL: https://api.mapmap.ai
  • URL: https://api.mapmap.ai/admin/identities/{email}/subscription
  • Auth: HTTP bearer

Path parameters

emailstring required

Identity email

Request body

billed_penceinteger required

What the last invoice collected, in minor units (pence).

billing_intervalstring required

Billing interval as Stripe names it: month, year.

currencystring required

ISO currency, lowercase (gbp).

current_period_endstring nullable

RFC 3339 end of the paid period, when known.

reasonstring required

Idempotency reason, the Stripe EVENT id (stripe-evt:evt_…), unique per delivery and identical across retries of it.

statusstring required

Lifecycle status as Stripe reports it: active, trialing, past_due, unpaid, canceled …

stripe_subscription_idstring required

The Stripe subscription (sub_…).

Response

Recorded (or an idempotent replay)

billed_penceinteger required
duplicateboolean required
emailstring required
statusstring required

Changes

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