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

Uygulamanızdan veya web sitenizden ödeme başlatın, müşteri verilerini iletin ve callback'leri işleyin.

Meta veri ile ürün gizleme

Yalnızca çevrimiçi satılan ürünleri tek bir meta veri anahtarıyla uygulamanın dışında tutun.

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: USD)
`description`	string	Hayır	URL kodlu tahsilat açıklaması
`customer`	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
`autoprocess`	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.

Fatura Oluştur

payment://cart?

Ürün kataloğunuzdaki kalemleri kullanarak bir Stripe faturası oluşturun.

Parametreler

İsim	Tip	Gerekli	Açıklama
`prices`	string	Evet	Miktar bilgileriyle birlikte virgülle ayrılmış fiyat kimlikleri (örneğin, price_abc:2,price_xyz:1)
`customer`	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ı
`callback`	string	Hayır	İşlem tamamlandıktan sonra geri dönülecek URL
`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 (Sadece iOS)

payment://invoice?

Mevcut bir Stripe faturası için yüz yüze ödeme alın. Tutar, para birimi, müşteri ve vergi faturadan alınır; bunlardan herhangi birini değiştirme girişimi reddedilir. Satıcı kartı okuyucu, Tap to Pay veya manuel giriş ile alır; başarılı olursa fatura Stripe dışında ödenmiş (out-of-band) olarak işaretlenir ve charge_id ile payment_intent_id meta verileriyle ilişkilendirilir. Aboneliğe bağlı, default_payment_method içeren veya durumu açık olmayan faturalar, ne yapılacağını belirten bir hatayla reddedilir.

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)
`autoprocess`	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ılı olduğunda)
`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ılı ödeme durumunda, yalnızca payment://invoice akışı için)
`error`	string	Hata mesajı (hata durumunda)

Örnekler

Basit tahsilat

Yalnızca tutar girerek $10,00 tahsil edin

payment://new?amount=1000

Açıklamalı tahsilat

Açıklamayla €25,00 tahsil edin

payment://new?amount=2500&currency=eur&description=Coffee%20and%20pastry

Yeni 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_ABC123xyz

Meta 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%7D

Geri ç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-complete

Sonuç ü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

Kalem kalem detaylı fatura

Stripe kataloğunuzdaki ürünlerle bir fatura oluşturun

payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]

Mevcut bir faturayı öde (iOS)

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-paid

Tam örnek

Tamamen entegre bir akış için tüm parametreler bir araya getirildi

payment://new?amount=15000&currency=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-result

URL 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.

Meta veri ile ürün gizleme

Ürünleri uygulamada gizleme

Uygulama, Stripe hesabınızdaki ürünleri ve fiyatları listeler. Birini uygulamanın dışında tutmak için (örneğin yalnızca çevrimiçi mağazanızda satılan ürünler), Stripe Kontrol Paneli'nde ürüne veya fiyata şu meta veri anahtarını ekleyin:

payment_hidden = true

Bir üründe: ürünü ve tüm fiyatlarını gizler.

Bir fiyatta: yalnızca o fiyatı gizler.

Yeniden göstermek için anahtarı kaldırın veya false yapın. Değişiklikler, uygulama ürün listenizi bir sonraki yükleyişinde geçerli olur.

Sepet bağlantıları çalışmaya devam eder

Gizleme yalnızca uygulama içindeki ürün listesini etkiler. Gizli bir fiyata başvuran payment://cart URL'leri çalışmaya devam eder ve mevcut abonelikler etkilenmez.

Entegrasyona hazır mısınız?

Uygulamayı indirin ve entegrasyonunuzu test etmeye bugün başlayın.

iOS için indir Android için indir

Destek ile iletişime geçin