Geliştirici API'si
ile entegre edin URL şemaları
İşlemleri gerçekleştirmek için uygulamanızdan veya web sitenizden Stripe için Ödeme özelliğini başlatın. Müşteri verilerini, tutarları ve ürün bilgilerini iletin, ardından işlem tamamlandığında geri bildirimi işleyin.
Nasıl çalışır?
Uygulamanız açılıyor ödeme:// Parametreler içeren URL
Stripe ödeme sistemi 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
Bir Ücret Oluşturun
payment://new?Tutar, para birimi ve açıklama bilgilerini kullanarak tek seferlik bir ödeme işlemi gerçekleştirin.
Parametreler
| İsim | Tip | Gerekli | Tanım |
|---|---|---|---|
amount | integer | Evet | Miktar sent cinsinden (örneğin, 1000 = 10,00 $) |
currency | string | HAYIR | Üç harfli ISO para birimi kodu (varsayılan: USD) |
description | string | HAYIR | URL kodlu ücret açıklaması |
customer | string | HAYIR | Mevcut Stripe müşteri kimliği |
email | string | HAYIR | Müşterinin teslimat için e-posta adresi. |
name | string | HAYIR | URL kodlu müşteri adı |
metadata | string | HAYIR | Özel anahtar-değer çiftleri (URL kodlu JSON) |
callback | string | HAYIR | İşlem tamamlandıktan sonra geri dönülecek URL |
autoprocess | boolean | HAYIR | Ana ekrana geç ve şarj işlemine hemen başla |
Fatura Oluştur
payment://cart?Ürün kataloğunuzdaki kalemleri kullanarak bir Stripe faturası oluşturun.
Parametreler
| İsim | Tip | Gerekli | Tanım |
|---|---|---|---|
prices | string | Evet | Miktar bilgileriyle birlikte virgülle ayrılmış fiyat kimlikleri (örneğin, price_abc:2,price_xyz:1) |
customer | string | HAYIR | Mevcut Stripe müşteri kimliği |
email | string | HAYIR | Müşterinin teslimat için e-posta adresi. |
name | string | HAYIR | URL kodlu müşteri adı |
callback | string | HAYIR | İşlem tamamlandıktan sonra geri dönülecek URL |
Geri aramaların işlenmesi
İşlem tamamlandığında, Stripe Ödeme sistemi, sonucu gösteren sorgu parametreleriyle birlikte geri çağırma URL'nize yönlendirir.
Geri Çağrı Parametreleri
| Parametre | Değerler | Tanım |
|---|---|---|
status | success | error | cancelled | İşlemin sonucu |
charge_id | string | Stripe ödeme kimliği (başarılı olduğunda) |
error | string | Hata mesajı (hata durumunda) |
Örnekler
Basit şarj
Sadece bir miktar belirterek 10,00$ tahsil edin.
payment://new?amount=1000Açıklamalı suçlama
Açıklama ile birlikte 25,00 € ücret alınır.
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryYeni müşteriyle birlikte ücretlendirme
50,00$ ücret alın ve müşteri kaydı oluşturun.
payment://new?amount=5000&name=John%20Smith&[email protected]Mevcut müşteriden ücret alın.
Mevcut bir Stripe müşterisinden 75,00 $ tahsil edin.
payment://new?amount=7500&customer=cus_ABC123xyzMeta verilerle şarj etme
Kayıtlarınız için özel meta verilerle birlikte 100,00 ABD doları ücret alınır.
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 fonksiyonu ile otomatik işlem
İşiniz bittiğinde ana ekrana geç ve uygulamanıza geri dön.
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeKalem kalem detaylı fatura
Stripe kataloğunuzdaki ürünlerle bir fatura oluşturun.
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Tam ö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.