Kasus penggunaan untuk memperluas tanggapan

Lihat biaya Stripe untuk pembayaran tertentu

Terkadang, Anda mungkin ingin memeriksa biaya pemrosesan untuk pembayaran. Anda hanya dapat melihat biaya Stripe setelah pembayaran dilaksanakan dan transaksi saldo dibuat. Transaksi saldo ini dibuat secara otomatis di latar belakang, dan kejadian charge.updated akan memperlihatkan biaya.

Sebagai ganti mencari transaksi saldo secara terpisah, Anda dapat mengambilnya dalam satu panggilan menggunakan expand. Misalnya:

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

Pengguna pada versi API 2022-08-01 atau lebih lama:

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

Lihat charge yang disertakan dalam payout

Setiap payout otomatis dikaitkan dengan perubahan historis pada saldo akun Stripe Anda. API mencatat perubahan historis ini sebagai transaksi saldo, yang dapat Anda ambil menggunakan Daftar Transaksi Saldo. Dari daftar transaksi saldo, Anda dapat memperluas properti sumber untuk mengumpulkan informasi tentang hal yang memicu perubahan pada saldo akun (Charge, Pengembalian dana, Transfer, dan lain-lain). Misalnya:

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

Pelajari selengkapnya rekonsiliasi payout.

Jika menggunakan Connect dengan Destination Charges, Anda dapat mengambil informasi yang sama atas nama akun terhubung. Perbedaannya adalah Destination Charges melibatkan transfer maupun pembayaran yang dikaitkan (dalam bentuk objek Charge) untuk memindahkan dana ke akun terhubung. Jadi, ketika mencantumkan transaksi saldo yang digabungkan dalam payout akun terhubung Anda, setiap sumber transaksi saldo ditautkan pada pembayaran transfer, bukan Charge asal. Untuk mengambil Charge asal, Anda perlu memperluas transfer tertaut pembayaran melalui properti source_transfer; dan dari sana, perluas properti source_transaction transfer:

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