# Getting started

# Overview

Per poter utilizzare il servizio TsPay si deve:

1. Lato azienda: attivare il servizio all'interno di Digital ed effettuare poi l'onboarding.
2. Lato applicativo integrante: configurare l'applicativo su NCS per ricevere le notifiche sulle operazioni effettuate.

#####  

##### Studio e Gestita

Nel caso di uno studio che vuole utilizzare i servizi di TsPay su una sua gestita, non è necessario che lo studia faccia l'onboarding, ma è sufficiente che estenda il servizio sulla gestita, e poi sia questa a fare l'onboarding su TsPay (riconducendosi quindi al caso precedente).

# Azienda: Attivazione e Onboarding

##### 1. Attivazione

Attivare il servizio all'interno di Digital, quindi entrare nella pagina di configurazione tramite la cta "Configura TS Pay" o tramite l'icona in alto a destra nella card:

[![tspay1.jpg](https://digital-docs.ts-paas.com/uploads/images/gallery/2021-09/scaled-1680-/iMV2bvKW52rplpm5-tspay1.jpg)](https://digital-docs.ts-paas.com/uploads/images/gallery/2021-09/iMV2bvKW52rplpm5-tspay1.jpg)

Una volta dentro, seguire la cta "Registra azienda" che reindirizzerà l'utente su TsPay per permettere l'onboarding.

##### 2. Onboarding

Atterrati su TsPay, fare login con l'utenza desiderata (o crearne una nuova) e procedere con l'onboarding.  
Per dettagli sull'onboarding **in ambiente di test** seguire i passaggi **dal punto 3 al punto 5 o 7** descritti [a questo link](https://ts-pay-docs.ts-paas.com/books/onboarding/page/onboarding-di-unazienda-in-ambiente-di-test).

##### 3. Finalizzazione (<span style="color: #ff0000;">solo test e dev</span>)

Una volta completato l'onboarding, in ambiente di test e dev il processo va finalizzato tramite una chiamata API: [qui dettagli](https://digital-docs.ts-paas.com/books/tspay-gateway/page/finalizzazione-onboarding). Se la chiamata va a buon fine si riceveranno due email, alla casella di posta dell'utente con cui ci si è loggati in TsPay:

1. Conferma di onboarding azienda, con codice titolare (merchant ref).
2. Conferma di creazione ApiKey, con link per l'attivazione della stessa.

##### 4. Attivazione ApiKey

Seguire il link ricevuto nella seconda email, per l'attivazione dell'ApiKey.

# Azienda: Finalizzazione Onboarding

##### <span style="color: #ff0000;">SOLO TEST E DEV</span>

Per finalizzare l'onboarding (step 3 di [questo processo](https://digital-docs.ts-paas.com/books/tspay-gateway/page/attivazione-e-onboarding)) va effettuata una chiamata ad uno dei due seguenti endpoint (sono alternativi):

1\. Utilizzando la session-key dell'onboarding appena concluso:

```
[PUT] /internal/helpers/finalizeonboarding/by-sessionkey/{onboardingSessionKey}
```

2\. Utilizzando l'itemUuid dell'azienda onboardata:

```
[PUT] /internal/helpers/finalizeonboarding/by-itemid/{itemId}
```

I due endpoint **NON** sono esposti dal pay-gateway ma dal servizio **ts-pay-config-write** e sono **disponibili solo in ambiente di test e dev**. Swagger:

- [DEV](https://ts-pay-config-write-dev.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/helper-apis-controller)
- [TEST](https://ts-pay-config-write-test.agyo.io/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config#/helper-apis-controller)

**Esito:** se la chiamata va a buon fine si riceveranno due email, alla casella di posta dell'utente con cui ci si è loggati in TsPay:

1. Conferma di onboarding azienda completato, con codice titolare (merchant ref).
2. Conferma di creazione ApiKey, con link per l'attivazione della stessa.