Pagamenti e negozi

Per: pagamenti singoli e abbonamenti, su una pagina di checkout ospitata da Stripe. Gli acquirenti non digitano mai un numero di carta nella tua app.

Si collega con: il pulsante Set up Stripe. Compili il modulo di Stripe e torni indietro, e non ti viene mostrata nessuna chiave. Pubblica prima l’app, perché Stripe guarda il sito live e rifiuta uno ancora in costruzione. Ti chiede un documento d’identità e un conto bancario. Puoi usare invece le chiavi: la publishable key (inizia con pk_) e la secret key (inizia con sk_) dalle tue chiavi API di Stripe, e un webhook signing secret (inizia con whsec_).

Solo con chiavi incollate: la scheda di Stripe mostra l’indirizzo webhook da aggiungere in Stripe, con un pulsante per copiarlo. Aggiungilo per gli eventi checkout.session.completed e checkout.session.async_payment_succeeded. Con il pulsante non c’è nessun webhook da configurare.

Cosa chiedere:

• “Aggiungi un pulsante Buy now per il corso”
• “Aggiungi un piano mensile e un pulsante Manage billing”
• “Aggiungi una pagina My orders”

Cosa succede: gli ordini vengono scritti quando Stripe dice che un pagamento è andato a buon fine, e compaiono sotto Manage, poi Payments. Vedi Negozi online.

Limiti: un’app può avviare un checkout, rileggerlo e leggere il tuo listino prezzi. Rimborsi, clienti e pagamenti ai conti bancari non sono raggiungibili da un’app. Rimborsa da Manage, poi Payments, oppure in Stripe. Manage billing funziona solo per una persona che ha effettuato l’accesso e ha comprato qualcosa in quell’app.

Per: pagamenti e abbonamenti in cui Paddle vende come venditore, quindi IVA e imposte sulle vendite sono gestite per te. Conviene quando vendi oltre i confini.

Si collega con: chiavi, dalla pagina di autenticazione di Paddle.

• Client-side Token (inizia con live_, o test_ per la sandbox). Pubblico per natura, quindi è incorporato nell’app pubblicata.
• API Key (inizia con pdl_live_apikey_ o pdl_test_apikey_). Resta sui server di Setherion.
• Webhook Secret (inizia con pdl_ntfset_). Facoltativo.

Cosa chiedere:

• “Aggiungi un piano Pro con un pulsante Subscribe che apre il checkout di Paddle”
• “Mostra il prezzo e cosa è incluso prima che si apra il checkout”

Come funziona: il checkout si apre nell’overlay di Paddle, nel browser del visitatore. Crei i tuoi prezzi nella dashboard di Paddle e l’app li usa tramite il loro id pri_. La pagina non invia mai un importo, perché chiunque apra la pagina può modificarlo.

Limiti: la API key non viene usata dall’app pubblicata, che non ha un server. Un token che inizia con test_ funziona solo con la sandbox di Paddle. Test connection legge un prodotto dal tuo account Paddle.

Per: un pulsante Buy per un solo articolo a prezzo fisso. Il prezzo, le imposte e la spedizione stanno in PayPal, quindi chi apre la pagina non può cambiare quanto paga. Gli acquirenti pagano nella finestra di PayPal, con PayPal o con carta.

Si collega con: due valori.

• Client ID: in PayPal, apri Pay links and buttons, poi un pulsante, poi il suo codice. È il valore dopo client-id=. Pubblico per natura.
• Currency: tre lettere, come GBP o EUR, le stesse dei tuoi pulsanti in PayPal.

Crea prima i tuoi pulsanti, nella pagina dei pulsanti di PayPal.

Cosa chiedere:

• “Aggiungi un pulsante Buy di PayPal per ciascuna delle tre stampe”
• “Metti il pulsante di PayPal sotto il prezzo nella pagina del prodotto”

Limiti: ogni pulsante compra un solo articolo al prezzo impostato in PayPal. Non c’è un carrello. La tua app non viene avvisata quando qualcuno paga: PayPal manda un’e-mail a te e all’acquirente, e la vendita non viene registrata nell’app. Per un carrello, ordini conservati nella tua app o abbonamenti, collega invece Stripe o Paddle. Lo dice anche la pagina del connettore.

Per: la fatturazione degli abbonamenti. Un pulsante Subscribe apre il checkout ospitato di Chargebee, un pulsante Manage billing apre il portale clienti, e il tuo team può vedere clienti, abbonamenti e fatture.

Si collega con: chiavi.

• Site name: la parte prima di .chargebee.com nell’indirizzo della tua dashboard, in minuscolo.
• API key: in Chargebee, Settings, poi Configure Chargebee, poi API Keys, poi Add API Key. Scegli una Write Key (crea, legge e aggiorna, non elimina mai). È tutto ciò che serve a un’app.

Cosa chiedere:

• “Aggiungi una pagina dei prezzi dai miei piani Chargebee, con un pulsante Subscribe su ciascuno”
• “Aggiungi un pulsante Manage billing per i clienti che hanno effettuato l’accesso”
• “Crea una pagina per il team con i miei abbonamenti e le fatture non pagate”

Chi può fare cosa: i visitatori possono avviare un checkout, aprire il portale di fatturazione e leggere i piani e i prezzi in vendita, per una pagina dei prezzi. Clienti, abbonamenti e fatture, e modificare piani e prezzi, sono riservati al tuo team. Segna gli account che sono il tuo team in Manage, poi Cloud, poi Users.

Limiti: usa Chargebee Product Catalog 2.0, quindi i piani sono item price. Gli importi arrivano in pence o centesimi. Da un’app non è possibile eliminare. In Permissions puoi disattivare il checkout, il portale, o la lettura e la modifica di clienti, abbonamenti, fatture, piani e prezzi, uno per uno.

Per: una nuova vetrina sopra un negozio Shopify. Prodotti, prezzi e scorte restano in Shopify, e gli acquirenti pagano nella pagina di checkout di Shopify.

Si collega con: due valori.

• Store domain: l’indirizzo .myshopify.com, anche se il tuo negozio mostra ai clienti un dominio personalizzato.
• Storefront API token (public): nell’admin di Shopify, apri Sales channels, poi Headless, poi Create storefront. Copia il suo public access token.

Non usare mai il token della Admin API (inizia con shpat_): la scheda lo rifiuta, perché questo token è incorporato nell’app pubblicata e chiunque può leggerlo.

Cosa chiedere:

• “Una nuova vetrina per il mio negozio Shopify, con le collezioni nella home page”
• “Aggiungi un carrello che manda i clienti al checkout di Shopify”
• “Aggiungi ricerca e filtri sui miei prodotti Shopify”

Permessi: Shopify è diverso. Le tue app lo chiamano direttamente dalla pagina con il token pubblico, quindi in Setherion non ci sono interruttori. Imposta i limiti in Shopify: Sales channels, Headless, la tua vetrina, poi Manage accanto a Storefront API, poi Permissions. Valgono per ogni vetrina del canale Headless.

Limiti: scorte, ordini e pagamenti restano in Shopify. Se un articolo è esaurito, l’app dice cosa è cambiato prima di mandare avanti il cliente.

Per: una vetrina che mostra i tuoi veri prodotti WooCommerce e manda gli acquirenti al tuo checkout.

Si collega con: chiavi.

• Shop address: l’indirizzo su cui gira il tuo negozio, quello con /wp-admin dietro.
• Consumer key (inizia con ck_) e Consumer secret (inizia con cs_): in WooCommerce, apri Settings, poi Advanced, poi REST API, poi Add key, con Permissions impostato su Read.

Entrambe le chiavi restano sui server di Setherion.

Cosa chiedere:

• “Mostra i miei prodotti WooCommerce in una griglia con un pulsante Buy su ciascuno”
• “Aggiungi una pagina per ogni prodotto con le sue foto e il prezzo”

Limiti: i prodotti sono l’unica cosa che un’app può leggere. Ordini e clienti vengono rifiutati, quindi qui non ci sono cronologia degli ordini né account cliente. L’acquisto avviene nel tuo negozio: il pulsante manda l’acquirente al tuo checkout con il prodotto aggiunto. I prezzi arrivano nella valuta del negozio, come li dà il negozio. Test connection legge un prodotto.

Per: una vetrina che mostra i tuoi veri prodotti PrestaShop e manda gli acquirenti alla pagina di ciascun prodotto nel tuo negozio.

Si collega con: chiavi.

• Shop address: l’indirizzo su cui gira il tuo negozio, quello con /admin dietro.
• Webservice key: 32 lettere e cifre. In PrestaShop, apri Advanced Parameters, poi Web service, poi Add new webservice key, e spunta View (GET) su products.

La chiave resta sui server di Setherion.

Cosa chiedere:

• “Mostra i miei prodotti PrestaShop con le loro foto e i prezzi”
• “Collega ogni prodotto alla sua pagina nel mio negozio”

Limiti: i prodotti sono l’unica cosa che un’app può leggere. Ordini e clienti vengono rifiutati, e le quantità in magazzino non sono disponibili, quindi l’app non mostra badge “in stock”. I prezzi di PrestaShop sono al netto delle imposte, e l’app li indica così. Gli acquirenti vengono mandati alla pagina del prodotto nel tuo negozio, non direttamente a un carrello.