Cüzdana Para Yatırma

Üye cüzdanına 2 şekilde para yatırılabilir. Bunlardan biri, cüzdana kart ile para yüklemek. İkincisi ise üyenin banka hesabınıza yaptığı EFT/Havale işlemine istinaden para yatırabilirsiniz.

1. Cüzdana Kart İle Para Yatırma

Üye cüzdanına banka kredi ve debit kartları ile para yüklemek için bu servisi kullanabilirsiniz.

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
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.

2. Cüzdana EFT/Havale İle Para Yatırma

Banka hesaplarınıza üyeden gelen eft/havale işlemine istinaden üye cüzdanına para yatırabilirsiniz.

URL

Üye cüzdanına eft/havale işlemine göre para yatırmak için kullanılan endpoint ve http metod bilgisi aşağıda verilmiştir.

HTTP Metod URL
POST /payment/v1/deposits/fund-transfer

İstek Parametreleri

Üye cüzdanına eft/havale işlemine göre 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
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
clientIp string Hayır Ödeme yapan alıcının IP adresi.

Dönüş Parametreleri

Üye cüzdanına başarıyla para yatırma işlemi tamamlandı ise HTTP 204 kodu ile cevap dönülmektedir. Bu kod dışındaki bir HTTP kodu, işlemin başarısız sonuçlandığını ifade eder.

Örnek Kodlar

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