Come impostare un gateway di pagamento personalizzato
Guida per gli sviluppatori all'integrazione di un gateway di pagamento personalizzato con Tilda
Tilda è integrato con i più diffusi sistemi di pagamento come Stripe, PayPal e 2Checkout. Ecco come integrare un sistema di pagamento personalizzato con il vostro sito web utilizzando il gateway di pagamento personalizzato.
Tutti i modelli di integrazione approvati e testati sono disponibili nell'elenco pubblico dei modelli. Tutte le integrazioni sono state create dagli sviluppatori dei sistemi di pagamento. Quando si seleziona un modello, è possibile trovare un link alla documentazione del sistema di pagamento e l'indirizzo e-mail degli sviluppatori per le domande sull'integrazione. Tilda L'assistenza non è in grado di rispondere a domande relative a integrazioni di terzi.
- ArsenalPay https://arsenalpay.ru/
- Best2Pay - https://best2pay.net
- PSCB - https://pscb.ru
- ENOTio - https://enot.io
- Express-pay - https://express-pay.by
- Prodamus - https://payform.ru
- CapustaSpace - https://capusta.space
- EPAY Halyk Bank - https://epay.kkb.kz
- UCS - https://ucscards.ru
- Paymo - https://paymo.ru
- PayOnline - https://www.payonline.ru
- Retribuzione netta - https://netpay.ru
- Intercards - https://intercards.ru
- Addetto ai pagamenti - https://paykeeper.ru/
- IPS - https://ips.su/ru_RU/
- Unitpay https://unitpay.ru/
- Invoicebox https://www.invoicebox.ru/ru/
- Express-pay - https://express-pay.by
- Modulbank - https://modulbank.ru
- Fondy - https://fondy.ru/
- Concordpay - https://pay.concord.ua/
- Monopay https://monobank.ua/
- Payboxmoney https://paybox.money/
Per impostare un'integrazione completa con un gateway di pagamento personalizzato, accedere a Impostazioni del sito → Sistemi di pagamento e selezionare "Gateway di pagamento personalizzato".
Importante: Se tra i modelli di soluzione di pagamento non c'è quello che fa per voi, contattate il team di sviluppatori del sistema di pagamento e inviate loro un link a questa guida. La creazione di un nuovo modello richiede la partecipazione degli sviluppatori.
È possibile selezionare un modello di integrazione o crearne uno personalizzato.
I modelli sono le preimpostazioni dei parametri per l'integrazione di un particolare sistema. Possono includere impostazioni non modificabili, come l'URL API o il campo del numero d'ordine, e impostazioni modificabili ("Impostazioni avanzate").
Se tra le opzioni si trova un modello per la propria soluzione di pagamento, significa che gli sviluppatori ci hanno contattato e che è possibile impostare facilmente l'integrazione con il proprio sistema di pagamento.
I modelli sono le preimpostazioni dei parametri per l'integrazione di un particolare sistema. Possono includere impostazioni non modificabili, come l'URL API o il campo del numero d'ordine, e impostazioni modificabili ("Impostazioni avanzate").
Se tra le opzioni si trova un modello per la propria soluzione di pagamento, significa che gli sviluppatori ci hanno contattato e che è possibile impostare facilmente l'integrazione con il proprio sistema di pagamento.
Si prega di notare che Tilda Publishing non si assume alcuna responsabilità per il funzionamento e la sicurezza di qualsiasi integrazione di sistemi di pagamento di terze parti.
Leggi il Disclaimer ufficialedi responsabilità →
Leggi il Disclaimer ufficialedi responsabilità →
ESCLUSIONE DI RESPONSABILITÀ
Esprimendo l'intenzione di integrarsi con il servizio Gateway di pagamento personalizzato (di seguito - Gateway CP) e/o eseguendo le azioni per la connessione e l'ulteriore utilizzo della risorsa di pagamento selezionata (di seguito - Sistema di pagamento), la persona giuridica o l'imprenditore individuale che ha inviato una richiesta di integrazione (di seguito - Richiedente) e l'Utente della Piattaforma editoriale Tilda (di seguito - Utente) confermano con la presente di essere d'accordo con quanto segue:
1. L'Amministrazione della Piattaforma editoriale Tilda (di seguito - l'Amministrazione) fa del suo meglio per fornire agli Utenti informazioni accurate e affidabili.
1.1. L'Amministrazione non è responsabile del controllo della legittimità delle informazioni fornite dai Richiedenti e della determinazione dei loro diritti e/o obblighi legali. L'Amministrazione non è responsabile del controllo della legittimità delle informazioni fornite dai Richiedenti, né della determinazione dei loro diritti e/o obblighi legali.
1.2. Con l'invio della domanda di integrazione, il Richiedente garantisce e conferma di avere lo status giuridico necessario e sufficiente per svolgere le attività di esecuzione di operazioni di pagamento specificate nella domanda, comprese le necessarie autorizzazioni richieste dalla legislazione nazionale.
1.3. Il Richiedente garantisce la legittimità delle informazioni fornite dall'Amministrazione e la determinazione dei loro diritti e/o obblighi legali. Il Richiedente garantisce la legittimità dell'utilizzo del sistema di pagamento richiesto e conferma che la sua integrazione e il suo ulteriore utilizzo non violano i diritti e gli interessi legittimi di terzi, compresi i diritti sui risultati dello sforzo intellettuale.
2. In conformità con la legge applicabile, l'Amministrazione rinuncia a qualsiasi garanzia, la cui fornitura può essere altrimenti implicita, e responsabilità in relazione all'utilizzo dei sistemi di pagamento integrati con il Gateway CP.
2.1. L'Amministrazione della Piattaforma non garantisce l'utilizzo di sistemi di pagamento integrati con il Gateway CP. L'Amministrazione della Piattaforma non garantisce la sicurezza dell'utilizzo dei sistemi di pagamento e il loro continuo funzionamento.
2.2. L'Amministrazione della Piattaforma fornisce solo le capacità informatiche necessarie che consentono di integrare uno o più sistemi di pagamento con il Gateway CP ai fini del loro ulteriore utilizzo da parte degli Utenti della Piattaforma per i loro progetti.
2.3. L'Amministrazione non è soggetto o parte in causa nel processo di integrazione dei sistemi di pagamento con il Gateway CP. L'Amministrazione non è un soggetto o una parte interessata nei rapporti che sorgono tra il Richiedente, l'Utente della Piattaforma e terze parti.
2.4. L'Amministrazione della Piattaforma non è responsabile dei rapporti tra il Richiedente e l'Utente della Piattaforma. L'Amministrazione della Piattaforma non è responsabile per:
a) qualsiasi azione e/o inazione dei fornitori di servizi, reti, software o attrezzature;
b) qualsiasi danno (danno diretto/indiretto, perdita di profitti) che possa verificarsi a seguito dell'utilizzo dei sistemi di pagamento, inclusi, ma non limitati a, danni ai dispositivi e ai supporti di memorizzazione delle informazioni e/o al software di qualsiasi Utente, nonché alla sospensione delle loro attività commerciali.
3. L'Utente è l'unico responsabile dei propri progetti.L'Utente è l'unico responsabile della scelta e dell'ulteriore utilizzo di un sistema di pagamento, nonché di qualsiasi attività associata al commercio elettronico.
3.1. L'Utente è responsabile della conformità con il sistema di pagamento. L'Utente è responsabile del rispetto di tutte le leggi ad esso applicabili e delle sue attività in proprio.
3.2. L'Utente accetta che l'utilizzo del sistema di pagamento da lui selezionato possa essere soggetto a commissioni aggiuntive.
3.3. L'Utente utilizza il sistema di pagamento da lui selezionato esclusivamente a proprio rischio e responsabilità, tenendo conto che può essere soggetto a termini e condizioni legali e finanziarie che regolano le attività dei richiedenti e che si raccomanda all'Utente di conoscere prima di utilizzare il sistema di pagamento selezionato.
4. In conformità con i requisiti di legge/le richieste (notifiche, reclami) delle autorità competenti e/o dei loro funzionari, l'Amministrazione della Piattaforma ha il diritto di sospendere o bloccare in qualsiasi momento l'accesso a qualsiasi sistema di pagamento o di cancellarlo dal Gateway CP, indipendentemente dal fatto che il sistema di pagamento in questione sia collegato al progetto dell'Utente in un determinato momento, senza alcun obbligo nei confronti dell'Utente stesso e/o dei suoi clienti.
1. L'Amministrazione della Piattaforma editoriale Tilda (di seguito - l'Amministrazione) fa del suo meglio per fornire agli Utenti informazioni accurate e affidabili.
1.1. L'Amministrazione non è responsabile del controllo della legittimità delle informazioni fornite dai Richiedenti e della determinazione dei loro diritti e/o obblighi legali. L'Amministrazione non è responsabile del controllo della legittimità delle informazioni fornite dai Richiedenti, né della determinazione dei loro diritti e/o obblighi legali.
1.2. Con l'invio della domanda di integrazione, il Richiedente garantisce e conferma di avere lo status giuridico necessario e sufficiente per svolgere le attività di esecuzione di operazioni di pagamento specificate nella domanda, comprese le necessarie autorizzazioni richieste dalla legislazione nazionale.
1.3. Il Richiedente garantisce la legittimità delle informazioni fornite dall'Amministrazione e la determinazione dei loro diritti e/o obblighi legali. Il Richiedente garantisce la legittimità dell'utilizzo del sistema di pagamento richiesto e conferma che la sua integrazione e il suo ulteriore utilizzo non violano i diritti e gli interessi legittimi di terzi, compresi i diritti sui risultati dello sforzo intellettuale.
2. In conformità con la legge applicabile, l'Amministrazione rinuncia a qualsiasi garanzia, la cui fornitura può essere altrimenti implicita, e responsabilità in relazione all'utilizzo dei sistemi di pagamento integrati con il Gateway CP.
2.1. L'Amministrazione della Piattaforma non garantisce l'utilizzo di sistemi di pagamento integrati con il Gateway CP. L'Amministrazione della Piattaforma non garantisce la sicurezza dell'utilizzo dei sistemi di pagamento e il loro continuo funzionamento.
2.2. L'Amministrazione della Piattaforma fornisce solo le capacità informatiche necessarie che consentono di integrare uno o più sistemi di pagamento con il Gateway CP ai fini del loro ulteriore utilizzo da parte degli Utenti della Piattaforma per i loro progetti.
2.3. L'Amministrazione non è soggetto o parte in causa nel processo di integrazione dei sistemi di pagamento con il Gateway CP. L'Amministrazione non è un soggetto o una parte interessata nei rapporti che sorgono tra il Richiedente, l'Utente della Piattaforma e terze parti.
2.4. L'Amministrazione della Piattaforma non è responsabile dei rapporti tra il Richiedente e l'Utente della Piattaforma. L'Amministrazione della Piattaforma non è responsabile per:
a) qualsiasi azione e/o inazione dei fornitori di servizi, reti, software o attrezzature;
b) qualsiasi danno (danno diretto/indiretto, perdita di profitti) che possa verificarsi a seguito dell'utilizzo dei sistemi di pagamento, inclusi, ma non limitati a, danni ai dispositivi e ai supporti di memorizzazione delle informazioni e/o al software di qualsiasi Utente, nonché alla sospensione delle loro attività commerciali.
3. L'Utente è l'unico responsabile dei propri progetti.L'Utente è l'unico responsabile della scelta e dell'ulteriore utilizzo di un sistema di pagamento, nonché di qualsiasi attività associata al commercio elettronico.
3.1. L'Utente è responsabile della conformità con il sistema di pagamento. L'Utente è responsabile del rispetto di tutte le leggi ad esso applicabili e delle sue attività in proprio.
3.2. L'Utente accetta che l'utilizzo del sistema di pagamento da lui selezionato possa essere soggetto a commissioni aggiuntive.
3.3. L'Utente utilizza il sistema di pagamento da lui selezionato esclusivamente a proprio rischio e responsabilità, tenendo conto che può essere soggetto a termini e condizioni legali e finanziarie che regolano le attività dei richiedenti e che si raccomanda all'Utente di conoscere prima di utilizzare il sistema di pagamento selezionato.
4. In conformità con i requisiti di legge/le richieste (notifiche, reclami) delle autorità competenti e/o dei loro funzionari, l'Amministrazione della Piattaforma ha il diritto di sospendere o bloccare in qualsiasi momento l'accesso a qualsiasi sistema di pagamento o di cancellarlo dal Gateway CP, indipendentemente dal fatto che il sistema di pagamento in questione sia collegato al progetto dell'Utente in un determinato momento, senza alcun obbligo nei confronti dell'Utente stesso e/o dei suoi clienti.
Se il sistema di pagamento non è presente nell'elenco, è necessario contattare gli sviluppatori della soluzione di pagamento affinché ne richiedano la creazione.
Per avviare la procedura, è necessario specificare il nome e l'URL del sistema di pagamento a cui l'utente deve essere reindirizzato con una richiesta POST per completare il pagamento, un'e-mail di contatto e qualsiasi informazione aggiuntiva che possa aiutare nell'integrazione, come ad esempio i link alla documentazione del sistema di pagamento.
Per avviare la procedura, è necessario specificare il nome e l'URL del sistema di pagamento a cui l'utente deve essere reindirizzato con una richiesta POST per completare il pagamento, un'e-mail di contatto e qualsiasi informazione aggiuntiva che possa aiutare nell'integrazione, come ad esempio i link alla documentazione del sistema di pagamento.
Importante: La creazione di un nuovo modello richiede una conoscenza approfondita dell'integrazione e della programmazione dei gateway di pagamento. Per creare un modello, è necessario essere uno sviluppatore di soluzioni di pagamento o avere una conoscenza approfondita dei dettagli dell'integrazione.
Non appena il team di moderazione approva il modello, questo diventa disponibile nell'elenco per un progetto specifico. Successivamente, è possibile modificare le impostazioni aggiuntive, cambiare i nomi delle variabili passate con gli ordini dei clienti ed eseguire il debug dell'integrazione.
Per prima cosa, è necessario specificare i nomi di tutti i campi critici e obbligatori i cui dati devono essere passati insieme agli ordini dei clienti e modificare le impostazioni aggiuntive come caso, formato e lunghezza del campo.
Per prima cosa, è necessario specificare i nomi di tutti i campi critici e obbligatori i cui dati devono essere passati insieme agli ordini dei clienti e modificare le impostazioni aggiuntive come caso, formato e lunghezza del campo.
Dopo aver configurato i campi obbligatori, potrebbe essere necessario specificare altre variabili passate al momento della creazione di un ordine. È possibile aggiungerle nella sezione "Elenco campi aggiuntivi". Il numero di voci dell'elenco dipende dalle esigenze di integrazione.
È inoltre necessario impostare la firma dell'ordine e specificare le regole per la sua formazione (i campi esclusi, il principio di ordinamento, il delimitatore e l'algoritmo di crittografia).
Per prima cosa, è necessario selezionare le regole della firma o selezionare "Tutti i campi" e specificare i campi esclusi, il principio di ordinamento e il delimitatore. Se è necessario un formato di dati personalizzato, selezionare "Regole speciali" e impostare le regole del formato personalizzato.
Per prima cosa, è necessario selezionare le regole della firma o selezionare "Tutti i campi" e specificare i campi esclusi, il principio di ordinamento e il delimitatore. Se è necessario un formato di dati personalizzato, selezionare "Regole speciali" e impostare le regole del formato personalizzato.
Successivamente, è necessario configurare l'indicatore di pagamento riuscito (il nome e il valore del parametro) e specificare cosa il sistema deve restituire in risposta ai pagamenti riusciti o rifiutati.
Formato dell'interazione
1. L'acquirente aggiunge un prodotto al carrello, compila il modulo e fa clic su Checkout.
2. Tilda riceve una richiesta di salvataggio del nuovo ordine e restituisce una serie di parametri che saranno inclusi nella richiesta per il sistema di pagamento seguendo l'elenco dei campi di mappatura e l'elenco dei campi aggiuntivi dalle impostazioni avanzate dell'integrazione.
2. Tilda riceve una richiesta di salvataggio del nuovo ordine e restituisce una serie di parametri che saranno inclusi nella richiesta per il sistema di pagamento seguendo l'elenco dei campi di mappatura e l'elenco dei campi aggiuntivi dalle impostazioni avanzate dell'integrazione.
Importante: tra i parametri, deve sempre esserci un campo contenente la firma dell'ordine. La firma viene generata dai valori degli altri campi utilizzando un algoritmo specifico e la chiave di pagamento. È possibile configurare questo algoritmo nella sezione "Firma dell'ordine" delle impostazioni avanzate dell'integrazione.
L'utente viene reindirizzato all'URL API del modello. I parametri vengono trasferiti con il metodo POST.
Il sistema di pagamento elabora i parametri e, se la firma è corretta, visualizza il modulo di pagamento, elabora il pagamento e comunica con altri sistemi, se necessario.
Il sistema di pagamento può reindirizzare l'utente alla pagina di successo dopo il pagamento (se specificato nelle impostazioni) o inviare una notifica.
Il sistema di pagamento deve anche inviare una richiesta all'URL di notifica, un URL del server Tilda dedicato. Questa richiesta deve anche trasferire i parametri e la firma utilizzando il metodo POST (gli algoritmi di firma possono essere diversi). Nelle impostazioni avanzate, è necessario aggiungere anche un campo (e specificarne il valore) utilizzato per verificare lo stato del pagamento, che sarà un indicatore di pagamento andato a buon fine.
L'ordine sarà contrassegnato come pagato su Tilda solo dopo che una richiesta con la firma corretta, il numero d'ordine, l'importo e l'indicatore di pagamento andato a buon fine sarà stata inviata all'URL di notifica.
Il sistema di pagamento elabora i parametri e, se la firma è corretta, visualizza il modulo di pagamento, elabora il pagamento e comunica con altri sistemi, se necessario.
Il sistema di pagamento può reindirizzare l'utente alla pagina di successo dopo il pagamento (se specificato nelle impostazioni) o inviare una notifica.
Il sistema di pagamento deve anche inviare una richiesta all'URL di notifica, un URL del server Tilda dedicato. Questa richiesta deve anche trasferire i parametri e la firma utilizzando il metodo POST (gli algoritmi di firma possono essere diversi). Nelle impostazioni avanzate, è necessario aggiungere anche un campo (e specificarne il valore) utilizzato per verificare lo stato del pagamento, che sarà un indicatore di pagamento andato a buon fine.
L'ordine sarà contrassegnato come pagato su Tilda solo dopo che una richiesta con la firma corretta, il numero d'ordine, l'importo e l'indicatore di pagamento andato a buon fine sarà stata inviata all'URL di notifica.
Come personalizzare i campi
Per rendere più facile agli utenti capire a quali campi del sistema di pagamento Tilda corrisponde, vi offriamo la possibilità di rinominare alcuni campi e tooltip nella sezione "Impostazioni del modulo" delle impostazioni avanzate.
Come eseguire il debug di un'integrazione
Per eseguire il debug di un'integrazione, creare una pagina e configurarla secondo la guida Come impostare un carrello: Aggiungere il carrello e il blocco prodotti alla pagina e pubblicarla.
Suggeriamo di effettuare un pagamento di prova e verificare che il pagamento vada a buon fine. Se tutto va bene, contattate il team di moderazione e il vostro modello sarà aggiunto all'elenco pubblico.
Suggeriamo di effettuare un pagamento di prova e verificare che il pagamento vada a buon fine. Se tutto va bene, contattate il team di moderazione e il vostro modello sarà aggiunto all'elenco pubblico.
