On this page

Instalační a hluboké odkazy

Instalační odkazy vám umožňují distribuovat vaši Stripe App mimo marketplace, zatímco hluboké odkazy navigují uživatele přímo do konkrétních pohledů v rámci nainstalované aplikace. Obojí je nezbytné pro plynulý onboarding a integrační toky.

Instalační odkazy

Instalační odkazy poskytují přímou URL, kterou obchodníci mohou použít k instalaci vaší aplikace.

Předpoklady

Před použitím instalačních odkazů nakonfigurujte allowed_redirect_uris v manifestu aplikace:

{
  "id": "com.tajo.brevo-integration",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback",
    "https://tajo.io/stripe/oauth/complete"
  ]
}

Formát instalačního odkazu

https://marketplace.stripe.com/oauth/v2/authorize?client_id=APP_ID&redirect_uri=REDIRECT_URI&state=STATE_VALUE

Parametr	Povinný	Popis
`client_id`	Ano	ID vaší aplikace (např. `com.tajo.brevo-integration`)
`redirect_uri`	Ano	Musí odpovídat jednomu z vašich `allowed_redirect_uris`
`state`	Doporučeno	Náhodný řetězec pro ochranu před CSRF

Ověření podpisu

import crypto from 'crypto';

const verifyInstallSignature = (signature, accountId) => {
  const signingSecret = process.env.STRIPE_APP_SIGNING_SECRET;

  const expectedSignature = crypto
    .createHmac('sha256', signingSecret)
    .update(accountId)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
};

Caution

Vždy používejte crypto.timingSafeEqual pro porovnání podpisů, abyste zabránili časovacím útokům. Nikdy nepoužívejte jednoduché porovnání řetězců (===).

Hluboké odkazy

Hluboké odkazy navigují uživatele přímo do konkrétního pohledu v rámci nainstalované Stripe App.

Formát URL hlubokého odkazu

https://dashboard.stripe.com/MODE/acct_ID/PAGE?apps[APP_ID][TARGET]=VIEWPORT_ID

Příklady hlubokých odkazů

Otevření detailu zákazníka v zásuvce

https://dashboard.stripe.com/live/acct_xxxxx/customers/cus_xxxxx
  ?apps[com.tajo.brevo-integration][drawer]=stripe.dashboard.customer.detail

Otevření nastavení v modálu

https://dashboard.stripe.com/live/acct_xxxxx/settings
  ?apps[com.tajo.brevo-integration][modal]=stripe.dashboard.settings

Generování hlubokých odkazů programově

const generateDeepLink = ({
  accountId,
  mode = 'live',
  page,
  appId = 'com.tajo.brevo-integration',
  target = 'drawer',
  viewport,
}) => {
  const baseUrl = `https://dashboard.stripe.com/${mode}/${accountId}/${page}`;
  const params = new URLSearchParams();
  params.set(`apps[${appId}][${target}]`, viewport);

  return `${baseUrl}?${params.toString()}`;
};

Tip

Vždy testujte instalační a hluboké odkazy v živém i testovacím režimu, abyste zajistili správnou funkci ve všech prostředích.