Developer Platform

Developer Platform Completion

A read-only developer portal for API documentation, quickstarts, sandbox planning, webhook readiness, event logs, SDK roadmaps, sample integrations, and production activation blockers.

Explore API docs Business Platform

Integration readiness

86%

Production activation

blocked

Documentation sections

Disabled actions

Developer overview

Integration readiness command center

The developer home aggregates readiness metadata and keeps future execution surfaces visible but deliberately blocked.

Integration readiness score

readiness only

86%

Readiness rollup across docs, sandbox, webhooks, SDKs, samples, and checklists.

Sandbox readiness

readiness only

planned-ready

Sandbox guidance is visible without live sandbox execution or provider calls.

API documentation readiness

ready

reference-ready

Core API documentation sections are present as display-only guidance.

SDK readiness

readiness only

roadmap-ready

SDK language coverage is documented without publishing packages.

Webhook readiness

readiness only

verification-ready

Webhook concepts, signatures, replay protection, and delivery logs are documented.

Event log readiness

readiness only

catalog-ready

Event catalog and lifecycle mapping are visible without replay execution.

Sample integration readiness

readiness only

sample-ready

Samples are represented as guidance only and cannot call external providers.

Rate limit readiness

ready

documented

Rate limit posture is documented for future API access planning.

Production activation status

blocked

Production API access remains blocked pending approval and governance.

Blocked capabilities

blocked

active

API keys, webhook sends, API explorer sends, provider calls, and financial execution remain disabled.

Backend binding

Static advisory fallback

Backend readiness is not configured for this website runtime. Static advisory metadata is being displayed.

backend unconfigured

Production activation status

blocked

Provider execution blocked

true

Payment execution blocked

true

Ledger posting blocked

true

Wallet mutation blocked

true

Settlement blocked

true

Treasury blocked

true

API key generation enabled

false

Webhook sending enabled

false

API request execution enabled

false

Readiness API

GET /financial-core/readiness

Developer portal readiness

pilot_ready

Backend configured

false

API documentation experience

API documentation sections

Reference sections are organized for technical evaluators without enabling API execution from the website.

Authentication

ready

Backend-owned identity runtime, bearer token expectations, and secret handling boundaries.

Authorization: Bearer <annuvera_jwt>

Identity Runtime

ready

Readiness, auth start, callback, session, refresh, logout, and /auth/me lifecycle references.

GET /auth/me

Organizations

readiness only

Organization profile, members, invitations, roles, and verification readiness.

GET /organizations/{organizationId}

Merchant Accounts

readiness only

Merchant profile, KYB, provider selection, settlement preferences, and verification readiness.

GET /merchant-onboarding/stripe/status

Payment Intents

blocked

Payment intent lifecycle readiness without create, confirm, capture, or refund execution.

POST /payment-intents

Payment Orchestration

blocked

Provider routing, idempotency, lifecycle state, and execution blockers.

GET /payment-orchestration/certification

Provider Routing

blocked

Provider certification, routing readiness, and blocked live provider execution.

GET /provider-execution/certification

Webhooks

readiness only

Signature verification, replay protection, delivery logs, and endpoint readiness.

POST /providers/stripe/production-activation/webhooks/events

Events

readiness only

Event catalog, lifecycle mapping, correlation IDs, and delivery state.

GET /providers/stripe/webhook-observability/events

Refunds

blocked

Refund lifecycle readiness without refund creation or money movement.

POST /refunds

Settlements

blocked

Settlement readiness, reporting posture, and blocked settlement execution.

GET /treasury-readiness/settlements

Wallet Read Models

readiness only

Wallet and balance visibility without wallet mutation or balance writes.

GET /wallets

Reports

readiness only

Operational and merchant reporting visibility without exports or accounting entries.

GET /transactions/executive-summary

Errors

ready

Error response conventions, retry guidance, and safe failure handling.

HTTP 4xx/5xx error envelope

Idempotency

ready

Idempotency-key expectations for future mutating endpoints.

Idempotency-Key: <unique-key>

Rate Limits

ready

Rate limit headers and future quota planning.

X-RateLimit-Remaining

Sandbox Testing

readiness only

Sandbox base URL, provider simulators, test events, and blocked production capabilities.

https://sandbox.api.annuvera.com

Quickstarts

Quickstarts and sandbox experience

Quickstarts and sandbox guidance prepare integration teams while keeping provider calls, payment execution, and production actions disabled.

developer experience

Create developer account readiness

readiness only

Create developer account readiness is available as safe integration guidance.

Next: Review create developer account readiness before requesting production access.

developer experience

Configure sandbox readiness

readiness only

Configure sandbox readiness is available as safe integration guidance.

Next: Review configure sandbox readiness before requesting production access.

developer experience

Authenticate with AnnuVera

ready

Authenticate with AnnuVera is available as safe integration guidance.

Next: Review authenticate with annuvera before requesting production access.

developer experience

Create payment intent readiness

blocked

Create payment intent readiness is documented, but execution remains blocked.

Next: Review create payment intent readiness before requesting production access.

developer experience

Listen to webhook readiness

readiness only

Listen to webhook readiness is available as safe integration guidance.

Next: Review listen to webhook readiness before requesting production access.

developer experience

Handle event callbacks

readiness only

Handle event callbacks is available as safe integration guidance.

Next: Review handle event callbacks before requesting production access.

developer experience

Test provider routing readiness

blocked

Test provider routing readiness is documented, but execution remains blocked.

Next: Review test provider routing readiness before requesting production access.

developer experience

View settlement readiness

blocked

View settlement readiness is documented, but execution remains blocked.

Next: Review view settlement readiness before requesting production access.

developer experience

Review production activation blockers

blocked

Review production activation blockers is documented, but execution remains blocked.

Next: Review review production activation blockers before requesting production access.

Sandbox experience

sandbox readiness

Sandbox status

readiness only

Sandbox guidance is display-only and does not execute provider, payment, webhook, or production workflows.

Next: Use the sandbox checklist for integration planning only.

sandbox readiness

Sandbox base URL readiness

readiness only

Sandbox guidance is display-only and does not execute provider, payment, webhook, or production workflows.

Next: Use the sandbox checklist for integration planning only.

sandbox readiness

Test merchant readiness

readiness only

Sandbox guidance is display-only and does not execute provider, payment, webhook, or production workflows.

Next: Use the sandbox checklist for integration planning only.

sandbox readiness

Test provider readiness

blocked

Sandbox guidance is display-only and does not execute provider, payment, webhook, or production workflows.

Next: Use the sandbox checklist for integration planning only.

sandbox readiness

Test payment lifecycle readiness

blocked

Sandbox guidance is display-only and does not execute provider, payment, webhook, or production workflows.

Next: Use the sandbox checklist for integration planning only.

sandbox readiness

Test webhook readiness

readiness only

Sandbox guidance is display-only and does not execute provider, payment, webhook, or production workflows.

Next: Use the sandbox checklist for integration planning only.

sandbox readiness

Test events readiness

readiness only

Sandbox guidance is display-only and does not execute provider, payment, webhook, or production workflows.

Next: Use the sandbox checklist for integration planning only.

sandbox readiness

Sandbox limitations

ready

Sandbox guidance is display-only and does not execute provider, payment, webhook, or production workflows.

Next: Use the sandbox checklist for integration planning only.

sandbox readiness

Blocked production capabilities

blocked

Sandbox guidance is display-only and does not execute provider, payment, webhook, or production workflows.

Next: Use the sandbox checklist for integration planning only.

Credential governance

API keys readiness

API key readiness is reference-only; no keys are created, rotated, revoked, displayed, stored, or exposed by this portal.

credential governance

Publishable key readiness

readiness only

Publishable key readiness is represented through reference-only credential governance metadata.

Next: Request production approval before any credential workflow.

credential governance

Secret key readiness

blocked

Secret key readiness is blocked; no key material is created, rotated, revoked, displayed, or stored by the website.

Next: Request production approval before any credential workflow.

credential governance

Restricted key readiness

readiness only

Restricted key readiness is represented through reference-only credential governance metadata.

Next: Request production approval before any credential workflow.

credential governance

Key rotation readiness

blocked

Key rotation readiness is blocked; no key material is created, rotated, revoked, displayed, or stored by the website.

Next: Request production approval before any credential workflow.

credential governance

Key audit readiness

readiness only

Key audit readiness is represented through reference-only credential governance metadata.

Next: Request production approval before any credential workflow.

Webhook center

Webhook center and event logs

Webhook and event surfaces expose readiness, delivery concepts, and lifecycle mapping without sending or replaying events.

webhook operations

Webhook endpoint readiness

readiness only

Webhook center readiness is visible without sending test events, creating endpoints, or exposing signing secrets.

Next: Review webhook readiness and keep endpoint changes backend-owned.

webhook operations

Event subscription readiness

readiness only

Webhook center readiness is visible without sending test events, creating endpoints, or exposing signing secrets.

Next: Review webhook readiness and keep endpoint changes backend-owned.

webhook operations

Signature verification readiness

ready

Webhook center readiness is visible without sending test events, creating endpoints, or exposing signing secrets.

Next: Review webhook readiness and keep endpoint changes backend-owned.

webhook operations

Replay protection readiness

ready

Webhook center readiness is visible without sending test events, creating endpoints, or exposing signing secrets.

Next: Review webhook readiness and keep endpoint changes backend-owned.

webhook operations

Delivery log readiness

readiness only

Webhook center readiness is visible without sending test events, creating endpoints, or exposing signing secrets.

Next: Review webhook readiness and keep endpoint changes backend-owned.

webhook operations

Retry readiness

readiness only

Webhook center readiness is visible without sending test events, creating endpoints, or exposing signing secrets.

Next: Review webhook readiness and keep endpoint changes backend-owned.

webhook operations

Disabled send test webhook

blocked

Webhook center readiness is visible without sending test events, creating endpoints, or exposing signing secrets.

Next: Review webhook readiness and keep endpoint changes backend-owned.

webhook operations

Disabled create endpoint

blocked

Webhook center readiness is visible without sending test events, creating endpoints, or exposing signing secrets.

Next: Review webhook readiness and keep endpoint changes backend-owned.

webhook operations

Disabled rotate signing secret

blocked

Webhook center readiness is visible without sending test events, creating endpoints, or exposing signing secrets.

Next: Review webhook readiness and keep endpoint changes backend-owned.

Event logs

event operations

Event catalog

ready

Event logs are display-only and cannot replay, resend, or mutate event delivery state.

Next: Use event metadata to prepare integration review.

event operations

Event timeline

readiness only

Event logs are display-only and cannot replay, resend, or mutate event delivery state.

Next: Use event metadata to prepare integration review.

event operations

Delivery status readiness

readiness only

Event logs are display-only and cannot replay, resend, or mutate event delivery state.

Next: Use event metadata to prepare integration review.

event operations

Replay readiness

blocked

Event logs are display-only and cannot replay, resend, or mutate event delivery state.

Next: Use event metadata to prepare integration review.

event operations

Idempotency readiness

ready

Event logs are display-only and cannot replay, resend, or mutate event delivery state.

Next: Use event metadata to prepare integration review.

event operations

Correlation ID readiness

ready

Event logs are display-only and cannot replay, resend, or mutate event delivery state.

Next: Use event metadata to prepare integration review.

event operations

Provider callback mapping

readiness only

Event logs are display-only and cannot replay, resend, or mutate event delivery state.

Next: Use event metadata to prepare integration review.

event operations

Payment lifecycle mapping

readiness only

Event logs are display-only and cannot replay, resend, or mutate event delivery state.

Next: Use event metadata to prepare integration review.

SDK and samples

SDK readiness and sample integrations

SDK and sample integration surfaces describe future integration paths without package publishing, external calls, or payment execution.

developer relations

JavaScript / TypeScript

readiness only

SDK readiness describes integration direction only; no package publishing or executable SDK artifact is added.

Next: Review JavaScript / TypeScript integration guidance before SDK release planning.

developer relations

Node.js

readiness only

SDK readiness describes integration direction only; no package publishing or executable SDK artifact is added.

Next: Review Node.js integration guidance before SDK release planning.

developer relations

Python

planned

SDK readiness describes integration direction only; no package publishing or executable SDK artifact is added.

Next: Review Python integration guidance before SDK release planning.

developer relations

PHP

planned

SDK readiness describes integration direction only; no package publishing or executable SDK artifact is added.

Next: Review PHP integration guidance before SDK release planning.

developer relations

Java

planned

SDK readiness describes integration direction only; no package publishing or executable SDK artifact is added.

Next: Review Java integration guidance before SDK release planning.

developer relations

Go

planned

SDK readiness describes integration direction only; no package publishing or executable SDK artifact is added.

Next: Review Go integration guidance before SDK release planning.

developer relations

Mobile

readiness only

SDK readiness describes integration direction only; no package publishing or executable SDK artifact is added.

Next: Review Mobile integration guidance before SDK release planning.

developer relations

REST-only integration

ready

SDK readiness describes integration direction only; no package publishing or executable SDK artifact is added.

Next: Review REST-only integration integration guidance before SDK release planning.

Sample integrations

developer experience

Checkout flow

blocked

Sample integration is guidance-only and cannot initiate provider calls, payment execution, refunds, transfers, or settlements.

Next: Review checkout flow as non-executing sample guidance.

developer experience

Mobile money collection

blocked

Sample integration is guidance-only and cannot initiate provider calls, payment execution, refunds, transfers, or settlements.

Next: Review mobile money collection as non-executing sample guidance.

developer experience

Card payment readiness

blocked

Sample integration is guidance-only and cannot initiate provider calls, payment execution, refunds, transfers, or settlements.

Next: Review card payment readiness as non-executing sample guidance.

developer experience

Bank transfer readiness

blocked

Sample integration is guidance-only and cannot initiate provider calls, payment execution, refunds, transfers, or settlements.

Next: Review bank transfer readiness as non-executing sample guidance.

developer experience

Webhook handler

readiness only

Sample integration is guidance-only and cannot initiate provider calls, payment execution, refunds, transfers, or settlements.

Next: Review webhook handler as non-executing sample guidance.

developer experience

Refund readiness

blocked

Sample integration is guidance-only and cannot initiate provider calls, payment execution, refunds, transfers, or settlements.

Next: Review refund readiness as non-executing sample guidance.

developer experience

Settlement report readiness

readiness only

Sample integration is guidance-only and cannot initiate provider calls, payment execution, refunds, transfers, or settlements.

Next: Review settlement report readiness as non-executing sample guidance.

developer experience

Merchant dashboard embedding readiness

readiness only

Sample integration is guidance-only and cannot initiate provider calls, payment execution, refunds, transfers, or settlements.

Next: Review merchant dashboard embedding readiness as non-executing sample guidance.

API explorer readiness

Endpoint cards show examples and constraints. The Send request action is disabled so the portal never executes API calls.

GET

Financial core readiness

ready

/financial-core/readiness

Auth

None for internal readiness preview

Idempotency

Not required for read-only request

Rate limit

Readiness-only preview limits apply

GET /financial-core/readiness

{ "status": "advisory_only", "providerExecutionEnabled": false }

{ "error": "backend_unavailable" }

GET

Authenticated identity

ready

/auth/me

Auth

Bearer AnnuVera JWT

Idempotency

Not required for read-only request

Rate limit

Identity runtime limits apply

GET /auth/me

{ "authenticated": true, "provider": "workos" }

{ "error": "missing_authorization" }

GET

Webhook observability events

readiness only

/providers/stripe/webhook-observability/events

Auth

Internal operations access

Idempotency

Not required for read-only request

Rate limit

Operational readiness limits apply

GET /providers/stripe/webhook-observability/events

{ "observabilityReady": true, "supportedEventTypes": [] }

{ "error": "observability_unavailable" }

POST

Payment intent readiness

blocked

/payment-intents

Auth

Bearer token required in future

Idempotency

Idempotency-Key required for future mutation

Rate limit

Mutation limits pending approval

{ "amountMinor": 100, "currency": "usd" }

{ "status": "blocked", "paymentExecutionEnabled": false }

{ "error": "payment_execution_blocked" }

GET

Settlement readiness summary

blocked

/treasury-readiness/settlement-summary

Auth

Internal operations access

Idempotency

Not required for read-only request

Rate limit

Read-only readiness limits apply

GET /treasury-readiness/settlement-summary

{ "settlementExecutionBlocked": true }

{ "error": "settlement_readiness_unavailable" }

Developer integration checklist

The checklist helps teams understand readiness evidence, production blockers, and the next safe review step.