On this page

Installasjons- og dypelenker

Installasjonslenker lar deg distribuere Stripe App utenfor marketplace, mens dype lenker navigerer brukere direkte til spesifikke visninger i den installerte appen.

Installasjonslenker

Installasjonslenker gir en direkte URL som selgere kan bruke for å installere appen din.

Format for installasjonslenke

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

Parameter	Påkrevd	Beskrivelse
`client_id`	Ja	App-ID-en din (f.eks. `com.tajo.brevo-integration`)
`redirect_uri`	Ja	Må samsvare med en av `allowed_redirect_uris`
`state`	Anbefalt	Tilfeldig streng for CSRF-beskyttelse

CSRF-beskyttelse

Bruk alltid state-parameteren for å forhindre forfalskning av forespørsler på tvers av nettsteder:

import crypto from 'crypto';

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());
};

Dype lenker

Dype lenker navigerer brukere direkte til en spesifikk visning i den installerte Stripe App.

Format for dyp lenke

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

Eksempler på dype lenker

# Åpne kundedetaljvisning i skuff
https://dashboard.stripe.com/live/acct_xxxxx/customers/cus_xxxxx
  ?apps[com.tajo.brevo-integration][drawer]=stripe.dashboard.customer.detail

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

Tip

Test alltid installasjonslenker og dype lenker i både live- og testmodus for å sikre at de fungerer riktig i alle miljøer.