# Onboarding (/it/merchants/onboarding)



















Prima di poter elaborare pagamenti, un esercente deve completare l'onboarding KYB (Know Your Business). Tapaya verifica l'identità dell'esercente e i dati della sua attività per soddisfare i requisiti del processore di pagamento e le normative regionali.

<div className="bg-background relative h-auto w-full overflow-hidden rounded-lg border">
  <FlickeringGrid className="absolute inset-0 z-0 size-full" squareSize="4" gridGap="6" maxOpacity="0.1" flickerChance="0.1" height="800" width="2000" />

  <KybStatusDiagram />
</div>

## Abilitare i pagamenti online [#enable-online-payments]

Il Checkout è disponibile per gli esercenti approvati. Durante l'onboarding, selezioni i pagamenti online oppure sia i pagamenti online sia quelli in presenza. Indichi il sito web del negozio e i dati dell'attività online. L'onboarding solo per il Checkout non richiede terminali.

Gli esercenti che richiedono i pagamenti online compaiono automaticamente in **Checkout** nella [Tapaya Platform](https://platform.tapaya.com/checkout-settings). Non possono accettare pagamenti finché il processore dei pagamenti online non li approva e il loro gateway di pagamento non è configurato. Un'approvazione esistente per i pagamenti in presenza, da sola, non abilita il Checkout. Inoltre l'esercente deve essere attivo.

Verifichi che nella tabella degli esercenti di Checkout compaia **Ready**, quindi configuri chiavi, wallet ed eventuali URL di ritorno di Hosted Checkout nelle [impostazioni di Checkout](/online/integration/checkout_settings). La sola creazione di un record dell'esercente o di una chiave API non abilita i pagamenti.

## Matrice delle responsabilità [#responsibility-matrix]

Ogni flusso si conclude con la stessa decisione di verifica, ma il lavoro che la precede è suddiviso in modo diverso. Prima di scegliere uno dei flussi descritti di seguito, verifichi chi è responsabile di ciascun passaggio.

<ResponsibilityMatrix
  columns="[
  { key: &#x22;platform&#x22;, label: &#x22;Platform UI&#x22; },
  { key: &#x22;own&#x22;, label: &#x22;UI propria&#x22; },
  { key: &#x22;invite&#x22;, label: &#x22;Invito via email&#x22; },
  { key: &#x22;campaign&#x22;, label: &#x22;Link di campagna&#x22; },
]"
  rows="[
  { label: &#x22;Creare il record dell'esercente&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;you&#x22;, note: &#x22;tramite API&#x22; }, invite: { owner: &#x22;you&#x22;, note: &#x22;oppure lo crea l'invito&#x22; }, campaign: { owner: &#x22;merchant&#x22;, note: &#x22;si registra da solo&#x22; } } },
  { label: &#x22;Fornire il modulo e le regole di convalida&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;you&#x22;, invite: { owner: &#x22;tapaya&#x22;, note: &#x22;ospitato&#x22; }, campaign: { owner: &#x22;tapaya&#x22;, note: &#x22;ospitato&#x22; } } },
  { label: &#x22;Distribuire il link&#x22;, cells: { platform: &#x22;none&#x22;, own: &#x22;none&#x22;, invite: { owner: &#x22;you&#x22;, note: &#x22;un destinatario&#x22; }, campaign: { owner: &#x22;you&#x22;, note: &#x22;qualsiasi canale&#x22; } } },
  { label: &#x22;Inserire i dati dell'attività, bancari e sulla proprietà&#x22;, cells: { platform: &#x22;you&#x22;, own: { owner: &#x22;merchant&#x22;, note: &#x22;nella Sua UI&#x22; }, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Accettare i termini e l'Informativa sulla privacy di Tapaya&#x22;, cells: { platform: &#x22;merchant&#x22;, own: &#x22;merchant&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
  { label: &#x22;Inviare la richiesta al processore&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Verificare la richiesta (KYB)&#x22;, cells: { platform: &#x22;tapaya&#x22;, own: &#x22;tapaya&#x22;, invite: &#x22;tapaya&#x22;, campaign: &#x22;tapaya&#x22; } },
  { label: &#x22;Monitorare lo stato della verifica&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;you&#x22;, campaign: &#x22;you&#x22; } },
  { label: &#x22;Correggere i dati rifiutati o mancanti&#x22;, cells: { platform: &#x22;you&#x22;, own: &#x22;you&#x22;, invite: &#x22;merchant&#x22;, campaign: &#x22;merchant&#x22; } },
]"
/>

Nell'onboarding assistito tramite Platform UI, il Suo operatore compila il modulo per conto dell'esercente. È comunque l'esercente la parte che presta il consenso ai termini e all'Informativa sulla privacy di Tapaya, quindi prima dell'invio si accerti che li abbia visionati e accettati.

## Scegliere un flusso di onboarding [#choose-an-onboarding-flow]

Scelga il flusso in base a chi deve inserire i dati dell'esercente e a come desidera distribuire l'onboarding. Tutti i flussi sono disponibili nella Tapaya Platform UI. Se desidera automatizzarli, utilizzi l'API corrispondente descritta nella [Merchant Onboarding API](/platform-api/merchant_onboarding).

<Tabs defaultValue="platform" groupId="merchant-onboarding-flow" className="border-0 bg-transparent">
  <TabsList>
    <TabsTrigger value="platform">
      Platform UI
    </TabsTrigger>

    <TabsTrigger value="api">
      UI propria
    </TabsTrigger>

    <TabsTrigger value="email">
      Invito via email
    </TabsTrigger>

    <TabsTrigger value="campaign">
      Link di campagna
    </TabsTrigger>
  </TabsList>

  <TabsContent value="platform">
    ### Tapaya Platform UI [#tapaya-platform-ui]

    Un amministratore inserisce le informazioni dell'esercente e completa l'onboarding per suo conto nella [Tapaya Platform](https://platform.tapaya.com). Questo flusso è adatto all'onboarding assistito, a portafogli di esercenti più piccoli o ai casi in cui il Suo team operativo dispone già delle informazioni necessarie.

    **Come avviarlo:** Crei o selezioni l'esercente nella Tapaya Platform e ne apra l'onboarding. Lo stesso flusso può essere avviato tramite l'[API](/platform-api/merchant_onboarding) quando ha bisogno di automazione.

    Nella barra laterale, espanda **Payments** e apra **Merchants**. Vada alla sezione **Add a merchant**. Nella scheda **Add a merchant manually**, selezioni **Start onboarding**.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Avvio dell'onboarding di un esercente dalla Tapaya Platform" src="__img0" />
    </div>

    La Platform apre il modulo di onboarding guidato con le sezioni obbligatorie relative ad attività, dati bancari e proprietà.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Modulo dei dati dell'attività dell'esercente nella Tapaya Platform" src="__img1" />
    </div>
  </TabsContent>

  <TabsContent value="api">
    ### UI propria [#your-own-ui]

    Raccolga le informazioni dell'esercente nel Suo prodotto e le invii a Tapaya. In questo modo ha il pieno controllo dell'esperienza e può integrare l'onboarding con il flusso di registrazione o di gestione dell'account già esistente.

    Questa opzione richiede che Lei mantenga il Suo modulo e la relativa convalida allineati ai requisiti di onboarding vigenti. La Tapaya Platform UI resta disponibile per esaminare l'esercente e completare le azioni successive.

    **Come avviarlo:** Utilizzi il [flusso di onboarding tramite API dettagliato, con esempi](/platform-api/merchant_onboarding).

    Prima di inviare i dati dell'esercente tramite l'API, deve ottenere il suo consenso ai [Termini e condizioni Tapaya per gli integratori](https://tapaya.com/terms) e all'[Informativa sulla privacy di Tapaya](https://tapaya.com/privacy). Può aggiungere al Suo modulo di onboarding una casella di spunta con il link a entrambi i documenti, oppure inserire un link ai documenti Tapaya nel testo delle condizioni a cui l'esercente presta il consenso. Deve inoltre indicare Tapaya come responsabile del trattamento dei dati nella Sua informativa sulla privacy.

    La Sua interfaccia può adottare qualsiasi design visivo adatto al Suo prodotto. Un flusso tipico suddivide le informazioni richieste in sezioni gestibili e mostra l'avanzamento prima dell'invio.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Wireframe di un modulo di onboarding personalizzato per esercenti" src="__img2" />
    </div>
  </TabsContent>

  <TabsContent value="email">
    ### Invito via email [#email-invite]

    Può eseguire l'onboarding di un esercente invitandolo direttamente dalla Tapaya Platform. Inserisca l'indirizzo email dell'esercente e
    Tapaya crea un invito monouso con un link sicuro all'onboarding ospitato; dalla sua parte non è richiesta alcuna integrazione
    dell'SDK.

    L'esercente apre il link, completa lo stesso flusso KYB guidato e, una volta verificato, torna al Suo prodotto. È utile per eseguire l'onboarding degli esercenti prima che inizino a usare la Sua integrazione, oppure quando preferisce un flusso completamente ospitato.

    Lo utilizzi per inviti individuali, soprattutto quando sa chi è l'esercente ma desidera che sia lui a fornire e confermare
    le proprie informazioni. Ogni invito è riservato a un solo destinatario e scade se non viene utilizzato.

    Se ha già creato l'esercente nel Suo sistema e ha bisogno che l'onboarding ospitato di Tapaya si colleghi esattamente a quel
    record, crei prima il record di base dell'esercente e poi invii l'invito con lo stesso `merchantToken`. Questo è il flusso
    API consigliato per gli integratori:

    1. `POST /merchant/auth/register` oppure `POST /integrator/merchant`
    2. `POST /integrator/merchant/send-registration-invite` con `email` e lo stesso `merchantToken`
    3. L'esercente apre il `registrationUrl` restituito e completa il modulo KYB ospitato

    Senza `merchantToken`, il completamento dell'invito crea un nuovo record dell'esercente.

    Qualunque sia il flusso con cui un esercente completa l'onboarding, il suo account segue lo stesso ciclo di vita di verifica illustrato sopra.

    **Come avviarlo:** Invii e gestisca l'invito dalla Tapaya Platform UI, oppure automatizzi gli inviti tramite
    l'[API](/platform-api/merchant_onboarding#invite-a-merchant-to-complete-hosted-onboarding).

    Nella barra laterale, espanda **Payments** e apra **Merchants**. Vada alla sezione **Add a merchant**. Nella scheda **Invite via e-mail**, selezioni **Send invite link**.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Opzione di invito via email nella Tapaya Platform" src="__img3" />
    </div>

    Inserisca l'indirizzo email dell'esercente nella finestra di invito e scelga la commissione da applicare.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Finestra di invio dell'invito di registrazione a un esercente" src="__img4" />
    </div>
  </TabsContent>

  <TabsContent value="campaign">
    ### Link di campagna [#campaign-link]

    Crei un unico link di registrazione riutilizzabile e lo condivida sul Suo sito web, in un portale partner, in una newsletter o tramite un altro canale. Più esercenti possono usare il link per registrarsi e completare l'onboarding nella UI ospitata da Tapaya.

    Lo utilizzi quando i destinatari non sono noti in anticipo o quando desidera un flusso di acquisizione self-service scalabile. È Lei a decidere quando il link scade e può revocarlo al termine della campagna.

    **Come avviarlo:** Crei e gestisca il link di campagna dalla Tapaya Platform UI, oppure lo automatizzi tramite l'[API](/platform-api/merchant_onboarding).

    Nella barra laterale, espanda **Payments** e apra **Merchants**. Vada alla sezione **Campaign onboarding links**, quindi selezioni **Manage links**.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Opzione dei link di campagna per l'onboarding nella Tapaya Platform" src="__img5" />
    </div>

    Prima di condividere il link generato, assegni un nome alla campagna, ne imposti la data di scadenza e scelga la commissione.

    <div className="bg-background relative w-full overflow-hidden rounded-lg border [&>p]:m-0 [&_img]:m-0 [&_img]:block [&_img]:w-full">
            <img alt="Finestra di gestione dei link di campagna per l'onboarding" src="__img6" />
    </div>
  </TabsContent>
</Tabs>

## Chi è responsabile di cosa, nel complesso [#who-owns-what-overall]

Considerando tutti e quattro i flussi, ogni passaggio dell'onboarding spetta a una o più delle tre parti. Un passaggio spuntato due volte è un passaggio il cui responsabile dipende dal flusso scelto sopra.

<ResponsibilityMatrix
  rowHeader="Passaggio dell'onboarding"
  parties="[&#x22;tapaya&#x22;, &#x22;you&#x22;, &#x22;merchant&#x22;]"
  rows="[
  { label: &#x22;Scelta del flusso di onboarding&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Fornitura del modulo e delle regole di convalida&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Inserimento dei dati dell'attività, bancari e sulla proprietà&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
  { label: &#x22;Distribuzione di inviti e link di campagna&#x22;, owners: [&#x22;you&#x22;] },
  { label: &#x22;Consenso ai termini e all'Informativa sulla privacy di Tapaya&#x22;, owners: [&#x22;merchant&#x22;] },
  { label: &#x22;Invio della richiesta al processore&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Verifica della richiesta (KYB)&#x22;, owners: [&#x22;tapaya&#x22;] },
  { label: &#x22;Aggiornamento dei requisiti in linea con la normativa&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Monitoraggio dello stato della verifica&#x22;, owners: [&#x22;tapaya&#x22;, &#x22;you&#x22;] },
  { label: &#x22;Correzione dei dati rifiutati o mancanti&#x22;, owners: [&#x22;you&#x22;, &#x22;merchant&#x22;] },
]"
/>

## Dove la responsabilità è condivisa [#where-responsibility-is-shared]

* **Fornitura del modulo e delle regole di convalida:** Tapaya fornisce e mantiene il modulo per la Platform UI, gli inviti via email e i link di campagna. Se realizza una UI propria, il modulo è Suo e spetta a Lei mantenerne campi e convalida allineati ai requisiti vigenti.
* **Consenso ai termini e all'Informativa sulla privacy di Tapaya:** Tapaya presenta questi documenti nei propri flussi ospitati. Con una UI propria, deve presentare i link a entrambi i documenti e ottenere il consenso dell'esercente prima di inviarne i dati di onboarding tramite l'API. Deve inoltre indicare Tapaya come responsabile del trattamento dei dati nella Sua informativa sulla privacy.
* **Inserimento dei dati:** Nell'onboarding assistito tramite Platform UI li inserisce il Suo team. In tutti i flussi ospitati o self-service, l'esercente inserisce i propri.
* **Aggiornamento dei requisiti in linea con la normativa:** Tapaya aggiorna automaticamente i flussi ospitati. Con una UI propria, è Lei a seguire le modifiche ai [requisiti di onboarding tramite API](/platform-api/merchant_onboarding) e ad aggiornare il Suo modulo.
* **Monitoraggio dello stato della verifica:** Tapaya rende disponibile lo stato nella Platform UI, tramite `Accept.merchant.onboardingStatus()` nell'Accept SDK e tramite l'API. Agire di conseguenza spetta a Lei: solleciti l'esercente quando qualcosa manca o è stato rifiutato.
* **Correzione dei dati rifiutati o mancanti:** Chi ha inserito i dati li corregge. Per i flussi ospitati, ciò significa sollecitare l'esercente a inviarli di nuovo.

Per le responsabilità lungo l'intero ciclo di vita dell'esercente, e non solo durante l'onboarding, consulti [Responsabilità](./responsibilities).

## Stato della verifica [#verification-status]

Dopo che l'esercente ha inviato il modulo, il suo account entra in uno stato di revisione. Il processore di pagamento esamina la richiesta; di solito l'esame si conclude in pochi minuti, ma in alcuni casi può richiedere più tempo.

Un esercente non potrà elaborare transazioni finché il suo account non sarà verificato. Può controllarne lo stato in qualsiasi momento nella Tapaya Platform UI. Le integrazioni possono verificarlo anche con `Accept.merchant.onboardingStatus()` nell'Accept SDK o tramite l'API, e sollecitare l'esercente a inviare di nuovo i dati se risultano mancanti o rifiutati.