SymbiFlow · Financial Adapter

SymbioPay

Connect a domain to Stripe from one workspace. Enter the target, billing model, and delegated permissions; SymbioPay validates the environment, provisions Stripe resources, and generates the integration manifest.

Workspace security

Operator access

SymbioPay operator token

This is SymbioPay access control—not a Stripe password. It is never saved in the browser draft.

Target

Project & domain

Needs data

Project / business name Primary domain Public production domain. SymbioPay normalizes protocol and www. Environment Application stack Business country Default currency

Financial provider

Stripe authorization

Not tested

Connection mode Restricted keys are preferred for direct client-account access. Stripe restricted / secret key

Sent only to the SymbioPay server for the active request. Never written to drafts, manifests, or GitHub. Stripe publishable key Safe for client-side payment UI and may be included in the generated manifest.

SymbioPay does not ask for Stripe usernames or passwords. Use a scoped API key, Stripe Connect authorization, or a server-managed platform credential.

Payment experience

Checkout & payment behavior

Integration mode Payment methods Success URL Cancel URL Customer creation Statement descriptor Enable Stripe automatic tax in generated checkout configuration Collect billing address when supported Collect customer phone number Allow promotion codes in Checkout Privacy policy URL Terms URL

Server events

Callbacks & webhooks

Webhook URL SymbioPay creates or updates a matching Stripe webhook endpoint. Webhook events

checkout.session.completed
payment_intent.succeeded
payment_intent.payment_failed
customer.subscription.created
customer.subscription.updated
customer.subscription.deleted
invoice.paid
invoice.payment_failed
charge.refunded

One event per line. The signing secret is returned once when a new endpoint is created. Create or update the Stripe webhook endpoint Register the domain as a Stripe Payment Method Domain for wallet-capable payment UI

Catalog

Products & pricing

Create/reuse Stripe products and prices that are not already identified

Billing self-service

Customer portal

Create or update a SymbioPay Stripe Customer Portal configuration Allow subscription cancellation at period end Portal return URL Portal headline

Code access

Repository & hosting permissions

Repository provider Repository Branch Manifest path GitHub token / App installation token

Only needed when SymbioPay is authorized to write the generated manifest into the target repository. Hosting provider Host project / service ID Hosting API token

Collected for future provider adapters; the initial engine does not transmit this token.

Domain control

DNS permissions

DNS provider Zone / domain ID DNS API token

Stripe Payment Method Domain registration normally does not require DNS access.

Execution authority

Automation permissions

Allow Stripe writes: products, prices, payment domains, webhooks, and portal configuration Explicitly authorize LIVE Stripe provisioning when Environment is set to Live / production Allow GitHub write-back of the generated secret-free integration manifest Authorize host configuration when that provider adapter is enabled Authorize DNS changes when that provider adapter is enabled

Provisioning

Validate & connect

Idle

Validation performs read-only checks first. Connect Stripe performs only the write actions authorized above.

1
Domain
Not checked
2
Stripe
Not checked
3
Test / live mode
Not checked
4
Live-write authorization
Not required in test mode
5
Wallet domain
Not checked
6
Billing catalog
Not checked
7
Webhook
Not checked
8
Tax
Optional
9
Customer Portal
Optional
10
Repository
Optional