Lewati ke konten
Buat akun
 atau
Masuk
Logo Dokumen Stripe
/
Buat akun
Masuk
Gambaran UmumUpgrade integrasi Anda
Pembayaran online
Gambaran umumTemukan contoh penggunaan AndaPembayaran Terkelola
Metode Pembayaran
Antarmuka pembayaran
Skenario pembayaran
Pembayaran di tempat
Produk Stripe lainnya

Panduan migrasi Checkout

Pelajari cara bermigrasi ke integrasi terbaru Stripe.

Salin halaman

Versi terdahulu Checkout menyajikan dialog modal kepada pelanggan yang mengumpulkan informasi kartu, serta mengembalikan token atau sumber ke situs web Anda. Sebaliknya, Payment Links dan versi Checkout saat ini adalah halaman pembayaran pintar yang di-hosting oleh Stripe yang membuat pembayaran atau langganan. Kedua integrasi mendukung Apple Pay, Google Pay, 3D Secure Dinamis, Connect, yang menggunakan kembali Pelanggan yang sudah ada, dan banyak fitur lainnya. Anda juga dapat membandingkan integrasi pembayaran lainnya jika Payment Links atau Checkout tidak sesuai dengan contoh penggunaan Anda.

Sebelum Anda memulai

Jika Anda menggunakan SDK Stripe, lakukan upgrade ke versi terbaru.

Pilih model bisnis Anda

Untuk melakukan migrasi dari versi Checkout terdahulu, ikuti panduan yang paling mewakili model bisnis Anda. Setiap panduan merekomendasikan jalur integrasi bersama kode contoh.

Saat mengikuti panduan migrasi yang relevan, Anda juga dapat mereferensikan tabel konversi untuk pemetaan parameter tertentu dan opsi konfigurasi.

Skema biaya dan katalog produk dinamis

Jika Anda menjual produk yang jumlah atau item barisnya ditentukan secara dinamis (misalnya, katalog produk besar atau donasi), lihat menerima pembayaran satu kali.

Anda mungkin telah menggunakan versi Checkout terdahulu untuk membuat token atau sumber pada client, serta meneruskannya ke server Anda untuk membuat charge. Versi Checkout saat ini membalikkan alur ini—Anda membuat Sesi pada server, mengalihkan pelanggan ke Checkout, yang kemudian dialihkan untuk kembali ke aplikasi Anda setelah pembayaran.

Sebelum

Dengan versi terdahulu Checkout, Anda akan menampilkan jumlah dinamis dan keterangan serta mengumpulkan informasi kartu dari pelanggan Anda.

client.html
<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Custom t-shirt"
    data-description="Your custom designed t-shirt"
    data-amount="{{ORDER_AMOUNT}}"
    data-currency="usd">
  </script>
</form>

Berikutnya, Anda akan mengirim token atau sumber yang dihasilkan ke server Anda dan melakukan charge.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="Custom t-shirt" \
  -d "amount"="{{ORDER_AMOUNT}}" \
  -d "currency"="usd"

Setelah

Tambahkan tombol checkout ke situs web Anda yang memanggil endpoint sisi server untuk membuat Sesi Checkout.

checkout.html
<html>
  <head>
    <title>Buy cool new product</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Sesi Checkout adalah representasi terprogram dari apa yang dilihat pelanggan Anda saat mereka dialihkan ke formulir pembayaran. Anda dapat melakukan konfigurasi dengan opsi seperti:

Sertakan success_url dengan URL halaman di situs web Anda yang akan diarahkan pelanggan setelah menyelesaikan pembayaran.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"="Custom t-shirt" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Setelah membuat Sesi Checkout, alihkan pelanggan Anda ke URL yang dikembalikan di respons. Jika Anda perlu memenuhi barang yang dibeli setelah pembayaran, lihat Penuhi pembayaran Payment Link dan Checkout.

Langganan dinamis

Jika Anda menyediakan layanan langganan yang ditentukan secara dinamis atau memerlukan dukungan untuk fitur lanjutan lainnya, lihat menyiapkan langganan.

Anda mungkin telah menggunakan versi Checkout terdahulu untuk membuat token atau sumber pada client, serta meneruskannya ke server Anda untuk membuat pelanggan dan langganan. Versi Checkout saat ini membalikkan alur ini—Anda membuat Sesi pada server terlebih dahulu, mengalihkan pelanggan ke Checkout, yang kemudian dialihkan untuk kembali ke aplikasi Anda setelah berhasil.

Sebelum

Dengan versi terdahulu Checkout, Anda akan menampilkan informasi langganan dan mengumpulkan informasi kartu dari pelanggan Anda.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Gold Tier"
    data-description="Monthly subscription with 30 days trial"
    data-amount="2000"
    data-label="Subscribe">
  </script>
</form>

Berikutnya, Anda akan mengirim token atau sumber yang dihasilkan ke server Anda untuk membuat pelanggan dan langganan.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/subscriptions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "items[0][price]"="{PRICE_ID}" \
  -d "trial_period_days"=30

Setelah

Tambahkan tombol checkout ke situs web Anda yang memanggil endpoint sisi server untuk membuat Sesi Checkout.

checkout.html
<html>
  <head>
    <title>Subscribe to cool new service</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Subscribe</button>
    </form>
  </body>
</html>

Sesi Checkout adalah representasi terprogram dari apa yang dilihat pelanggan Anda saat mereka dialihkan ke formulir pembayaran. Anda dapat melakukan konfigurasi dengan opsi seperti:

Sertakan success_url dengan URL halaman di situs web Anda yang akan diarahkan pelanggan setelah menyelesaikan pembayaran.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "subscription_data[trial_period_days]"=30 \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success"

Setelah membuat Sesi Checkout, alihkan pelanggan Anda ke URL yang dikembalikan di respons. Pelanggan dialihkan ke success_url setelah pelanggan dan langganan dibuat. Jika Anda perlu memenuhi layanan yang dibeli setelah pembayaran, lihat Penuhi pembayaran Payment Link dan Checkout.

Situs belanja online dan platform Connect

Jika Anda menjalankan situs belanja online atau platform Connect dan melakukan pembayaran yang melibatkan akun terhubung, pertimbangkan menggunakan Checkout versi saat ini.

Contoh berikut menunjukkan penggunaan Checkout Sessions API untuk memproses Direct Charges. Anda juga dapat menggunakan Checkout dan Connect dengan Destination Charges serta Separate Charges and Transfers.

Sebelum

Dengan versi terdahulu Checkout, Anda akan mengumpulkan informasi kartu dari pelanggan Anda pada client.

client.html
<form action="/purchase" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Food Marketplace"
    data-description="10 cucumbers from Roger's Farm"
    data-amount="2000">
  </script>
</form>

Berikutnya, Anda akan mengirim token atau sumber yang dihasilkan ke server Anda dan melakukan charge atas nama akun terhubung.

Command Line
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "source"="{{TOKEN_ID}}" \
  -d "description"="10 cucumbers from Roger\"s Farm" \
  -d "amount"=2000 \
  -d "currency"="usd" \
  -d "application_fee_amount"=200 \
  -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}"

Setelah

Tambahkan tombol checkout ke situs web Anda yang memanggil endpoint sisi server untuk membuat Sesi Checkout.

checkout.html
<html>
  <head>
    <title>Roger's Farm</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Sesi Checkout adalah representasi terprogram dari apa yang dilihat pelanggan Anda saat mereka dialihkan ke formulir pembayaran. Anda dapat melakukan konfigurasi dengan opsi seperti:

Sertakan success_url dengan URL halaman di situs web Anda yang akan diarahkan pelanggan setelah menyelesaikan pembayaran.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price_data][currency]"=usd \
  --data-urlencode "line_items[0][price_data][product_data][name]"="Cucumbers from Roger's Farm" \
  -d "line_items[0][price_data][unit_amount]"=200 \
  -d "line_items[0][quantity]"=10 \
  -d "payment_intent_data[application_fee_amount]"=200 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Setelah membuat Sesi Checkout, alihkan pelanggan Anda ke URL yang dikembalikan di respons. Jika Anda perlu memenuhi barang atau layanan yang dibeli setelah pembayaran, lihat Penuhi pembayaran Payment Link dan Checkout.

Menyimpan metode pembayaran untuk penggunaan di masa mendatang

Jika Anda menyediakan layanan yang tidak segera men-charge pelanggan, lihat menyiapkan pembayaran mendatang.

Anda mungkin telah menggunakan versi Checkout terdahulu untuk membuat token atau sumber pada client, serta meneruskannya ke server Anda guna disimpan untuk penggunaan nanti. Versi Checkout saat ini membalikkan alur ini—Anda membuat Sesi pada server terlebih dahulu, mengalihkan pelanggan ke Checkout, yang kemudian dialihkan untuk kembali ke aplikasi Anda setelah berhasil.

Sebelum

Dengan versi terdahulu Checkout, Anda akan menampilkan informasi charge dan mengumpulkan informasi kartu dari pelanggan Anda.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Cleaning Service"
    data-description="Charged after your home is spotless"
    data-amount="2000">
  </script>
</form>

Berikutnya, Anda akan mengirim token atau sumber yang dihasilkan ke server Anda untuk membuat charge nantinya.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="customer@example.com" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="Cleaning service" \
  -d "amount"="{{ORDER_AMOUNT}}" \
  -d "currency"="usd"

Setelah

Tambahkan tombol checkout ke situs web Anda yang memanggil endpoint sisi server untuk membuat Sesi Checkout.

checkout.html
<html>
  <head>
    <title>Cleaning service</title>
  </head>
  <body>
    <!-- Use action="/create-checkout-session.php" if your server is PHP based. -->
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Subscribe</button>
    </form>
  </body>
</html>

Sesi Checkout adalah representasi terprogram dari apa yang dilihat pelanggan Anda saat mereka dialihkan ke formulir pembayaran. Anda dapat melakukan konfigurasi dengan opsi seperti:

Sertakan success_url dengan URL halaman pada situs web tujuan pengalihan pelanggan Anda setelah menyelesaikan penyiapan pembayaran.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=setup \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}"

Setelah membuat Sesi Checkout, arahkan pelanggan Anda ke URL yang dikembalikan sebagai tanggapan untuk mengumpulkan detail metode pembayaran. Pelanggan dialihkan ke success_url setelah menyelesaikan alur. Saat Anda siap menagih pembayaran, ambil SetupIntent dari Sesi Checkout dan gunakan untuk menyiapkan transaksi.

Katalog produk sederhana dengan skema biaya tetap

Jika Anda menjual produk dengan harga tetap (seperti kaus pendek atau buku elektronik), lihat panduan pada tautan pembayaran. Anda mungkin telah menggunakan versi Checkout terdahulu untuk membuat token atau sumber pada client, dan meneruskannya ke server Anda untuk membuat charge.

Sebelum

Dengan versi terdahulu Checkout, Anda akan menampilkan jumlah dan keterangan serta mengumpulkan informasi kartu dari pelanggan Anda.

client.html
<form action="/pay" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="T-shirt"
    data-description="Comfortable cotton t-shirt"
    data-amount="500"
    data-currency="usd">
  </script>
</form>

Berikutnya, Anda akan mengirim token atau sumber yang dihasilkan ke server Anda untuk membuat pelanggan dan charge.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="{{STRIPE_EMAIL}}" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "description"="T-shirt" \
  -d "amount"=500 \
  -d "currency"="usd"

Setelah

Buat Produk dan Harga yang mewakili item. Contoh berikut membuat Produk dalam baris. Anda juga dapat membuat objek ini di Dashboard.

Command Line
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=500 \
  -d "product_data[name]"=T-shirt

Buat Tautan Pembayaran di Dashboard menggunakan Produk dan Harga. Setelah Anda membuat tautan ini, klik Tombol beli untuk melakukan konfigurasi desain serta menghasilkan kode yang dapat disalin dan tempelkan ke situs web Anda.

index.html
<body>
  <h1>Purchase your new kit</h1>
  <!-- Paste your embed code script here. -->
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
'{{BUY_BUTTON_ID}}'

    publishable-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

  >
  </stripe-buy-button>
</body>

Langganan sederhana

Jika Anda menyediakan layanan langganan sederhana (seperti akses bulanan ke perangkat lunak), lihat panduan pada tautan pembayaran. Anda mungkin telah menggunakan versi Checkout terdahulu untuk membuat token atau sumber pada client, dan meneruskannya ke server Anda untuk membuat pelanggan serta langganan.

Sebelum

Dengan versi terdahulu Checkout, Anda akan menampilkan informasi langganan dan mengumpulkan informasi kartu dari pelanggan Anda.

client.html
<form action="/subscribe" method="POST">
  <script
    src="https://checkout.stripe.com/checkout.js"
    class="stripe-button"
    data-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

    data-name="Gold Tier"
    data-description="Monthly subscription"
    data-amount="2000"
    data-currency="usd"
    data-label="Subscribe">
  </script>
</form>

Berikutnya, Anda akan mengirim token atau sumber yang dihasilkan ke server Anda untuk membuat pelanggan dan langganan.

Command Line
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "email"="{{STRIPE_EMAIL}}" \
  -d "source"="{{STRIPE_TOKEN}}"
curl https://api.stripe.com/v1/subscriptions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "items[][price]"="{PRICE_ID}" \
  -d "items[][quantity]"=1

Setelah

Buat Produk dan Harga yang mewakili langganan. Contoh berikut membuat Produk dalam baris. Anda juga dapat membuat objek ini di Dashboard.

Command Line
curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d unit_amount=2000 \
  -d "recurring[interval]"=month \
  -d "product_data[name]"="Gold Tier"

Buat Tautan Pembayaran di Dashboard menggunakan Produk dan Harga. Setelah Anda membuat tautan ini, klik Tombol beli untuk melakukan konfigurasi desain serta menghasilkan kode yang dapat disalin dan tempelkan ke situs web Anda.

index.html
<body>
  <h1>Purchase your new kit</h1>
  <!-- Paste your embed code script here. -->
  <script
    async
    src="https://js.stripe.com/v3/buy-button.js">
  </script>
  <stripe-buy-button
    buy-button-id=
'{{BUY_BUTTON_ID}}'

    publishable-key=
"pk_test_TYooMQauvdEDq54NiTphI7jx"

  >
  </stripe-buy-button>
</body>

Konversi parameter

Checkout versi saat ini mendukung sebagian besar fungsionalitas versi Checkout terdahulu. Namun, versi tersebut tidak berbagi API yang sama. Tabel berikut memetakan parameter serta opsi konfigurasi antara versi terdahulu dan versi saat ini. Untuk daftar lengkap opsi konfigurasi, lihat Sesi Checkout.

Versi terdahuluVersi saat iniKiat integrasi
allowRememberMeTidak didukungGunakan kembali pelanggan yang sudah ada dengan menentukan parameter customer saat membuat Sesi Checkout. Anda juga dapat mengaktifkan Link untuk memungkinkan pelanggan menyimpan dan menggunakan kembali informasi pembayarannya dengan aman.
amountDihitung secara otomatis sebagai penjumlahan dari jumlah pada semua line_itemsJumlah total adalah penjumlahan item baris yang Anda teruskan ke Checkout.
billingAddressSession.billing_address_collectionCheckout mengumpulkan alamat tagihan secara otomatis bila diperlukan untuk pencegahan penipuan atau tujuan regulasi. Atur parameter ini ke required untuk selalu mengumpulkan alamat tagihan.
closedcancel_urlBila pelanggan ingin menutup Checkout, mereka bisa menutup tab browser atau masuk ke cancel_url.
currencySession.currency
descriptionSession.line_items.description atau product.descriptionJika Anda menentukan harga, Checkout menampilkan keterangan yang dihitung secara otomatis mengenai seberapa sering pembayaran terjadi. Jika Anda menentukan Session.line_items, Checkout menampilkan name untuk setiap item baris.
emailSession.customer_emailJika sudah mengetahui email pelanggan, Anda dapat otomatis mengisinya dengan customer_email saat membuat Sesi Checkout.

image

Branding bisnis: Unggah logo atau ikon bisnis Anda di Dashboard.

Gambar produk: Tentukan gambar untuk setiap mata anggaran dengan product.images.

Checkout menggunakan gambar spesifik untuk branding bisnis dan untuk produk yang Anda jual. Checkout menampilkan logo bisnis Anda secara default serta kembali ke ikon bisnis bersama nama bisnis Anda.

keyTidak ada lagi parameter yang diteruskan ke Checkout
localeSession.localeAnda dapat menentukan lokal yang didukung ketika membuat Sesi Checkout.
nameproduct.name untuk harga yang ditentukan di Session.line_itemsJika Anda menentukan harga, Checkout menampilkan nama produk yang memakai harga itu. Jika Anda menentukan Session.line_items, Checkout menampilkan name untuk setiap item baris.
panelLabelsubmit_typeCheckout menyesuaikan teks tombol secara otomatis bergantung pada item yang Anda jual. Untuk pembayaran satu kali, gunakan submit_type untuk menyesuaikan teks tombol.
shippingAddresssession.shipping_address_collectionKumpulkan informasi alamat pengiriman dengan meneruskan larik allowed_countries negara tujuan yang ingin Anda izinkan.
token atau sourcesuccess_urlTidak ada lagi callback di JavaScript bila pembayaran selesai. Karena pelanggan Anda membayar pada halaman yang berbeda, atur success_url untuk mengalihkan pelanggan setelah mereka menyelesaikan pembayaran.
zipCodeDikumpulkan secara otomatis oleh CheckoutCheckout mengumpulkan kode pos secara otomatis bila diperlukan untuk pencegahan penipuan atau tujuan regulasi.

Lihat juga

Apakah halaman ini membantu?
YaTidak
Butuh bantuan? Hubungi Tim CS.
Bergabunglah dengan program akses awal kami.
Lihat log perubahan kami.
Ada pertanyaan? Hubungi Bagian Penjualan.
LLM? Baca llms.txt.
Dijalankan oleh Markdoc