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, il veicolo viene consegnato automaticamente. 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 applica alcuna commissione aggiuntiva sulle transazioni. La commissione di elaborazione del fornitore (PayTR o Stripe) riguarda te e lui, secondo le condizioni del tuo conto.

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 consegna il veicolo. 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 consegna 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 alla consegna

1Scegli Online

Scegli Online come metodo di pagamento nella schermata di consegna.

→

2Crea il link

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

→

3Consegna automatica

Appena arriva il pagamento, il veicolo viene consegnato automaticamente.

Il pulsante di consegna non compare mai prima che arrivino i soldi: non può esistere una consegna 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.

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.
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.