Riscuotere le imposte

Stripe Tax utilizza le informazioni salvate nei prodotti e nei prezzi per calcolare le imposte, come il codice imposta e il comportamento fiscale. Se non specifichi esplicitamente queste configurazioni, Stripe Tax utilizzerà il codice imposta predefinito selezionato in Impostazioni fiscali.

Per ulteriori informazioni, consulta Specificare i codici d’imposta dei prodotti e il comportamento fiscale.

Per calcolare le imposte su una sessione di Checkout di un cliente esistente, imposta il parametro automatic_tax[enabled] su true quando crei la sessione. Puoi basare i calcoli delle imposte sugli indirizzi esistenti del cliente o sui nuovi indirizzi acquisiti durante il pagamento:

Usare gli indirizzi esistenti del cliente per le imposte

Se hai già raccolto gli indirizzi dei clienti esistenti, puoi basare i calcoli delle imposte su quegli indirizzi piuttosto che sugli indirizzi raccolti durante il pagamento:

• Quale indirizzo del cliente usa Checkout per le imposte?

  Se disponibile, per calcolare le imposte Checkout usa l’indirizzo di spedizione salvato del cliente. In alternativa, Checkout calcola le imposte usando l’indirizzo di fatturazione salvato del cliente.

• Gli indirizzi del cliente devono rispettare requisiti particolari?

  Quando si usano gli indirizzi esistenti per le imposte, il cliente deve avere un indirizzo di spedizione o un indirizzo di fatturazione valido salvato. Puoi verificare se gli indirizzi salvati di un cliente sono validi o meno controllando la proprietà customer.tax.automatic_tax. Se il valore di customer.tax.automatic_tax è supported o not_collecting, gli indirizzi salvati del cliente sono validi e puoi abilitare Stripe Tax nelle sessioni di Checkout per quel cliente.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true \
  -d customer=
{{CUSTOMER_ID}} \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

Usare gli indirizzi raccolti durante la fase di pagamento per le imposte

Puoi configurare Checkout in modo da salvare i nuovi indirizzi di spedizione o fatturazione di un cliente. In questo caso, Checkout calcola le imposte usando l’indirizzo inserito durante il pagamento.

• Quale indirizzo usa Checkout per le imposte?

  Se acquisisci gli indirizzi di spedizione, Checkout utilizza l’indirizzo di spedizione inserito durante la sessione per calcolare le imposte. In alternativa, Checkout calcola le imposte usando l’indirizzo di fatturazione inserito durante la sessione.

• Dove vengono salvati gli indirizzi raccolti durante la fase di pagamento?

  Se acquisisci gli indirizzi di spedizione, Checkout salva l’indirizzo di spedizione inserito durante la sessione nella proprietà customer.shipping.address del cliente. In alternativa, Checkout salva l’indirizzo di fatturazione inserito durante la sessione nella proprietà customer.address del cliente. In entrambi i casi, l’indirizzo utilizzato per le imposte sostituirà tutti gli indirizzi esistenti.

Se acquisisci gli indirizzi di spedizione con Checkout, imposta la proprietà customer_update[shipping] su auto. Questo ti permette di copiare le informazioni di spedizione da Checkout per quel cliente.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true \
  -d customer=
{{CUSTOMER_ID}} \
  -d "customer_update[shipping]"=auto \
  -d "shipping_address_collection[allowed_countries][0]"=US \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

Se non acquisisci gli indirizzi di spedizione con Checkout e desideri usare gli indirizzi di fatturazione inseriti durante la procedura di pagamento per le imposte, devi salvare l’indirizzo di fatturazione del cliente. Imposta la proprietà customer_update[address] su auto in modo da copiare l’indirizzo appena inserito per il cliente fornito.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true \
  -d customer=
{{CUSTOMER_ID}} \
  -d "customer_update[shipping]"=auto \
  -d mode=payment \
  -d ui_mode=embedded \
  --data-urlencode return_url="https://example.com/return"

Se vuoi vedere i risultati dell’ultimo calcolo delle imposte, usa la proprietà total_details.amount_tax nella risorsa della sessione di Checkout, che mostra l’importo delle imposte calcolato. In più, puoi utilizzare la Dashboard per visualizzare le imposte risultanti per ciascun pagamento.