Daftar periksa menjadi live

Stripe telah merancang lingkungan sandbox dan live agar berfungsi semirip mungkin. Beralih di antara keduanya sebagian besar berkaitan dengan menukar kunci API Anda.

Jika Anda seorang pengembang, atau meminta pengembang melakukan integrasi untuk Anda, item berikut juga harus Anda pertimbangkan sebelum live. Jika Anda menggunakan Stripe melalui situs web terhubung atau plug-in, sebagian besar tidak akan berlaku.

• Atur versi API

  Peringatan

  Semua permintaan menggunakan pengaturan API akun, kecuali Anda mengesampingkan versi API. Log perubahan mencantumkan setiap versi yang tersedia. Perhatikan bahwa secara default kejadian webhook disusun menurut versi API akun, kecuali jika Anda mengatur versi API selama pembuatan endpoint.

  Jika Anda menggunakan bahasa bertipe kuat (Go, Java, TypeScript, .NET), pustaka sisi server menyematkan versi API berdasarkan versi pustaka yang sedang digunakan. Jika Anda belum memahami cara Stripe mengelola pembuatan versi, lihatlah dokumen pembuatan versi.

  Untuk memastikan semuanya sinkron:

  • Upgrade ke versi API terbaru dalam Workbench dalam Dashboard
  • Untuk bahasa dinamis (Node.js, PHP, Python, Ruby): atur versi API di pustaka sisi server
  • Untuk bahasa bertipe kuat (Go, Java, TypeScript, .NET): upgrade ke versi terbaru dari pustaka yang Anda pilih
• Tangani kasus unik

  Kami telah membuat beberapa nilai percobaan yang dapat Anda gunakan untuk mereplikasi berbagai status dan respons. Di luar opsi ini, lakukan uji tuntas, mencoba integrasi Anda dengan:

  • Data tidak lengkap
  • Data tidak valid
  • Data duplikat (misalnya, coba ulang permintaan yang sama untuk melihat apa yang terjadi). Kami juga merekomendasikan Anda meminta orang lain mencoba integrasi Anda, terutama jika orang lain tersebut bukan pengembang.
• Tinjau penanganan kesalahan API Anda

  Waktu setelah Anda live tidaklah menguntungkan untuk mengetahui ada yang tidak benar dalam penulisan kode untuk menangani setiap kemungkinan tipe kesalahan, termasuk yang seharusnya “tidak pernah” terjadi. Pastikan kode Anda bisa untuk bertahan, tidak hanya menangani kesalahan umum, tetapi segala kemungkinan.

  Ketika mencoba penanganan kesalahan, perhatikan dengan saksama informasi apa yang ditampilkan kepada pengguna Anda. Kartu yang ditolak (yaitu card_error) merupakan persoalan yang berbeda dengan kesalahan pada backend Anda (misalnya, invalid_request_error).

• Tinjau pembuatan log Anda

  Stripe mencatat setiap permintaan yang dibuat menggunakan kunci API Anda, dengan catatan ini yang dapat dilihat di Dashboard. Kami merekomendasikan Anda mencatat semua data penting pada sisi Anda juga, meskipun tampak boros. Log Anda sendiri akan menjadi penyelamat jika server bermasalah saat menghubungi Stripe atau ada masalah dengan kunci API Anda—kedua kasus tersebut akan mencegah kami membuat log permintaan Anda.

  Periksa log Anda secara rutin untuk memastikan log menyimpan hanya informasi yang Anda butuhkan dan bukan yang bersifat sensitif (misalnya, detail kartu kredit atau informasi pengidentifikasi pribadi).

• Pastikan Anda tidak mengandalkan objek percobaan

  Objek Stripe yang dibuat di lingkungan sandbox—seperti paket, kupon, produk, dan SKU—tidak dapat digunakan dalam mode live. Hal ini mencegah data percobaan Anda digunakan secara tidak sengaja dalam kode produksi Anda. Ketika membuat ulang objek yang diperlukan dalam mode live, pastikan menggunakan nilai identifikasi yang sama (misalnya, identifikasi paket yang sama, bukan nama yang sama) untuk menjamin kode Anda terus berfungsi tanpa masalah.

• Pastikan Anda telah mendaftarkan webhook produksi

  Akun Stripe Anda dapat memiliki endpoint webhook percobaan maupun live. Jika menggunakan webhook, pastikan Anda telah mendefinisikan endpoint live di akun Stripe. Kemudian konfirmasikan apakah endpoint live berfungsi persis sama dengan endpoint percobaan Anda.

  Ketika memeriksa status webhook Anda, sediakan juga waktu sebentar untuk memeriksa apakah endpoint produksi Anda:

  • Menangani notifikasi webhook yang tertunda dengan baik
  • Menangani notifikasi webhook duplikat dengan baik
  • Tidak memerlukan notifikasi kejadian untuk terjadi dalam urutan spesifik
• Langganan milis pengumuman API

  Kami merekomendasikan semua pengembang langganan milis pembaruan API kami untuk mengikuti fitur-fitur baru selama perilisan.

• Ubah dan amankan kunci API Anda

  Sebagai tindakan pengamanan, kami merekomendasikan rotasi kunci API secara rutin, dan juga merotasinya segera sebelum dijadikan live. Ini untuk berjaga-jaga jika kunci tersebut pernah disimpan di luar kode basis Anda selama pengembangan. Pastikan alur kerja Anda tidak mengakibatkan kunci API Anda diwakili atau disimpan di beberapa tempat (yang menyebabkan bug) atau berakhir di perangkat lunak kontrol versi Anda.