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 |
auto_return | boolean | HAYIR | 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 | 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 |
auto_return | boolean | HAYIR | 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 aramaların işlenmesi
İşlem tamamlandığında, Stripe Ödeme uygulaması, 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ğ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-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-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.