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 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'],
},
});