Bir ödeme gönder
Kimliği doğrulanmış müşterinin güncel sepetini işler ve bir sipariş oluşturur.İ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:- Sipariş oluşturuldu —
pending_payment(yönlendirme yöntemleri) veyapaid(cüzdan) durumuyla yeni bir sipariş kaydı yazılır. - Ödeme onaylandı — Yönlendirme tabanlı yöntemlerde GurStore, ödeme sağlayıcısının webhook’unu dinler. Ödeme onaylandığında sipariş durumu
paidolur. - Dijital teslimat başlar — Sipariş
paidolarak 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.
order_id ile sorgulamak için müşteri siparişleri uç
noktasını kullanın.
