OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

integration-stripe.integration.psp

Integration contract for managed or BYOK Stripe card processing.

  • Type: integration (integration)
  • Version: 1.0.0
  • Tags: stripe, payments
  • File: packages/examples/integration-stripe/src/integration.ts
  • field.key.label
    integration-stripe.integration.psp
    field.version.label
    1.0.0
    field.type.label
    integration (integration)
    field.title.label
    integration-stripe.integration.psp
    field.description.label

    Integration contract for managed or BYOK Stripe card processing.

  • Type: integration (integration)
  • Version: 1.0.0
  • Tags: stripe, payments
  • File: packages/examples/integration-stripe/src/integration.ts
  • field.tags.label
    stripe,payments
    field.owners.label
    field.stability.label

    Integration contract for managed or BYOK Stripe card processing.

    Source Definition

    export const StripePaymentsIntegrationSpec = defineIntegration({
    	meta: {
    		key: 'integration-stripe.integration.psp',
    		version: '1.0.0',
    		title: 'Stripe Payments Integration',
    		description:
    			'Integration contract for managed or BYOK Stripe card processing.',
    		domain: 'payments',
    		category: 'payments',
    		owners: [OwnersEnum.PlatformCore],
    		tags: [TagsEnum.Marketplace, 'stripe', 'payments'],
    		stability: StabilityEnum.Experimental,
    	},
    	supportedModes: ['managed', 'byok'],
    	capabilities: {
    		provides: [{ key: 'payments.psp', version: '1.0.0' }],
    	},
    	configSchema: {
    		schema: StripeConfigModel,
    		example: {
    			accountId: 'acct_demo_artisan',
    			webhookEndpoint: 'https://pay.artisanos.dev/webhooks/stripe',
    		},
    	},
    	secretSchema: {
    		schema: StripeSecretModel,
    		example: {
    			apiKey: 'sk_live_redacted',
    			webhookSecret: 'whsec_redacted',
    		},
    	},
    	healthCheck: {
    		method: 'ping',
    		timeoutMs: 5000,
    	},
    	docsUrl: 'https://docs.stripe.com',
    	constraints: {
    		rateLimit: {
    			rpm: 1000,
    		},
    	},
    	byokSetup: {
    		setupInstructions:
    			'Create a restricted API key and webhook endpoint, then bind the secret reference to the tenant connection.',
    		requiredScopes: ['charges:write', 'customers:read', 'webhooks:write'],
    	},
    });