API Pembangun
Integrasikan dengan Skema URL
Lancarkan Pembayaran untuk Stripe daripada aplikasi atau laman web anda untuk memproses transaksi. Serahkan data pelanggan, jumlah dan maklumat produk — kemudian kendalikan panggilan balik apabila selesai.
Cara ia berfungsi
Aplikasi anda membuka pembayaran:// URL dengan parameter
Pembayaran untuk Stripe melancarkan dan memproses transaksi
Setelah selesai, aplikasi akan mengalihkan ke URL panggilan balik anda dengan hasilnya
Titik akhir
Cipta Caj
payment://new?Proses pembayaran sekali sahaja dengan jumlah, mata wang dan perihalan.
Parameter
| Nama | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
amount | integer | Ya | Amaun dalam sen (cth., 1000 = $10.00) |
currency | string | Tidak | Kod mata wang ISO tiga huruf (lalai: USD) |
description | string | Tidak | Huraian caj yang dikodkan URL |
customer | string | Tidak | ID pelanggan Stripe sedia ada |
email | string | Tidak | Emel pelanggan untuk resit |
name | string | Tidak | Nama pelanggan yang dikodkan URL |
metadata | string | Tidak | Pasangan nilai-kunci tersuai (JSON yang dikodkan URL) |
callback | string | Tidak | URL untuk kembali selepas selesai |
autoprocess | boolean | Tidak | Langkau skrin utama dan mulakan pengecasan dengan segera |
auto_return | boolean | Tidak | Jalankan panggilan balik apabila hasil dimuatkan dan bukannya menunggu pedagang menolak dialog hasil. Lalai palsu. |
Cipta Invois
payment://cart?Cipta invois Stripe dengan item baris daripada katalog produk anda.
Parameter
| Nama | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
prices | string | Ya | ID harga yang dipisahkan koma dengan kuantiti (cth., price_abc:2,price_xyz:1) |
customer | string | Tidak | ID pelanggan Stripe sedia ada |
email | string | Tidak | Emel pelanggan untuk resit |
name | string | Tidak | Nama pelanggan yang dikodkan URL |
callback | string | Tidak | URL untuk kembali selepas selesai |
auto_return | boolean | Tidak | Jalankan panggilan balik apabila hasil dimuatkan dan bukannya menunggu pedagang menolak dialog hasil. Lalai palsu. |
Mengendalikan panggilan balik
Apabila transaksi selesai, Pembayaran untuk Stripe akan mengalihkan ke URL panggilan balik anda dengan parameter pertanyaan yang menunjukkan hasilnya. Secara lalai, pengalihan akan diaktifkan selepas pedagang menolak dialog hasil supaya mereka boleh mengambil tindakan selepas caj (emelkan resit, bayaran balik). Lulus auto_return=true kepada api sebaik sahaja hasilnya diketahui. Disokong pada iOS dan Android.
Parameter Panggilan Balik
| Parameter | Nilai-nilai | Penerangan |
|---|---|---|
status | success | error | cancelled | Hasil transaksi |
charge_id | string | ID caj jalur (selepas berjaya) |
error | string | Mesej ralat (apabila ralat) |
Contoh
Caj mudah
Caj $10.00 hanya dengan sejumlah wang
payment://new?amount=1000Cas dengan penerangan
Caj €25.00 dengan penerangan
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryCaj dengan pelanggan baharu
Caj $50.00 dan cipta rekod pelanggan
payment://new?amount=5000&name=John%20Smith&[email protected]Caj pelanggan sedia ada
Caj $75.00 kepada pelanggan Stripe sedia ada
payment://new?amount=7500&customer=cus_ABC123xyzCas dengan metadata
Caj $100.00 dengan metadata tersuai untuk rekod anda
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DProses automatik dengan panggilan balik
Langkau skrin utama dan kembali ke aplikasi anda setelah selesai
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completePulangan automatik pada hasil
Jalankan panggilan balik sebaik sahaja hasilnya diketahui, dan bukannya menunggu pedagang menolak dialog hasil
payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-completeInvois dengan item baris
Cipta invois dengan produk daripada katalog Stripe anda
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Contoh lengkap
Semua parameter digabungkan untuk aliran bersepadu sepenuhnya
payment://new?amount=15000¤cy=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-resultPengekodan URL
Ingat untuk mengekod URL aksara khas dalam nilai parameter. Ruang menjadi %20, pendakap kerinting menjadi %7B dan %7D.
Bersedia untuk berintegrasi?
Muat turun aplikasi dan mula menguji integrasi anda hari ini.