Geliştirici API'si
Entegre edin ve özelleştirin
Payment for Stripe'ı URL şemalarıyla kendi uygulamanızdan veya web sitenizden başlatın, uygulamada hangi ürünlerin görüneceğini doğrudan Stripe Kontrol Paneli'nden yönetin.
URL şemalarıyla entegrasyon
Nasıl çalışır?
Uygulamanız bir payment:// URL'sini parametrelerle açar
Payment for Stripe başlatılır ve işlem gerçekleştirilir
İşlem tamamlandığında, uygulama sonuçla birlikte geri çağırma URL'nize yönlendirir
Uç noktalar
Tahsilat Oluştur
payment://new?Tutar, para birimi ve açıklama bilgilerini kullanarak tek seferlik bir ödeme işlemi gerçekleştirin.
Parametreler
| İsim | Tip | Gerekli | Açıklama |
|---|---|---|---|
amount | integer | Evet | Sent cinsinden tutar (örneğin, 1000 = $10,00) |
currency | string | Hayır | Üç harfli ISO para birimi kodu (varsayılan: uygulamanın geçerli para birimi) |
description | string | Hayır | URL kodlu tahsilat açıklaması |
customerTakma ad: customer_id | string | Hayır | Mevcut Stripe müşteri kimliği |
email | string | Hayır | Makbuz için müşteri e-postası |
name | string | Hayır | URL kodlu müşteri adı |
metadata | string | Hayır | Özel anahtar-değer çiftleri (URL kodlu JSON) |
callback | string | Hayır | İşlem tamamlandıktan sonra geri dönülecek URL |
autoprocessTakma ad: auto | boolean | Hayır | Ana ekranı atla ve tahsilatı hemen başlat |
auto_return | boolean | Hayır | Sonuç yüklendiğinde, satıcının sonuç iletişim kutusunu kapatmasını beklemek yerine geri çağırma işlevini tetikleyin. Varsayılan değer false'tur. |
Kataloğunuzdaki Ürünleri Satın
payment://cart?Stripe kataloğunuzdaki fiyatlarla sepeti doldurun ve yüz yüze ödeme için ürünleri seçin. Satış, ödenmiş bir Stripe faturası olarak kaydedilir. Müşteriye hiçbir şey gönderilmez.
Parametreler
| İsim | Tip | Gerekli | Açıklama |
|---|---|---|---|
pricesTakma ad: line_items | string | Evet | Miktar bilgileriyle birlikte virgülle ayrılmış fiyat kimlikleri (örneğin, price_abc:2,price_xyz:1) |
coupon | string | Hayır | Sepete uygulanacak Stripe kupon kodu |
customerTakma ad: customer_id | string | Hayır | Mevcut Stripe müşteri kimliği |
email | string | Hayır | Makbuz için müşteri e-postası |
name | string | Hayır | URL kodlu müşteri adı |
metadata | string | Hayır | Özel anahtar-değer çiftleri (URL kodlu JSON) |
callback | string | Hayır | İşlem tamamlandıktan sonra geri dönülecek URL |
autoprocessTakma ad: auto | boolean | Hayır | Ana ekranı atla ve tahsilatı hemen başlat |
auto_return | boolean | Hayır | Sonuç yüklendiğinde, satıcının sonuç iletişim kutusunu kapatmasını beklemek yerine geri çağırma işlevini tetikleyin. Varsayılan değer false'tur. |
Mevcut Faturayı Öde
payment://invoice?Mevcut bir Stripe faturasına karşı şahsen ödeme alın. Tutar, para birimi, müşteri ve vergi faturadan alınır. Bunlardan herhangi birinin değiştirilmesi reddedilir. Satıcı, kartı okuyucu/ Tap to Pay /manuel giriş yoluyla okutur; başarılı olursa fatura bant dışı ödenmiş olarak işaretlenir ve charge_id ve payment_intent_id meta verileriyle ilişkilendirilir. Abonelikli, default_payment_method veya ödenmiş, geçersiz veya tahsil edilemez durumdaki faturalar, işlem yapılabilir bir hata ile reddedilir. Taslak faturalar: iOS bunları önce kesinleştirir, Android bunları invoice_state_changed ile reddeder.
Parametreler
| İsim | Tip | Gerekli | Açıklama |
|---|---|---|---|
id | string | Evet | Stripe fatura kimliği (in_ ile başlamalıdır) |
callback | string | Hayır | İşlem tamamlandıktan sonra geri dönülecek URL. Başarılı olması durumunda invoice_id ve payment_intent_id bilgilerini alır. |
metadata | string | Hayır | PaymentIntent meta verileriyle birleştirilen özel anahtar-değer çiftleri (URL kodlu JSON) |
autoprocessTakma ad: auto | boolean | Hayır | Ana ekranı atla ve tahsilatı hemen başlat |
auto_return | boolean | Hayır | Sonuç yüklendiğinde, satıcının sonuç iletişim kutusunu kapatmasını beklemek yerine geri çağırma işlevini tetikleyin. Varsayılan değer false'tur. |
Geri çağırmaları işleme
İşlem tamamlandığında, Payment for Stripe sonucu gösteren sorgu parametreleriyle birlikte geri çağırma URL'nize yönlendirir. Varsayılan olarak, yönlendirme, satıcı sonuç iletişim kutusunu kapattıktan sonra gerçekleşir, böylece satıcı işlem sonrası eylemler (makbuz gönderme, para iadesi) gerçekleştirebilir. Sonuç bilinir bilinmez tetiklenmesi için auto_return=true parametresini kullanın. iOS ve Android'de desteklenmektedir.
Geri Çağırma Parametreleri
| Parametre | Değerler | Açıklama |
|---|---|---|
status | success | error | cancelled | İşlemin sonucu |
charge_id | string | Stripe ödeme kimliği (başarı durumunda). iOS ödeme kimliğini (ch_) gönderir. Android ise PaymentIntent kimliğini (pi_) gönderir ve ödeme kimliğini stripe_charge_id'ye yerleştirir. |
stripe_charge_id | string | Başarılı ödeme durumunda Stripe ödeme kimliği (ch_) görüntülenecektir. Sadece Android cihazlarda çalışır. |
invoice_id | string | Stripe fatura kimliği (başarılı ödeme durumunda, yalnızca payment://invoice akışı için) |
payment_intent_id | string | Stripe PaymentIntent ID (başarı durumunda). iOS: Yalnızca payment://invoice akışı. Android: Her kart işlemi. |
error | string | Hata mesajı (hata durumunda) |
Ödeme alındı ancak fatura ödenmiş olarak işaretlenemedi: iOS, charge_id, invoice_id ve payment_intent_id ile birlikte status=error değerini döndürüyor. Android ise invoice_reconciliation_failed=true ile birlikte status=success değerini döndürüyor.
Eski entegrasyonlar için saklanan eski alanlar: success, amount, currency, chargeId, cancelled, error[message]. Yeni entegrasyonlar yukarıdaki alanları okumalıdır.
Örnekler
Basit tahsilat
Yalnızca tutar girerek $10,00 tahsil edin
payment://new?amount=1000Açıklamalı tahsilat
Açıklamayla €25,00 tahsil edin
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryYeni müşteriyle tahsilat
$50,00 tahsil edin ve müşteri kaydı oluşturun
payment://new?amount=5000&name=John%20Smith&[email protected]Mevcut müşteriden tahsilat
Mevcut bir Stripe müşterisinden $75,00 tahsil edin
payment://new?amount=7500&customer=cus_ABC123xyzMeta verilerle tahsilat
Kayıtlarınız için özel meta verilerle $100,00 tahsil edin
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DGeri çağırma ile otomatik işlem
Ana ekranı atlayın ve işiniz bitince uygulamanıza dönün
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeSonuç üzerine otomatik geri dönüş
Satıcının sonuç iletişim kutusunu kapatmasını beklemek yerine, sonuç belli olur olmaz geri çağırma işlevini çalıştırın
payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-completeÜrün kalemlerini içeren sepet
Stripe kataloğunuzdaki ürünler için ücretlendirme yapın.
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Mevcut bir faturayı ödeyin
Mevcut bir Stripe faturası için yüz yüze ödeme alın. Başarılı olursa invoice_id ve payment_intent_id değerlerini döndürür.
payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paidTam örnek
Tamamen entegre bir akış için tüm parametreler bir araya getirildi
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-resultURL Kodlaması
Parametre değerlerindeki özel karakterleri URL kodlamasıyla dönüştürmeyi unutmayın. Boşluklar %20, süslü parantezler ise %7B ve %7D olarak kodlanır.
Entegrasyona hazır mısınız?
Uygulamayı indirin ve entegrasyonunuzu test etmeye bugün başlayın.