Cüzdana Para Yatırma

URL

Üye cüzdanına para yatırmak için kullanılan endpoint ve http metod bilgisi aşağıda verilmiştir.

HTTP Metod URL
POST /payment/v1/deposits

İstek Parametreleri

Üye cüzdanına para yatırmak için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.

Parametre Adı Tipi Zorunlu Açıklama
price decimal Evet Yatırılacak tutar
buyerMemberId number Evet Ödemenin ilişkilendirildiği alıcı ID'si. Üye işyerinin kendi sistemlerindeki ID değerini değil, Craftgate sistemlerindeki ID değerini ifade eder
currency Currency Evet bkz: Para Birimleri Ödemenin tahsil edileceği para birimi
conversationId string Hayır İstekle beraber gönderilip, cevapla birlikte alınabilecek, "bumerang" değer. Farklı istekleri birbirleriyle ilişkilendirmek için kullanılabilir. Genellikle üye işyerinin ödemeye ilişkin sipariş numarası kullanılır
posAlias string Hayır Ödemeyi geçirmek istediğiniz posun alias değeri
card Card Hayır (bkz. Kart Bilgileri) Tahsilatın gerçekleştirileceği kart bilgileri
clientIp string Hayır Ödeme yapan alıcının IP adresi.

Kart Bilgileri

Gönderilen kart bilgilerindeki cardUserKey alanı doluysa Saklı Kart Bilgileri bölümündeki alanlar geçerlidir, diğer durumlar için bkz. Kredi Kartı, Debit Kart ya da Prepaid Kart Bilgileri.

Dönüş Parametreleri

Üye oluşturma işleminin sonucunda dönen parametreler de API dokümantasyonu giriş sayfasındaki Dönüş Formatları bölümünde belirtilen kurallara tabidir. Sistemsel ya da kurgusal bir hata bulunmadığı durumda data parametresinde dönen objenin alt parametreleri aşağıdaki gibidir:

Parametre Adı Tipi Açıklama
id number Ödemenin ID'si
createdDate date Ödemenin gerçekleştirildiği tarih
price decimal Cüzdana yatırılan tutar
currency string Ödemeye ilişkin para birimi
buyerMemberId number Alıcı üyeyle ilişkilendirilmiş ödemelerde yer alan, ilgili üyenin ID'sini belirten değer
conversationId string Üye işyeri tarafından ödeme isteği içerisinde gönderilen conversationId değeri
paymentType PaymentType bkz: Ödeme Tipleri
paymentStatus PaymentStatus bkz: Ödeme Durumu
authCode string Ödemeye ilişkin banka tarafından verilen authCode değeri
hostReference string Ödemeye ilişkin banka tarafından verilen hostReference değeri
transId string Ödemeye ilişkin banka tarafından verilen transId değeri
orderId string Ödemeye ilişkin banka tarafından verilen orderId değeri
cardUserKey string İsteği yapılırken kart bilgileri alanındaki storeCardAfterSuccessPayment alanı true gönderilen ödemelerde yer alır. Başarılı ödeme sonrası kaydedilen kartın saklı kart anahtarını ifade eder. Üye işyeri tarafından müşteriyle ilişkilendirilerek saklanmalıdır
cardToken string İsteği yapılırken kart bilgileri alanındaki storeCardAfterSuccessPayment alanı true gönderilen ödemelerde yer alır. Başarılı ödeme sonrası kaydedilen kartın saklı kart kodunu ifade eder. Üye işyeri tarafından müşteriyle ilişkilendirilerek saklanmalıdır

Cüzdana Yatırılan Parayı İade Etme

Cüzdana yatırılan parayı karta iade etmek için Cüzdandan Karta İade sayfasını ziyaret edin.

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.