Domande e risposte su Checkout Flex e Checkout All‑in‑one

Qui è possibile consultare le risposte alle domande in merito a upgrade, transazioni, plug-in e molto altro ancora.

Panoramica

  • PostFinance Checkout offre diversi servizi di pagamento. Il fulcro è costituito dal tool di back office PostFinance Checkout, che consente di effettuare pagamenti tramite i nostri terminali di pagamento con carta PAX o i plug-in dello shop per l’e-commerce.

    Potete registrarvi gratuitamente in qualsiasi momento e testare la nostra soluzione in modalità simulazione. Registratevi su Il link si apre in una nuova finestra checkout.postfinance.ch.

    Se siete interessati ai nostri terminali di pagamento con carta PAX fisici, potete visitare il nostro terminal shop all’indirizzo Il link si apre in una nuova finestra terminal-shop.postfinance.ch.

    Cercate un plug-in di pagamento adatto al vostro shop e-commerce, visitate la nostra pagina GitHub Il link si apre in una nuova finestra github.com/pfpayments. Supportiamo sistemi di shop consolidati come WooCommerce, Shopify (integrazione diretta nello shop), Magento 2, Shopware, Prestashop, OXID, Gambio, OpenCart e molti altri. Con il nostro plug-in PostFinance Subscription per WooCommerce potete offrire nel vostro shop anche prodotti in abbonamento (pagamenti ricorrenti). Potete scaricare direttamente i plug-in e installarli nel vostro shop. In seguito potrete testare gratuitamente il nostro check-out.

    Per le integrazioni per sviluppi propri offriamo la PostFinance Checkout API e diversi SDK in diversi linguaggi di programmazione (PHP, Java, C#, Python, TypeScript ecc.). Consulti la nostra documentazione API su Il link si apre in una nuova finestra checkout.postfinance.ch.

    Tutti i link alla documentazione relativa ai plug-in e alle istruzioni dei terminali di pagamento con carta PAX sono disponibili su Il link si apre in una nuova finestra checkout.postfinance.ch/doc.

Top-5 Domande e risposte

  • PostFinance (PostFinance Pay, e-finance di PostFinance)
    E-mail: checkout@postfinance.ch, n. tel.: 0848 382 423 (in Svizzera max CHF 0.08/min)

    Wallee/Snapswap (Visa, Mastercard, TWINT, PostFinance Pay)
    E-mail: info@wallee.com, n. tel.: 044 505 13 60

    Worldline SIX (Visa, Mastercard, TWINT, China Union Pay, Diners)
    E-commerce
    E-Mail: cs.ecom@worldline.com, n. tel.: 0848 83 20 00
    Punto di vendita (POS)
    E-Mail: customerservice@worldline.com, n. tel.: 0848 83 20 00

    Concardis (Visa, Mastercard, Diners)
    E-mail: servicech@nets.eu, n. tel.: 058 220 58 58

    FirstData (Visa, Mastercard, Diners, JCB, China Union Pay)
    E-mail: fde-service@fiserv.com, n. tel.: 0800 550 014

    Swisscard (American Express)
    E-mail: partner.service@swisscard.ch, n. tel.: 044 659 64 44

    PowerPay (MF Group, pagamento dietro fattura)
    E-Mail: partner@mfgroup.ch, n. tel.: 058 806 06 31

    Boncard (WIR, Boncard, Swiss Pay, Gift Card, Lunch-Check, EKZ card)
    E-mail: pool@boncard.ch, n. tel.: 0848 080 408

    TWINT SA (TWINT)
    E-mail: support@twint.ch, n. tel.: 058 667 98 44

    PayPal
    Dati di contatto su Il link si apre in una nuova finestra paypal.com

  • La panoramica aggiornata e tutta la documentazione sono disponibili su Il link si apre in una nuova finestra checkout.postfinance.ch.
  • Il prodotto Checkout All-in-One si basa su un’offerta Collecting. Ciò significa che tutte le modalità di pagamento (PostFinance Pay, Visa, Mastercard e TWINT) vengono gestite tramite un contratto. Non è possibile aggiungere altri metodi di pagamento.

    Per il prodotto Checkout Flex, oltre all’offerta di collecting, avete a disposizione anche altre modalità di pagamento (ad es. American Express o criptovalute) e partner di accettazione. A tal fine è necessario stipulare un contratto separato con ogni partner di accettazione. Con Checkout Flex avete la possibilità di effettuare anche transazioni ricorrenti (ad es. abbonamenti).

    Potete iscrivervi gratuitamente in qualsiasi momento su Il link si apre in una nuova finestra checkout.postfinance.ch. Dopo aver creato l’account, selezionate il prodotto desiderato e avviate la modalità di simulazione gratuita.

  • Apple Pay è già supportato. Si prega di chiarire con il proprio Payment Service Provider se questo supporta la modalità di pagamento anche nell’elaborazione.

    Supportiamo anche le criptovalute (Bitcoin Suisse) con collegamento tramite il gestore Worldline.

    Checkout Flex viene costantemente sviluppato e ampliato. Le nuove modalità di pagamento disponibili sono consultabili su Il link si apre in una nuova finestra checkout.postfinance.ch. Qui potete vedere anche con quali partner di accettazione vengono supportate le diverse modalità di pagamento tramite noi.

  • Per configurare il terminale PAX è possibile seguire queste pratiche istruzioni.

Domande generali

  • L’errore 403 appare quando l’utente non dispone delle autorizzazioni necessarie. Chi possiede i diritti di amministratore può conferire ad altri collaboratori e collaboratrici l’accesso al proprio account creando profili utente e attribuendo loro le autorizzazioni e i ruoli necessari.

    Gli utenti che ne sono privi non possono accedere all’account di amministratore e visualizzano la pagina di errore «Accesso negato – Codice errore: 403» quando cercano di farlo.

    Pertanto, si prega di attribuire agli utenti i diritti di lettura corrispondenti a livello di spazio e account: sono condizioni necessarie per l’accesso.

    Il link si apre in una nuova finestra Documenatione Concetti di autorizzazione su checkout.postfinance.ch

  • Per prima cosa, è necessario verificare con quale modalità di pagamento è stata corrisposta l’ordinazione. Successivamente, è possibile rivolgersi al partner di accettazione competente (cfr. domanda di cui sopra «Quali sono le modalità di pagamento e i partner di accettazione autorizzati?»).
  • Durante la registrazione le è stato assegnato automaticamente un account. Se si trova nella panoramica del proprio account, in alto a sinistra compare un numero dopo il simbolo «#». Questo è il suo ID account univoco.

    Tramite il suo account sono collegati tutti i suoi spazi e il suo attuale abbonamento Checkout (Flex, All-in-One).

    I vostri spazi sono i link ai vostri plug-in di pagamento nei vostri shop o ai terminali di pagamento con carta PAX. Qui potete impostare tutto ciò che ha a che fare con la vostra attività quotidiana in relazione ai pagamenti:

    • Allestimento di metodi di pagamento
    • Link al plug-in di pagamento nei vostri sistemi di e-commerce o al vostro sviluppo personale programmato con la nostra REST API
    • Link ai terminali di pagamento con carta PostFinance Checkout PAX
    • Visualizzazione delle transazioni di pagamento e della relativa elaborazione (contabilizzazione, rimborsi, storni)
    • Altre funzioni

    Se vi trovate nel vostro spazio, vedrete l’ID dello spazio in alto a sinistra dopo il simbolo «#».

Abbonamento

  • È possibile richiedere il passaggio da All-in-one a Flex o viceversa a checkout@postfinance.ch. Inserite il vostro account ID e inviate un’e-mail dal vostro indirizzo e-mail registrato a Checkout.

  • In Checkout Back office è possibile disdire l’abbonamento in qualsiasi momento. Per farlo occorre accedere all’area riservata e selezionare Account > Piano > Annullare il piano.

    In seguito, il contratto verrà terminato alla sua prossima fatturazione (max 30 giorni).

  • Checkout All-in-One: nel prezzo sono inclusi due spazi. Consigliamo di utilizzare uno spazio per l’ambiente produttivo e il secondo per l’ambiente di test. Se desiderate utilizzare due shop online produttivi, dovete stipulare un ulteriore contratto di accettazione nel menu Organizzazione.

    Checkout Flex: due spazi / shop online sono inclusi nelle commissioni mensili. Pagando un canone mensile potete aprire un numero illimitato di spazi / shop online.

    Tenete presente che per ogni spazio devono essere allestiti nuovi contratti di accettazione per le modalità di pagamento desiderate.

  • L’attivazione dell’abbonamento PostFinance Checkout richiede 1–2 giorni lavorativi, non appena avete firmato il contratto online. Per farlo, clicchi su «Account» > «Piano» > «Attiva labbonamento Checkout».

    La durata dell’attivazione delle diverse modalità di pagamento dipende dal rispettivo partner di accettazione (Worldline, PostFinance, Wallee/Snapswap ecc.).

  • Le spese di attivazione nonché i costi mensili vengono sempre addebitati sul conto commerciale di PostFinance o sulla carta di credito.
  • No, in alternativa a un conto commerciale PostFinance, è possibile fornire una carta di credito svizzera ai fini dell’addebito delle commissioni. Il pagamento viene effettuato sul conto bancario desiderato di una banca svizzera.

Plugins

  • PostFinance monitora costantemente gli sviluppi della situazione di mercato ampliando al contempo la selezione di plug-in.
  • In questo caso, la prima cosa da fare è rivolgersi al proprio fornitore di software per shop. È possibile che un collegamento API sia già stato creato.

    In alternativa, si può integrare PostFinance Checkout mediante i Web Services REST API. Su Il link si apre in una nuova finestra checkout.postfinance.ch è disponibile una documentazione dettagliata.

    Ulteriori informazioni e consigli utili sull’argomento sono disponibili sul sito Il link si apre in una nuova finestra github.com/pfpayments.

  • Per i pagamenti tramite carta nel suo shop online Shopify utilizza il modulo E-Payment per Checkout.

    Il suo shop online viene collegato al modulo E-Payment per Checkout mediante un’app. Presto non sarà più possibile elaborare i pagamenti tramite l’app da lei utilizzata, perché Shopify non supporterà più l’interfaccia attuale. Per questo motivo, entro il 31 maggio 2024 dovrà passare alla nuova app di pagamento per Shopify, disponibile da subito nel suo back-end di Shopify.

    Il passaggio si effettua in pochi minuti, basta seguire le seguenti istruzioni:

    Il link si apre in una nuova finestra Istruzioni per il passaggio alla nuova PostFinance Checkout App per Shopify (PDF)

    Dopo il passaggio potrà usufruire della nostra nuova modalità di pagamento PostFinance Pay, che sostituisce le precedenti modalità PostFinance Card e PostFinance e-finance.

    In seguito a questa modifica necessaria, con la nuova app verrà applicata una commissione supplementare dello 0,3% sulle sue transazioni, che verrà addebitata tramite la modalità di pagamento registrata in PostFinance Checkout (conto PostFinance o carta di credito). Questa commissione ci viene fatturata da Shopify e non la trasferiamo ai nostri commercianti.

    Se ha già effettuato il passaggio alla nuova app di pagamento Shopify, non deve fare nulla.

    In caso di domande può rivolgersi alla nostra assistenza (checkout@postfinance.ch oppure 0848 382 423).

Sviluppo proprio tramite API/SDK

  • Success/Failed URL

    Gli URL Success/Failed vengono definiti sulla transazione prima di effettuare il pagamento sulla pagina dei pagamenti o su Lightbox/Iframe. A seconda delle transazioni andate a buon fine o non andate a buon fine, l’acquirente viene reindirizzato all’URL Success/Failed del vostro shop.

    Anche in base al metodo «Transaction Create» API/SDK (ancora prima dell’inoltro per il pagamento) è possibile estrarre l’ID transazione in Response e salvarlo temporaneamente nei propri sistemi (o tramite sessione), affinché l’ID transazione resti disponibile sulla Success/Failed Page dopo il pagamento del cliente. Ciò può essere utile se, ad esempio, si desidera elencare sulla pagina Success i dettagli della transazione per l’acquirente tramite il metodo API/SDK «Transaction Read».

    Webhook

    I webhook servono a inoltrare gli aggiornamenti di stato (ad es. delle transazioni) ai propri sistemi interni (ad es. il back-end del proprio shop o la propria applicazione ERP/CRM).

    Il webhook inviato alla vostra interfaccia di sistema contiene tra l’altro l’ID dell’entità (ad es. della transazione) e lo stato (ad es. dello stato della transazione) nel processo di firma del webhook.

    Ulteriori informazioni sui webhook sono disponibili su Il link si apre in una nuova finestra checkout.postfinance.ch.

  • Su Il link si apre in una nuova finestra checkout.postfinance.ch è disponibile una documentazione dettagliata.

  • Sì, per attivare l’opzione visitare la sezione «Canale di vendita tramite carte depositate».

    Informazioni più dettagliate ai fini dell’implementazione sono consultabili su Il link si apre in una nuova finestra checkout.postfinance.ch.

  • Lightbox

    L’utente inserisce i dettagli del pagamento in un overlay. Il modulo si sovrappone al sito del commerciante.

    Il link si apre in una nuova finestra Documentazione su Lightbox su checkout.postfinance.ch

    iFrame

    L’utente inserisce i dettagli del pagamento in un iFrame ospitato da noi. L’iFrame stesso può essere integrato nel sito web del commerciante.

    Il link si apre in una nuova finestra Documentazione sull’iFrame su checkout.postfinance.ch

  • Sì, può modificare individualmente la maschera di pagamento, i modelli di e-mail e i modelli di fattura.

    Per modifiche semplici, andare nel proprio spazio alla voce «Impostazioni» > «Personalizzazione» > «Impostazioni delle risorse». Potete apportare modifiche nelle schede «E-mail», «Web» (per le maschere di pagamento), «Documento» (per i modelli di fattura).

    Per modifiche più complesse, consultate il vostro spazio alla voce «Impostazioni» > «Personalizzazione» > «Editor risorse». Nell’editor potete personalizzare la maschera di pagamento (cartella «web»), i template delle e-mail (cartella «email») e le fatture (cartella «document») anche con un modello TWIG. Qui potete anche eliminare singoli elementi o aggiungerli individualmente, modificando il codice HTML & CSS (Style). Tramite il codice TWIG potete inoltre aggiungere variabili (ad es. proprietà di transazione di un pagamento) a un template.

    Si veda a tal proposito la nostra documentazione TWIG su Il link si apre in una nuova finestra checkout.postfinance.ch.

Terminali di pagamento PAX

  • I terminali possono essere ordinati esclusivamente su Il link si apre in una nuova finestra terminal-shop.postfinance.ch.

    1. Ordinare il terminale su Il link si apre in una nuova finestra terminal-shop.postfinance.ch
    2. Selezionare il prodotto e sottoscrivere l’abbonamento 
    3. Configurare il terminale nello spazio sul dashboard, inclusa la selezione dei metodi di pagamento desiderati
    4. Non appena almeno un partner di accettazione ha lo stato «Attivo», viene visualizzato un codice di attivazione nel suo account Checkout.
    5. Inserimento del codice di attivazione nel terminale
    6. Il terminale è pronto all’uso

    Ulteriori informazioni sulla configurazione del terminale sono disponibili su Il link si apre in una nuova finestra checkout.postfinance.ch.

    • PostFinance (PostFinance Card)
    • Worldline (Mastercard, Visa, Maestro, Vpay, TWINT, China Union Pay)
    • Swisscard (American Express)
    • Concardis (Mastercard, Visa, Maestro, Vpay)
    • Wallee/Snapswap (Visa, Mastercard, PostFinance Card, TWINT)
  • I nostri metodi di pagamento (PostFinance) vengono attivati di norma entro dieci giorni lavorativi. L’attivazione delle altre modalità di pagamento dipende dal rispettivo partner di accettazione.

  • Per poter attivare i terminali è necessario disporre di un PostFinance Checkout Flex o di un PostFinance Payment Flex. Inoltre, per il canone di abbonamento mensile vengono registrati un conto commerciale PostFinance o una carta di credito.

  • Nello spazio, alla voce «Configurazioni», è possibile configurare i terminali in base alle proprie esigenze. In queste impostazioni è possibile effettuare diverse modifiche, ad esempio relative alle configurazioni delle transazioni, alla stampa del giustificativo, all’intestazione della ricevuta o alla mancia.

Passaggio da PostFinance Card / PostFinance e-finance a PostFinance Pay per shop online

  • La procedura per l’attivazione di PostFinance Pay è disponibile, dopo aver effettuato il login con l’account personale, alla voce «Spazio» > «Attività manuali» nella relativa attività. Seguendo le istruzioni, è possibile eseguire il passaggio in pochi minuti.

    Per le istruzioni dettagliate rimandiamo al seguente documento:

    Il link si apre in una nuova finestra Istruzioni per l’attivazione di PostFinance Pay (PDF)

    Precisazione importante: non appena PostFinance Pay e le relative attività manuali saranno disponibili nel vostro back office (solo per commercianti con PSP Checkout), riceverete una lettera informativa. I commercianti con un PSP diverso otterranno le informazioni relative all’attivazione di PostFinance Pay in un secondo momento. La comunicazione verrà effettuata in funzione delle tempistiche del rispettivo PSP.

  • La procedura per la disattivazione delle attuali modalità di pagamento PostFinance è disponibile, dopo aver effettuato il login con l’account personale, alla voce «Spazio» > «Attività manuali» nella relativa attività. L’attività manuale appare automaticamente non appena viene completata l’attivazione di PostFinance Pay.

    Per le istruzioni dettagliate rimandiamo al seguente documento:

    Il link si apre in una nuova finestra Istruzioni per l’attivazione di PostFinance Pay e la disattivazione delle precedenti modalità di pagamento PostFinance (PDF)

    Precisazione importante: non appena PostFinance Pay e le relative attività manuali saranno disponibili nel vostro back office (solo per commercianti con PSP Checkout), riceverete una lettera informativa. I commercianti con un PSP diverso otterranno le informazioni relative all’attivazione di PostFinance Pay in un secondo momento. La comunicazione verrà effettuata in funzione delle tempistiche del rispettivo PSP.

  • Analogamente alle precedenti modalità di pagamento di PostFinance, PostFinance Pay supporta la registrazione della modalità di pagamento nello shop online (token PostFinance Pay) per i pagamenti ricorrenti e i pagamenti one touch. Le e gli acquirenti che si sono già registrati con la modalità di pagamento PostFinance Card nel vostro shop online verranno migrati automaticamente su PostFinance Pay e non dovranno registrarsi nuovamente, a condizione che la PostFinance Card registrata nell’alias sia ancora valida e che la o il cliente disponga di e-finance.

    Procedura tecnica per la migrazione dei token

    1. La migrazione dei token/alias viene avviata automaticamente in background con l’attivazione della nuova modalità PostFinance Pay nel back office del vostro Payment Service Provider (cfr. «Come posso attivare PostFinance Pay?»).
    2. La migrazione degli alias dura 24 ore. Pertanto, è importante che in questo arco di tempo le precedenti modalità di pagamento non vengano disattivate.

    Richiedere al vostro Payment Service Provider la nuova versione del token PostFinance Pay

    Affinché i token PostFinance Pay migrati vengano visualizzati correttamente dalla clientela nel vostro shop online, in qualità di commercianti dovete richiedere al vostro Payment Service Provider la nuova versione dei token PostFinance Pay per tutti gli alias (trigger request «Token Merchant Update») e presentarla di conseguenza alle e agli acquirenti. Nel caso di un alias per la PostFinance Card, la versione del token appare come un numero carta mascherato con data di scadenza e un’immagine URL del logo della PostFinance Card. Nel caso di un token PostFinance Pay, la versione del token viene visualizzata come un IBAN mascherato e contiene un’immagine URL del logo di PostFinance Pay.