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. |
Bayar Invois Sedia Ada (iOS sahaja)
payment://invoice?Kumpulkan pembayaran secara bersemuka dengan invois Stripe sedia ada. Amaun, mata wang, pelanggan dan cukai datang daripada invois — mengatasi mana-mana daripadanya akan ditolak. Pedagang mengetik kad melalui pembaca / Ketik untuk Bayar / entri manual; setelah berjaya, invois ditandakan sebagai dibayar di luar jalur dan dipautkan melalui metadata charge_id dan payment_intent_id. Invois dengan langganan, default_payment_method atau status tidak terbuka akan ditolak dengan ralat yang boleh diambil tindakan.
Parameter
| Nama | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
id | string | Ya | ID invois jalur (mesti bermula dengan in_) |
callback | string | Tidak | URL untuk kembali selepas selesai. Menerima invoice_id dan payment_intent_id setelah berjaya. |
metadata | string | Tidak | Pasangan nilai kunci tersuai (JSON yang dikodkan URL) digabungkan ke dalam metadata PaymentIntent |
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. |
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) |
invoice_id | string | ID invois Stripe (apabila berjaya, aliran pembayaran://invois sahaja) |
payment_intent_id | string | ID Niat Pembayaran Stripe (apabila berjaya, aliran pembayaran://invois sahaja) |
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]Bayar invois sedia ada (iOS)
Kutip bayaran secara bersemuka untuk invois Stripe sedia ada. Mengembalikan invoice_id dan payment_intent_id apabila berjaya.
payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paidContoh 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.