Collegare un conto di pagamento: Stripe e PayTR

Nell’app, Online è un quarto metodo di pagamento accanto a Contanti e Carta: mostri al cliente un link di pagamento o un codice QR e, appena arriva il pagamento, l’uscita del veicolo si completa da sola. Questa pagina spiega come collegare quel conto.

Dove vanno i soldi?

Direttamente sul tuo conto di pagamento. I soldi non passano mai da Tanrikulu Apps; Tanrikulu Apps non trattiene saldi e non prende commissioni.

Cliente

Inquadra il codice QR o tocca il link e paga con carta.

→

Stripe / PayTR

Il tuo conto esercente. Il pagamento è sul tuo conto.

→

Il tuo conto bancario

I soldi arrivano secondo il calendario di accredito del fornitore.

Cosa fa Tanrikulu Apps: l’app non muove mai i soldi; riceve dal fornitore solo l’avviso «pagato» e completa l’uscita. Per questo colleghi tu il conto e il pagamento viene incassato a tuo nome.

Prima di tutto, capisci la modalità test

La casella Modalità test (sandbox) nelle Impostazioni decide se stai davvero incassando. È l’impostazione più costosa da sbagliare.

Modalità test attiva

Nessuna chiave necessaria, puoi provare subito.
Il cliente sembra aver pagato.
Sul tuo conto non arriva nulla.
Solo per provare.

Modalità test disattivata (reale)

Colleghi il tuo conto.
Il cliente paga davvero.
I soldi arrivano sul tuo conto.
Questo è l’uso quotidiano.

L’app ti avvisa e chiede conferma prima di attivare la modalità test. Prima di incassare soldi veri, togli la spunta e collega il tuo conto.

Quale fa per te?

Fuori dalla Turchia

Stripe. PayTR serve solo attività con sede in Turchia.

In Turchia

PayTR. Stripe non apre conti ad attività turche.

Non ti servono entrambi: la schermata di uscita offre solo i fornitori che hai collegato.

Collegare Stripe

1Completa il conto

Crea un conto Stripe e completa i dati della tua attività; un conto incompleto non può incassare pagamenti reali.

→

2Copia la chiave segreta

Dashboard → Developers → API keys. Il valore che ti serve inizia con sk_.

→

3Incollala nell’app

Impostazioni → Conto di pagamento → Stripe → Collega

Stripe → Developers → API keys → sk_live_… → Impostazioni → Conto di pagamento → Stripe → Collega

I tipi di chiave e come custodirle in sicurezza sono spiegati nella pagina di Stripe: Chiavi API. Se la loro interfaccia cambia, quella pagina resta aggiornata.

La chiave si vede una sola volta. Stripe mostra una chiave segreta appena creata solo in quel momento; se la perdi, ne crei una nuova. Anche l’app, dopo il salvataggio, non mostra più la chiave: vedi solo il badge «Collegato».

Collegare PayTR

1Conto esercente

Fai domanda a PayTR; il pannello esercente si apre dopo l’approvazione.

→

2Permesso Link di pagamento

Si richiede a parte nel pannello. Un conto semplice da solo non può creare link.

→

3Inserisci tre valori

Prendili da Pannello → Informazioni e incollali nell’app.

Pannello PayTR → Informazioni → merchant id merchant key merchant salt → Impostazioni → Conto di pagamento → PayTR → Collega

PayTR spiega passo per passo la domanda e il passaggio alla modalità reale: Integrazione Link di pagamento (Payment Link).

Valute: il servizio di link di pagamento di PayTR accetta TRY, EUR, USD e GBP. Non può creare link per un’attività che lavora in un’altra valuta: lì usa Stripe. Per EUR/USD/GBP il tuo conto esercente PayTR deve avere anche un conto in quella valuta.

Cosa succede all’uscita

1Scegli Online

Scegli Online come metodo di pagamento nella schermata Uscita veicolo.

→

2Crea il link

Compare un codice QR; il cliente lo inquadra, oppure gli invii il link.

→

3L’uscita si completa da sola

Appena arriva il pagamento, l’uscita del veicolo si completa automaticamente.

Il pulsante di uscita non compare mai prima che arrivino i soldi: non può esistere un’uscita che sembra pagata ma non lo è. Gli incassi online stanno su una riga a parte nella cassa di fine giornata e nei report; non si uniscono mai a Carta, cioè ai soldi incassati con il tuo POS.

Anche per abbonati e saldi dei clienti

Online non è solo per l’uscita: compare come quarto metodo anche in Abbonati → Incassa e Clienti → Incassa. Mostri il codice QR e, appena arriva il pagamento, l’incasso viene registrato da solo e compare sulla riga Online della cassa. Il pulsante di incasso non compare prima che arrivino i soldi.

Pannello vetrina: quando all’uscita scegli Online e crei il link, il codice QR compare anche sul pannello TV («Inquadra con il telefono per pagare»), così il cliente vicino all’auto non deve guardare il telefono dell’addetto. Senza Online il pannello mostra il solito codice QR di monitoraggio.

Domande frequenti

«Impossibile creare il link di pagamento» — sullo schermo compare il motivo restituito dal fornitore. I due più comuni: il permesso per i link di pagamento non è ancora attivo, oppure una valuta che il fornitore non accetta.
Toccando Online dice che nessun conto è collegato — non ne hai ancora collegato uno. Vai in Impostazioni → Conto di pagamento e aggiungilo.
Online non compare affatto — l’elenco dei fornitori non è stato letto (di solito per la connessione). Torna appena c’è internet; nel frattempo Contanti e Carta funzionano.
Ho corretto la modalità ma il vecchio link continua a non funzionare — un link appartiene alla modalità (test/reale) in cui è stato creato. Dopo aver cambiato modalità riapri la schermata di uscita e viene creato automaticamente un link nuovo; altrimenti usa il pulsante Crea un nuovo link sotto la riga rossa. Un record già pagato non viene mai rinnovato.
Un pagamento è andato a buon fine ma i soldi non sono arrivati — forse la modalità test è ancora attiva. Togli la spunta nelle Impostazioni; la modalità reale usa il tuo conto.

Sulla sicurezza delle chiavi: le chiavi non vengono mai scaricate sul telefono né salvate nell’app; sono conservate cifrate sul server. Tanrikulu Apps non ha mai bisogno di chiedertele: le inserisci tu nella tua schermata delle impostazioni.