Skip to main content
GurStore ödeme uç noktası, kimliği doğrulanmış müşterinin aktif sepetini onaylı bir siparişe dönüştürür. Bu uç noktayı çağırdığınızda GurStore; sepet içeriğini doğrular, aktif kuponu uygular, nihai toplamı hesaplar ve belirtilen ödeme yöntemi için ödeme akışını başlatır. Başarılı olduğunda bir sipariş kimliği ve — yönlendirme tabanlı ödeme sağlayıcıları için — müşteriyi ödemeyi tamamlaması için göndereceğiniz bir URL alırsınız.

Bir ödeme gönder

Kimliği doğrulanmış müşterinin güncel sepetini işler ve bir sipariş oluşturur.
Kimlik doğrulama: Bearer belirteci gerekir

İstek gövdesi

string
required
Bu sipariş için kullanılacak ödeme sağlayıcısı. Kabul edilen değerler mağazanızın yapılandırılmış entegrasyonlarına bağlıdır. Yaygın seçenekler:
  • "stripe" — Stripe Checkout’a yönlendirmeyle Stripe ödeme işleme
  • "iyzico" — Türk pazarı entegrasyonları için Iyzico ödeme işleme
  • "wallet" — Sipariş toplamını doğrudan müşterinin GurStore cüzdan bakiyesinden düşer (anında işlenir, yönlendirme yok)
string
Başarılı bir ödemeden sonra müşterinin yönlendirileceği URL. Yönlendirme tabanlı ödeme yöntemlerinde (stripe, iyzico) zorunludur. Protokol dahil mutlak bir URL olmalıdır (ör. https://example.com/orders/success).
string
Müşteri ödeme akışını iptal eder veya yarıda bırakırsa yönlendirileceği URL. Yönlendirme tabanlı ödeme yöntemleri için önerilir. Mutlak bir URL olmalıdır.
string
Ödemede uygulanacak isteğe bağlı bir kupon kodu. Kuponu zaten POST /api/store/cart/coupon ile uyguladıysanız, burada tekrar iletmenize gerek yoktur — sepette zaten yansıtılmıştır. Bu alanı yalnızca ayrı bir sepet adımı olmadan ödeme anında bir kupon uygulamak istiyorsanız kullanın.

Örnek istek

Örnek başarılı yanıt

Yanıt alanları

string
Geçerli bir 200 yanıtında "success".
integer
Yeni oluşturulan siparişin benzersiz sayısal kimliği. Siparişi daha sonra müşteri siparişleri API’siyle aramak için bunu kullanın.
string
Müşteriye gösterilmeye veya fişlere ve onay e-postalarına dahil edilmeye uygun, okunabilir bir sipariş referans dizesi.
string
Bu sipariş için kullanılan ödeme yöntemi; gönderdiğiniz değeri yansıtır.
number
Tüm indirimler ve kupon düşümlerinden sonra tahsil edilen nihai sipariş toplamı.
string
Sipariş toplamı için ISO 4217 para birimi kodu (ör. "USD", "EUR", "TRY").
string | null
Ödemeyi tamamlamak için müşterinin yönlendirileceği URL. Yönlendirme tabanlı ödeme yöntemlerinde (stripe, iyzico) bulunur. Anında işlenen cüzdan ödemelerinde null.
string | null
Ödeme oturumunun ne zaman sona ereceğini belirten ISO 8601 zaman damgası. Bu süreden sonra müşteri ödemeyi yeniden başlatmalıdır. Cüzdan ödemelerinde null.

Örnek cüzdan ödemesi yanıtı

Cüzdan ödemeleri, ödeme isteği alındığı anda anında işlenir. Yönlendirme gerekmez ve payment_url döndürülmez. Müşterinin cüzdan bakiyesi sipariş toplamını karşılamaya yetmiyorsa API, eksiği belirten bir mesajla 422 hatası döndürür.

Ödeme Sonrası

Bir ödeme isteği başarılı olduğunda GurStore, teslimat yaşam döngüsünü otomatik olarak devralır:
  1. Sipariş oluşturuldupending_payment (yönlendirme yöntemleri) veya paid (cüzdan) durumuyla yeni bir sipariş kaydı yazılır.
  2. Ödeme onaylandı — Yönlendirme tabanlı yöntemlerde GurStore, ödeme sağlayıcısının webhook’unu dinler. Ödeme onaylandığında sipariş durumu paid olur.
  3. Dijital teslimat başlar — Sipariş paid olarak işaretlenir işaretlenmez GurStore dijital ürünleri otomatik teslim eder — lisans anahtarları üretilir ve e-postayla gönderilir, indirme bağlantıları etkinleştirilir ve yapılandırılmış webhook’lar tetiklenir.
Teslimatı tetiklemek için API’yi yoklamanıza (poll) gerek yoktur. Ödeme sonrası sipariş durumunu programatik olarak izlemek isterseniz, siparişi order_id ile sorgulamak için müşteri siparişleri uç noktasını kullanın.