APIReferenz
Billing API
Generierte OpenAPI-Referenz für die Billing-API-Oberfläche.
Überblick
Billing-Endpoints gehören zur öffentlichen Everyn-API. Organization-scoped human billing reads and owner/admin billing mutations.
Endpunkte
Die generierte OpenAPI-Komponente unten enthält Request-Parameter, Request Bodies, Response Bodies, Statuscodes und Schemas für dieses Tag.
Endpoint-Zusammenfassung für den schnellen Überblick vor der generierten Referenz:
Fehler nutzen die PublicErrorEnvelope-Form mit einem X-Request-Id-Header. Die meisten Endpoints unten liefern 400, 401, 403, 404, 409, 422, 429; die wenigen Abweichungen listen ihre eigenen Statuscodes in der Tabelle, die sonst nur Erfolgs-Responses zeigt. Siehe API-Fehler für Envelope und Recovery-Muster.
| Methode | Pfad | Zusammenfassung | Request Body | Erfolgs-Response |
|---|---|---|---|---|
POST | /v1/billing/stripe/webhooks | Ingest Stripe Billing Webhook | Keine. | 202 KeineFehler: 400, 401, 403, 404, 409, 429. |
GET | /v1/organizations/{organization_id}/billing | Get Billing Overview | Keine. | 200 application/json: BillingOverviewResponse |
GET | /v1/organizations/{organization_id}/billing/cancellation | Discover Agreement Cancellation | Keine. | 200 application/json: CancellationDiscoveryNoneResponse or CancellationDiscoveryFoundResponse |
POST | /v1/organizations/{organization_id}/billing/cancellation | Request Agreement Cancellation | application/json: CancellationRequestBody | 201 application/json: CancellationResponse |
POST | /v1/organizations/{organization_id}/billing/cancellation/{cancellation_id}/withdrawal | Withdraw Agreement Cancellation | application/json: CancellationWithdrawalRequestBody | 200 application/json: CancellationResponse |
GET | /v1/organizations/{organization_id}/billing/history | List Billing History | Keine. | 200 application/json: BillingHistoryListResponse |
GET | /v1/organizations/{organization_id}/billing/history/{history_item_id} | Get Billing History Detail | Keine. | 200 application/json: BillingHistoryDetailResponse |
POST | /v1/organizations/{organization_id}/billing/paid-checkouts | Start Paid Checkout | application/json: PaidCheckoutStartRequestBody | 200 application/json: PaidCheckoutReconciledResponse201 application/json: PaidCheckoutStartResponse202 application/json: PaidCheckoutPreparingResponse |
POST | /v1/organizations/{organization_id}/billing/paid-checkouts/complete-return | Complete Paid Checkout Return | application/json: PaidCheckoutCompleteReturnRequestBody | 200 application/json: PaidCheckoutStatusResponse |
GET | /v1/organizations/{organization_id}/billing/paid-checkouts/{paid_checkout_intent_id} | Get Paid Checkout Status | Keine. | 200 application/json: PaidCheckoutStatusResponse |
POST | /v1/organizations/{organization_id}/billing/payment-method-setups | Start Payment Method Setup | application/json: PaymentMethodSetupStartRequestBody or null | 201 application/json: PaymentMethodSetupStartResponse |
POST | /v1/organizations/{organization_id}/billing/payment-method-setups/complete-return | Complete Payment Method Setup Return | application/json: PaymentMethodSetupCompleteReturnRequestBody | 200 application/json: PaymentSetupStatusResponse |
GET | /v1/organizations/{organization_id}/billing/payment-method-setups/{hosted_setup_intent_id} | Get Payment Method Setup Status | Keine. | 200 application/json: PaymentSetupStatusResponse |
GET | /v1/organizations/{organization_id}/billing/plan-transition | Discover Plan Transition | Keine. | 200 application/json: PlanTransitionDiscoveryNoneResponse or PlanTransitionDiscoveryFoundResponse |
GET | /v1/organizations/{organization_id}/billing/plan-transition-quote | Get Plan Transition Quote | Keine. | 200 application/json: PlanTransitionQuoteResponse |
POST | /v1/organizations/{organization_id}/billing/plan-transitions | Request Plan Transition | application/json: PlanTransitionRequestBody | 201 application/json: PlanTransitionStartResponse |
POST | /v1/organizations/{organization_id}/billing/plan-transitions/complete-return | Complete Plan Transition Return | application/json: PlanTransitionCompleteReturnRequestBody | 200 application/json: PlanTransitionResponse |
GET | /v1/organizations/{organization_id}/billing/plan-transitions/{plan_transition_id} | Get Plan Transition Status | Keine. | 200 application/json: PlanTransitionResponse |
POST | /v1/organizations/{organization_id}/billing/portal-sessions | Start Billing Portal Session | Keine. | 201 application/json: BillingPortalSessionResponse |
GET | /v1/organizations/{organization_id}/billing/recovery | Get Renewal Recovery | Keine. | 200 application/json: RenewalRecoveryResponse |
POST | /v1/organizations/{organization_id}/billing/recovery/stop-to-free | Stop Renewal Recovery To Free | application/json: RenewalRecoveryStopRequestBody | 200 application/json: RenewalRecoveryResponse |
PUT | /v1/organizations/{organization_id}/billing/row-budget | Change Row Budget | application/json: RowBudgetChangeRequestBody | 200 application/json: RowBudgetChangeResponse |
GET | /v1/organizations/{organization_id}/billing/statements | List Billing Statements | Keine. | 200 application/json: BillingStatementListResponse |
GET | /v1/organizations/{organization_id}/billing/statements/{statement_id} | Get Billing Statement | Keine. | 200 application/json: BillingStatementDetailResponse |
GET | /v1/organizations/{organization_id}/billing/top-up-receipts | List Top Up Receipts | Keine. | 200 application/json: TopUpReceiptListResponse |
POST | /v1/organizations/{organization_id}/billing/top-ups | Start Top Up | application/json: TopUpStartRequestBody | 201 application/json: TopUpIntentResponse |
GET | /v1/organizations/{organization_id}/billing/top-ups/{top_up_intent_id} | Get Top Up Status | Keine. | 200 application/json: TopUpIntentResponse |
API-Referenz wird geladen...