Casi d'uso per l'ampliamento delle risposte

Visualizzare le commissioni di Stripe per un determinato pagamento

Puoi controllare le commissioni di elaborazione per un pagamento dopo che il pagamento è stato elaborato ed è stata creata la transazione del saldo. Stripe crea automaticamente questa transazione del saldo in background. L’evento charge.updated include un riferimento alla transazione del saldo tramite la proprietà balance_transaction(ad es. txn_123), che indica che la transazione del saldo è stata creata ed è pronta per l’uso.

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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d payout=po_1G7bnaD2wdkPsFGzdVOqU44u \
  -d type=payment \
  -d "expand[]"="data.source.source_transfer.source_transaction" \
  -H "Stripe-Account: acct_1G7PaoD2wdkPsFGz" \
  -G