Casi d'uso per l'ampliamento delle risposte

Visualizzare le commissioni di Stripe per un determinato pagamento

A volte, potresti voler controllare le spese di elaborazione per un pagamento. Puoi visualizzare queste commissioni di Stripe solo dopo che il pagamento è stato effettuato e la transazione di saldo è stata creata. Questa transazione di saldo viene creata automaticamente in background e l’evento charge.updated mostrerà le commissioni.

Anziché cercare separatamente la transazione di saldo, puoi recuperarla in una singola chiamata utilizzando expand. Ad esempio:

curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "expand[]"="latest_charge.balance_transaction" \
  -G

Utenti con versione API 2022-08-01 o precedente:

curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "expand[]"="charges.data.balance_transaction" \
  -G

Visualizzare gli addebiti inclusi in un bonifico

Ogni bonifico automatico è legato a modifiche storiche del saldo del tuo account Stripe. L’API registra queste modifiche sotto forma di transazioni a saldo, che puoi recuperare utilizzando un elenco di transazioni a saldo. Da questo elenco, puoi ampliare la proprietà source per raccogliere informazioni sull’elemento che ha attivato la modifica del saldo dell’account (addebito, rimborso, trasferimento e così via). Ad esempio:

curl https://api.stripe.com/v1/balance_transactions \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d payout=po_1Gl3ZLLHughnNhxyDrOia0vI \
  -d type=charge \
  -d "expand[]"="data.source" \
  -G

Scopri di più sulla riconciliazione dei bonifici.

Se utilizzi Connect con addebiti indiretti, puoi recuperare le stesse informazioni per conto dei tuoi account connessi. Una differenza, tuttavia, sta nel fatto che tali addebiti indiretti prevedono sia un trasferimento sia un pagamento collegato (sotto forma di oggetto Charge) per spostare i fondi in un account connesso. Pertanto, quando elenchi le transazioni a saldo incluse nei bonifici dell’account connesso, l’origine di ciascuna di queste transazioni è collegata al pagamento del trasferimento anziché all’addebito di origine. Per recuperare l’addebito di origine, devi ampliare il trasferimento collegato di un pagamento mediante la proprietà source_transfer, poi ampliare la proprietà source_transaction del trasferimento:

curl https://api.stripe.com/v1/balance_transactions \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d payout=po_1G7bnaD2wdkPsFGzdVOqU44u \
  -d type=payment \
  -d "expand[]"="data.source.source_transfer.source_transaction" \
  -H "Stripe-Account: acct_1G7PaoD2wdkPsFGz" \
  -G