curl -X POST \
  "https://api.telzino.com/v1/organizations/123e4567-e89b-12d3-a456-426614174000/payments/onboarding" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

// Keep your Telzino access token server-side. Expose a tiny endpoint your
// front-end can call to fetch a fresh session for a given merchant org.
app.post('/onboarding/:orgId', async (req, res) => {
  const r = await fetch(
    `https://api.telzino.com/v1/organizations/${req.params.orgId}/payments/onboarding`,
    { method: 'POST', headers: { Authorization: `Bearer ${process.env.TELZINO_TOKEN}` } }
  );
  const { client_secret, publishable_key } = await r.json();
  res.json({ client_secret, publishable_key });
});

import { useState } from 'react';
import { loadConnectAndInitialize } from '@stripe/connect-js';
import { ConnectComponentsProvider, ConnectAccountOnboarding } from '@stripe/react-connect-js';

export function Onboarding({ orgId }) {
  const [instance, setInstance] = useState(null);

  const begin = async () => {
    // Fetch publishable_key + a fresh client_secret from YOUR server (above).
    const first = await fetch(`/onboarding/${orgId}`, { method: 'POST' }).then((r) => r.json());
    const conn = loadConnectAndInitialize({
      publishableKey: first.publishable_key,
      // Stripe calls this to (re)fetch a session secret on demand.
      fetchClientSecret: async () =>
        (await fetch(`/onboarding/${orgId}`, { method: 'POST' }).then((r) => r.json())).client_secret,
    });
    setInstance(conn);
  };

  if (!instance) return <button onClick={begin}>Set up payments</button>;

  return (
    <ConnectComponentsProvider connectInstance={instance}>
      <ConnectAccountOnboarding onExit={() => {/* re-check status via /payments/status */}} />
    </ConnectComponentsProvider>
  );
}

import os, requests

def create_onboarding_session(org_id: str) -> dict:
    r = requests.post(
        f'https://api.telzino.com/v1/organizations/{org_id}/payments/onboarding',
        headers={'Authorization': f"Bearer {os.environ['TELZINO_TOKEN']}"},
    )
    data = r.json()
    # Return both to your front-end, which renders Stripe's embedded component.
    return {'client_secret': data['client_secret'], 'publishable_key': data['publishable_key']}

{
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "client_secret": "accs_secret_1a2b3c...",
  "publishable_key": "pk_live_51Ab..."
}

{
  "error": "Invalid organization_id"
}

{
  "error": "unauthorized",
  "error_description": "User payload not found"
}

{
  "error": "Forbidden",
  "error_description": "You do not have access to this organization"
}

{
  "error": "forbidden",
  "error_description": "Card payments are not available for this organization"
}

{
  "error": "Organization not found"
}