On this page

Telepítési és mély hivatkozások

A telepítési hivatkozások lehetővé teszik a Stripe App terjesztését a marketplace-en kívül, míg a mély hivatkozások közvetlenül a telepített appon belüli konkrét nézetekhez navigálják a felhasználókat. Mindkettő elengedhetetlen a gördülékeny bevezetési és integrációs folyamatokhoz.

Telepítési hivatkozások

A telepítési hivatkozások közvetlen URL-t biztosítanak, amelyet a kereskedők az app telepítéséhez használhatnak.

Telepítési hivatkozás formátuma

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

CSRF védelem

Mindig használja az state paramétert a cross-site request forgery támadások megelőzéséhez:

import crypto from 'crypto';

// Véletlenszerű state érték generálása és tárolása a munkamenetben
const generateInstallLink = (req, res) => {
  const state = crypto.randomBytes(32).toString('hex');

  req.session.stripeInstallState = state;

  const installUrl = new URL('https://marketplace.stripe.com/oauth/v2/authorize');
  installUrl.searchParams.set('client_id', 'com.tajo.brevo-integration');
  installUrl.searchParams.set('redirect_uri', 'https://tajo.io/stripe/callback');
  installUrl.searchParams.set('state', state);

  res.redirect(installUrl.toString());
};

Mély hivatkozások

A mély hivatkozások közvetlenül a telepített Stripe Appon belüli konkrét nézethez navigálják a felhasználókat.

Mély hivatkozás URL formátuma

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

Mély hivatkozás példák

Ügyfél részletes nézet megnyitása fiókban

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

Beállítások megnyitása modalban

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

Mély hivatkozások programmatikus generálása

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

Mindig tesztelje a telepítési hivatkozásokat és a mély hivatkozásokat éles és teszt módban egyaránt, hogy meggyőződjön arról, hogy minden környezetben megfelelően működnek.