Stripe Connect e l'API Charges

Scopri come Connect ti consente di effettuare addebiti e trasferimenti su account connessi. Le commissioni Stripe sono determinate in base alla tua configurazione di queste opzioni.

Connect supporta tre approcci per creare pagamenti relativi a un account connesso. Per ulteriori informazioni su diversi tipi di addebito con Connect, consulta la documentazione sulla scelta di un approccio. Le commissioni Stripe sono calcolate in base alla tua configurazione di queste opzioni.

Questa pagina spiega solo come effettuare chiamate all’API Charges per gli account connessi. Per maggiori informazioni sulle chiamate ad altre API per operazioni correlate, visita le pagine collegate.

Addebiti diretti

Per creare un addebito diretto su un account connesso, crea un oggetto Charge e aggiungi l’intestazione Stripe-Account specificando come valore l’ID dell’account connesso:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa

Questo esempio usa un token di test—tok_visa—ma potresti invece tokenizzare una carta di test tramite Stripe.js ed Elements.

Per ulteriori informazioni, consulta Accettare pagamenti.

Riscuotere le commissioni di piattaforma sugli addebiti diretti

Usando Connect, la tua piattaforma può riscuotere una commissione sugli addebiti diretti. Per imporre una commissione della piattaforma su un addebito, specifica un intero positivo come valore opzionale di application_fee_amount:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d application_fee_amount=123

Per ulteriori informazioni sulla disponibilità dei trasferimenti, i rimborsi o altro, consulta Addebiti diretti.

Addebiti indiretti

Per creare un addebito indiretto, Specifica l’ID dell’account connesso nell’attributo transfer_data[destination]:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Questo esempio usa un token di test—tok_visa—ma potresti invece tokenizzare una carta di test tramite Stripe.js ed Elements.

Per ulteriori informazioni, consulta Accettare pagamenti.

Riscuotere commissioni sugli addebiti indiretti con application_fee_amount

Durante la creazione di addebiti indiretti con un application_fee_amount, l’intero importo dell’addebito viene immediatamente trasferito dalla piattaforma all’account transfer_data[destination], dopo l’acquisizione dell’importo. L’importo application_fee_amount (con un limite massimo pari all’intero importo dell’addebito) viene poi trasferito di nuovo alla piattaforma.

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d application_fee_amount=123 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Per garantire una migliore esperienza di reportistica, viene creato un oggetto per la commissione della piattaforma dopo che la commissione è stata riscossa. Per la reportistica, usa la proprietà amount dell’oggetto creato. Puoi quindi accedere a questi oggetti con l’endpoint Commissioni della piattaforma.

Riscuotere commissioni sugli addebiti indiretti con transfer_data[amount]

Puoi trattenere una commissione anche usando transfer_data[amount].

Il parametro transfer_data[amount] è un intero positivo che riflette l’importo dell’addebito trasferito a transfer_data[destination]. Sottrai le commissioni della piattaforme dall’importo dell’addebito, quindi passi il risultato di questo calcolo al transfer_data[amount]:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d "transfer_data[amount]"=877 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Per informazioni sulla disponibilità dei trasferimenti, i rimborsi o altro, consulta Addebiti indiretti.

Addebiti e trasferimenti separati

Per creare un addebito e configurare il trasferimento associato, crea un oggetto transfer_group e assegna l’addebito all’oggetto transfer_group.

# Create a Charge:
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=10000 \
  -d "currency"="usd" \
  -d "source"="tok_visa" \
  -d "transfer_group"="{ORDER10}"

# Create a Transfer to a connected account (later):
curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=7000 \
  -d "currency"="usd" \
  -d "destination"="{{CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "transfer_group"="{ORDER10}"

# Create a second Transfer to another connected account (later):
curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "destination"="{{OTHER_CONNECTED_STRIPE_ACCOUNT_ID}}" \
  -d "transfer_group"="{ORDER10}"

Questo esempio usa un token di test—tok_visa—ma potresti invece tokenizzare una carta di test tramite Stripe.js ed Elements.

Per ulteriori informazioni, consulta la pagina Accettare pagamenti

Usare on_behalf_of con addebiti e trasferimenti separati

Con gli addebiti e i trasferimenti separati, per impostazione predefinita:

• Gli addebiti vengono saldati nel paese della piattaforma.
• Viene applicata la struttura tariffaria del paese della piattaforma
• Le informazioni della piattaforma vengono visualizzate nell’estratto conto della carta di credito del cliente

Per usare il paese dell’account connesso e visualizzare invece le sue informazioni, usa l’argomento on_behalf_of.

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d source=tok_visa \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}}

Per informazioni sulla disponibilità dei trasferimenti, i rimborsi o altro, consulta Creare addebiti e trasferimenti separati.