Stripe Connect dan Charges API

Pelajari cara Connect memungkinkan Anda membuat charge dan menerbitkan transfer untuk akun terhubung. Cara Anda melakukan konfigurasi opsi ini menentukan biaya Stripe.

Connect mendukung tiga pendekatan dalam membuat pembayaran bagi akun terhubung. Untuk informasi selengkapnya tentang berbagai tipe charge Connect, lihat dokumentasi tentang memilih pendekatan. Biaya Stripe ditentukan oleh cara Anda melakukan konfigurasi opsi ini.

Halaman ini hanya menjelaskan cara melakukan panggilan ke Charges API untuk akun terhubung. Periksa halaman tertaut untuk informasi selengkapnya tentang panggilan ke API lainnya untuk operasi terkait.

Direct charges

Untuk membuat direct charge pada akun terhubung, buat objek Charge dan tambahkan header Stripe-Account dengan nilai identifikasi akun terhubung:

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

Contoh ini menggunakan token percobaan—tok_visa—tetapi Anda dapat membuat token kartu percobaan menggunakan Stripe.js dan Elements sebagai gantinya.

Lihat Menerima pembayaran untuk detail selengkapnya.

Pungut biaya aplikasi atas direct charges

Dengan Connect, platform Anda dapat mengambil biaya aplikasi atas direct charges. Untuk menilai biaya aplikasi atas charge, teruskan nilai application_fee_amount opsional sebagai bilangan bulat positif:

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

Lihat Direct Charges untuk informasi mengenai ketersediaan transfer, pengembalian dana, dan lain-lain.

Destination charges

Untuk membuat destination charge, teruskan identifikasi akun terhubung di atribut 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}}

Contoh ini menggunakan token percobaan—tok_visa—tetapi Anda dapat membuat token kartu percobaan menggunakan Stripe.js dan Elements sebagai gantinya.

Lihat Menerima pembayaran untuk detail selengkapnya.

Tagih biaya atas destination charges dengan application_fee_amount

Saat membuat destination charges dengan application_fee_amount, jumlah charge penuh segera ditransfer dari platform ke akun transfer_data[destination] setelah charge ditarik. application_fee_amount (dibatasi pada jumlah charge penuh) kemudian ditransfer kembali ke platform.

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}}

Untuk memberikan pengalaman pelaporan yang lebih baik, objek biaya aplikasi dibuat setelah biaya aplikasi ditagih. Gunakan properti amount pada objek biaya aplikasi untuk pelaporan. Anda kemudian dapat mengakses objek ini dengan endpoint Biaya Aplikasi.

Tagih biaya atas destination charges dengan transfer_data[amount]

Anda juga dapat mengambil biaya dengan menggunakan transfer_data[amount].

transfer_data[amount] adalah bilangan bulat positif yang mencerminkan jumlah tagihan yang ditransfer ke transfer_data[destination]. Anda mengambil biaya platform dari jumlah charge, kemudian meneruskan hasil perhitungan ini sebagai 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}}

Lihat Destination charges untuk informasi tentang ketersediaan transfer, pengembalian dana, dan lain-lain.

Separate charges and transfers

Untuk membuat charge dan menyiapkan transfer terkait, buat transfer_group dan tetapkan charge ke 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}"

Contoh ini menggunakan token percobaan—tok_visa—tetapi Anda dapat membuat token kartu percobaan menggunakan Stripe.js dan Elements sebagai gantinya.

Lihat Menerima pembayaran untuk informasi selengkapnya.

Menggunakan on_behalf_of bersama separate charges and transfers

Dengan separate charges and transfers, secara default:

• Charge diselesaikan di negara platform
• Digunakan struktur biaya untuk negara platform
• Informasi platform ditampilkan pada rekening koran kartu kredit pelanggan

Untuk menggunakan negara akun terhubung dan menampilkan informasinya, gunakan argumen on_behalf_of sebagai gantinya.

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}}

Lihat Membuat Separate Charges and Transfers untuk informasi tentang ketersediaan transfer, pengembalian dana, dan lain-lain.