Collegamento di YooKassa (Yandex Kassa)

Requisiti per il collegamento

• Account su YooKassa (yookassa.ru)
• Status di imprenditore individuale, societa (OOO/AO) o lavoratore autonomo (per i privati senza status l'accettazione di pagamenti non e disponibile)
• Conto corrente collegato a YooKassa

YooKassa e disponibile su tutti i piani tikento, incluso Free.

Passo 1. Registrazione su YooKassa

Andate su yookassa.ru e create un account. Per ottenere l'accesso ai pagamenti di produzione sara necessario completare la verifica: caricare i documenti (per imprenditori individuali — passaporto e certificato, per societa — statuto e ordine di nomina).

La modalita di test (pagamenti di prova senza denaro reale) e disponibile subito dopo la registrazione senza verifica.

Passo 2. Creazione del negozio

Nel pannello di YooKassa:

1. Andate nella sezione Negozi.
2. Cliccate "Crea negozio".
3. Compilate i dati: nome, URL del sito (indicate app.tikento.com), descrizione dell'attivita.
4. Nella sezione "Metodo di connessione" selezionate Notifiche HTTP (non widget).
5. Salvate le impostazioni.

Passo 3. Ottenimento delle chiavi API

Nelle impostazioni del negozio creato:

1. Aprite la scheda "Chiavi API".
2. Copiate lo shopId — l'identificativo numerico del negozio (ad esempio, 123456).
3. Cliccate "Crea chiave segreta", inserite la conferma. Copiate la secretKey nel formato test_XXXX... (test) o live_XXXX... (produzione).

La chiave segreta viene mostrata una sola volta. Se la perdete, createne una nuova: quella precedente diventera non valida.

Passo 4. Configurazione in tikento

1. Aprite le Impostazioni della vostra organizzazione in tikento.
2. Andate nella sezione Pagamenti -> YooKassa.
3. Inserite shopId e secretKey.
4. Cliccate "Verifica connessione" — tikento effettuera una richiesta di test all'API di YooKassa.

Se la verifica ha esito positivo, apparira lo stato verde "Connesso".

Passo 5. Configurazione del webhook

Dopo la verifica riuscita, tikento mostrera l'URL del webhook per il vostro negozio (nel formato https://app.tikento.com/webhooks/yookassa/{shopId}).

Nelle impostazioni del negozio YooKassa:

1. Aprite "Notifiche HTTP".
2. Aggiungete l'URL del webhook.
3. Selezionate gli eventi per l'invio:
   • payment.succeeded — pagamento completato con successo
   • payment.canceled — pagamento annullato
   • refund.succeeded — rimborso completato

Passo 6. Test

Per il test utilizzate la chiave di test (inizia con test_). Carte di test YooKassa:

Scadenza — qualsiasi data futura, CVV — qualsiasi 3 cifre.

Passo 7. Passaggio alla modalita di produzione

Quando il test e completato con successo:

1. In YooKassa inviate la richiesta di passaggio alla modalita di produzione (pulsante nella dashboard del negozio).
2. Caricate i documenti necessari.
3. Dopo l'approvazione YooKassa inviera una notifica.
4. Sostituite la secretKey di test con quella di produzione nelle impostazioni di tikento.

L'approvazione richiede generalmente 1-3 giorni lavorativi per imprenditori individuali e 3-5 giorni per societa.