1export const stripeIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'payments.stripe',
4		version: '1.0.0',
5		category: 'payments',
6		title: 'Stripe Payments',
7		description:
8			'Stripe integration for payment processing, charges, and payouts.',
9		domain: 'payments',
10		owners: ['platform.payments'],
11		tags: ['payments', 'psp'],
12		stability: StabilityEnum.Stable,
13	},
14	supportedModes: ['managed', 'byok'],
15	transports: [
16		{
17			type: 'rest',
18			baseUrl: 'https://api.stripe.com',
19			apiVersionHeader: 'Stripe-Version',
20		},
21		{
22			type: 'webhook',
23			inbound: {
24				signatureHeader: 'stripe-signature',
25				signingAlgorithm: 'hmac-sha256',
26			},
27		},
28		{ type: 'sdk', packageName: 'stripe', minVersion: '14.0.0' },
29	],
30	preferredTransport: 'rest',
31	supportedAuthMethods: [
32		{ type: 'api-key', headerName: 'Authorization', prefix: 'Bearer ' },
33		{
34			type: 'oauth2',
35			grantType: 'authorization_code',
36			authorizationUrl: 'https://connect.stripe.com/oauth/authorize',
37			tokenUrl: 'https://connect.stripe.com/oauth/token',
38			scopes: ['read_write'],
39		},
40		{
41			type: 'webhook-signing',
42			algorithm: 'hmac-sha256',
43			signatureHeader: 'stripe-signature',
44		},
45	],
46	versionPolicy: {
47		currentVersion: '2024-11-20.acacia',
48		supportedVersions: [{ version: '2024-11-20.acacia', status: 'stable' }],
49		versionHeader: 'Stripe-Version',
50	},
51	capabilities: {
52		provides: [{ key: 'payments.psp', version: '1.0.0' }],
53		requires: [
54			{
55				key: 'platform.webhooks',
56				optional: true,
57				reason: 'Recommended for reliable event ingestion',
58			},
59		],
60	},
61	configSchema: {
62		schema: {
63			type: 'object',
64			properties: {
65				accountId: {
66					type: 'string',
67					description: 'Connected account ID when using Stripe Connect (BYOK).',
68				},
69				region: {
70					type: 'string',
71					description: 'Optional Stripe region or data residency hint.',
72				},
73			},
74		},
75		example: {
76			accountId: 'acct_123',
77			region: 'us-east-1',
78		},
79	},
80	secretSchema: {
81		schema: {
82			type: 'object',
83			required: ['apiKey', 'webhookSecret'],
84			properties: {
85				apiKey: {
86					type: 'string',
87					description: 'Stripe secret API key (sk_live_... or sk_test_...).',
88				},
89				webhookSecret: {
90					type: 'string',
91					description: 'Signing secret for webhook verification.',
92				},
93			},
94		},
95		example: {
96			apiKey: 'sk_live_***',
97			webhookSecret: 'whsec_***',
98		},
99	},
100	healthCheck: {
101		method: 'ping',
102		timeoutMs: 5000,
103	},
104	docsUrl: 'https://stripe.com/docs/api',
105	constraints: {
106		rateLimit: {
107			rpm: 1000,
108			rph: 20000,
109		},
110	},
111	byokSetup: {
112		setupInstructions:
113			'Create a restricted Stripe API key with write access to Charges and provide a webhook signing secret.',
114		requiredScopes: ['charges:write', 'customers:read'],
115		keyRotationSupported: true,
116		quotaTrackingSupported: false,
117	},
118});