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 |
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 |
Mengendalikan panggilan balik
Apabila transaksi selesai, Pembayaran untuk Stripe akan mengalihkan ke URL panggilan balik anda dengan parameter pertanyaan yang menunjukkan hasilnya.
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-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.