Skip to main content
Cüzdan ve talep uç noktaları; iki temel hesap yönetimi akışı üzerinde programatik kontrol sağlar: cüzdan fonlarınızı kontrol etme ve çekme, destek talebi açma veya inceleme. Bu uç noktaları; hesap bakiyesi bilgilerini ve destek geçmişini GurStore mağazasına giriş gerektirmeden göstermek için kendi araçlarınıza, faturalandırma panolarınıza veya müşteri portallarınıza entegre edebilirsiniz.

GET /api/customer/wallet

Güncel cüzdan bakiyenizi, tutulduğu para birimini ve cüzdan hesabınızdaki işlemlerin geçmişini döndürür.

Kimlik doğrulama

Bearer belirtecinizi Authorization başlığına ekleyin.

Örnek istek

Örnek yanıt

Yanıt alanları

string
required
Geçerli, kimliği doğrulanmış bir istekte "success" döndürür.
number
required
Harcanabilir güncel cüzdan bakiyeniz.
string
required
Cüzdanınız için ISO 4217 para birimi kodu (örneğin "USD" veya "EUR").
array
required
Cüzdan işlemlerinin kronolojik listesi. Her giriş bir id, bir type ("credit" veya "debit"), amount, okunabilir bir description ve bir created_at zaman damgası içerir.

POST /api/customer/wallet/withdraw

Cüzdan bakiyenizden belirtilen tutar için bir çekim talebi gönderir. Çekim talepleri beklemede durumuna girer ve fonlar serbest bırakılmadan önce mağaza yöneticisi tarafından incelenir.

Kimlik doğrulama

Bearer belirtecinizi Authorization başlığına ekleyin.

İstek gövdesi

number
required
Cüzdanınızdan çekmek istediğiniz tutar. Pozitif bir sayı olmalı ve güncel kullanılabilir bakiyenizi aşamaz. Değer, cüzdanınızın varsayılan para biriminde ifade edilir.

Örnek istek

Örnek yanıt

Çekim talepleri anında işlenmez. Bu isteği gönderdikten sonra bir "pending" durumuna girer ve bir mağaza yöneticisi tarafından onaylanması gerekir. Çekiminiz onaylandığında veya reddedildiğinde bir bildirim alırsınız. Bir talep hâlâ beklemedeyken aynı tutar için yinelenen talepler göndermeyin.
Güncel cüzdan bakiyenizden büyük bir amount ile çekim talebi göndermek bir doğrulama hatası döndürür. Çekim göndermeden önce bakiyenizi daima GET /api/customer/wallet ile kontrol edin.

GET /api/customer/tickets

Hesabınızda açtığınız tüm destek taleplerini; güncel durumları ve atandıkları departman dahil listeler.

Kimlik doğrulama

Bearer belirtecinizi Authorization başlığına ekleyin.

Örnek istek

Örnek yanıt


POST /api/customer/tickets

Hesabınızda yeni bir destek talebi açar. Hedef departmanı, bir konu başlığını ve ilk mesajınızın gövdesini belirtmelisiniz. Talep anında oluşturulur ve inceleme için seçilen departmana atanır.

Kimlik doğrulama

Bearer belirtecinizi Authorization başlığına ekleyin.

İstek gövdesi

integer
required
Bu talebin yönlendirileceği destek departmanının kimliği. Kurulumunuz için doğru departman kimliklerini bulmak üzere mağaza yöneticinizle iletişime geçin veya mağazanın yardım merkezine bakın.
string
required
Talep için kısa, açıklayıcı bir konu başlığı. En fazla 255 karakter.
string
required
Destek talebinizin tam metni. Mümkün olduğunca ayrıntı verin — destek ekibinin talebinizi daha hızlı çözmesine yardımcı olmak için ilgili yerlerde sipariş kimliklerini, lisans anahtarlarını ve hata mesajlarını ekleyin.

Örnek istek

Örnek yanıt

Yanıt alanları

integer
required
Yeni oluşturulan destek talebinize atanan benzersiz kimlik. Talebinize gelecekteki isteklerde veya yazışmalarda başvurmak için bu değeri saklayın.
string
required
Gönderdiğiniz konu başlığı; onay için yanıtta geri yansıtılır.
string
required
Talebin yönlendirildiği departmanın görünen adı.
string
required
Talebin ilk durumu. Yeni oluşturulan talepler daima "open" durumundadır.
string
required
Talebin oluşturulduğu anın ISO 8601 zaman damgası.