Scarica in formato docx, pdf o txt
Scarica in formato docx, pdf o txt
Sei sulla pagina 1di 3

STRIPE - RACCOGLIERE I PAGAMENTI E POI PAGARE

(https://stripe.com/docs/connect/collect-then-transfer-guide)

Raccogli i pagamenti dai clienti e pagali a venditori o fornitori di servizi.

Questa guida spiega come accettare pagamenti e trasferire fondi sui conti bancari dei tuoi
fornitori di servizi o venditori. A scopo dimostrativo, costruiremo un mercato per l'affitto di
case che colleghi i proprietari di case ai potenziali inquilini. Ti mostreremo anche come
accettare pagamenti dagli inquilini (clienti) e pagare i proprietari di case
(gli utenti della tua piattaforma).

Per vedere un flusso di onboarding completo, esamina la nostra integrazione Express


end-to-end di esempio.

PREREQUISITI

1. Registra la tua piattaforma.

1. Raccogli i pagamenti e poi paga


2. Consenti ad altre attività di accettare pagamenti direttamente
3. Aggiungi denaro e paga fornitori o fornitori di servizi

2. Aggiungi i dettagli dell'attività per attivare il tuo account.

3. Completa il profilo della tua piattaforma.

4. Personalizza le impostazioni del marchio. Per Connect Onboarding è necessario


aggiungere il nome dell'attività, l'icona e il colore del marchio.

IMPOSTA STRIPE

Installa le librerie ufficiali di Stripe per accedere all'API dalla tua applicazione:

# Install the PHP library via Composer


composer require stripe/stripe-php

CREA UN ACCOUNT CONNESSO

Quando un utente (venditore o fornitore di servizi) si registra sul tuo mercato, devi creare
un account utente corrispondente (denominato account connesso). Non puoi accettare
pagamenti e trasferire fondi sul conto bancario del tuo utente senza un account collegato.
Gli account connessi rappresentano i tuoi utenti nell'API Stripe e raccolgono le
informazioni necessarie per verificare l'identità dell'utente. Nel nostro esempio di affitto di
una casa, l'account collegato rappresenta il proprietario della casa.

1
Crea un account connesso Express e precompila le informazioni

Utilizzare l'API /v1/accounts per creare un account Express e impostare il tipo da


esprimere nella richiesta di creazione dell'account.

// Set your secret key. Remember to switch to your live


// secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
$stripe = new \Stripe\StripeClient('sk_test_51...');
$stripe->accounts->create(['type' => 'express']);

Se hai già raccolto informazioni per i tuoi account connessi, puoi precompilare tali
informazioni sull'oggetto account per l'utente e non verranno raccolte nuovamente nel
flusso di onboarding Connect. Tutte le informazioni sull'account possono essere
precompilate, comprese le informazioni sull'azienda o individuali, le informazioni
sull'account esterno e altro ancora.

Crea un collegamento all'account

Puoi creare un collegamento all'account chiamando l'API Account Links con i seguenti
parametri:

 account
 refresh_url
 return_url
 type = account_onboarding

// Set your secret key. Remember to switch to your live


// secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
$stripe = new \Stripe\StripeClient('sk_test_51Kn...');

$stripe->accountLinks->create(
[
'account' => 'acct_1032D82eZvKYlo2C',
'refresh_url' => 'https://example.com/reauth',
'return_url' => 'https://example.com/return',
'type' => 'account_onboarding',
]
);

Reindirizza il tuo utente all'URL di collegamento dell'account

La risposta alla tua richiesta di collegamenti all'account include un valore per l'URL della
chiave. Reindirizza a questo link per inviare il tuo utente nel flusso. Gli URL dell'API
Account Links sono temporanei e sono monouso, poiché garantiscono l'accesso alle
informazioni personali dell'utente dell'account connesso. Autenticare l'utente

2
nell'applicazione prima di reindirizzarlo a questo URL. Se desideri precompilare le
informazioni, devi farlo prima di generare il collegamento all'account. Dopo aver creato il
collegamento all'account per un account Express, non puoi leggere o scrivere informazioni
per l'account.

Non inviare e-mail, SMS o inviare in altro modo URL di


collegamento dell'account direttamente al tuo utente.

Reindirizza invece l'utente autenticato all'URL del collegamento


dell'account dall'applicazione della tua piattaforma.

Gestisci l'utente che torna sulla tua piattaforma

Connect Onboarding richiede di passare sia return_url che refresh_url per gestire
tutti i casi in cui l'utente viene reindirizzato alla tua piattaforma. È importante implementarli
correttamente per fornire la migliore esperienza al tuo utente.

Puoi utilizzare HTTP per return_url e refresh_url mentre sei in


modalità test (ad esempio, per testare con localhost), ma la
modalità live accetta solo HTTPS.

Assicurati di scambiare gli URL di test con gli URL HTTPS prima di
andare online.

return_url

Stripe invia un reindirizzamento a questo URL quando l'utente completa il flusso di


onboarding di Connect. Ciò non significa che tutte le informazioni siano state raccolte o
che non ci siano requisiti in sospeso sull'account. Ciò significa solo che il flusso è stato
inserito ed è uscito correttamente.

Nessuno stato viene passato attraverso questo URL. Dopo che un utente è stato
reindirizzato al tuo return_url, controlla lo stato del parametro details_submitted
sul suo account effettuando una delle seguenti operazioni:

 Ascolto dei webhook account.updated


 Chiamando l'API Accounts e ispezionando l'oggetto restituito

refresh_url

Stripe reindirizza l'utente a refresh_url in questi casi:

Potrebbero piacerti anche