Ü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.
Üye cüzdanına banka kredi ve debit kartları ile para yüklemek için bu servisi kullanabilirsiniz.
Ü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 |
Ü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. |
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.
Ü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 |
walletTransaction |
WalletTransaction |
(bkz. Cüzdan İşlemi) Cüzdana para yatırma sırasında oluşan cüzdan işlem kaydı |
fraudId |
number |
Şüpheli işlem olarak belirlenmesi durumunda şüpheli işlem kaydına ait id bilgisi (bkz: Şüpheli İşlem Yönetimi) |
fraudAction |
FraudAction |
Şüpheli işlem olarak belirlenmesi durumunda şüpheli işlem kaydına ait aksiyon bilgisi (bkz: Şüpheli İşlem Aksiyonları) |
Cüzdandaki işlemine ait bilgileri içerir.
| Parametre Adı | Tipi | Açıklama |
|---|---|---|
id |
number |
Cüzdan işlemi ID değeri |
walletTransactionType |
string |
Cüzdan işlem tipi |
amount |
decimal |
Cüzdan işlemi tutarı |
walletId |
number |
Cüzdan ID değeri |
Cüzdana yatırılan parayı karta iade etmek için Cüzdandan İade sayfasını ziyaret edin.
Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.
Banka hesaplarınıza üyeden gelen eft/havale işlemine istinaden üye cüzdanına para yatırabilirsiniz.
Ü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 |
Ü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. |
Ü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 |
|---|---|---|
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 |
walletTransaction |
WalletTransaction |
(bkz. Cüzdan İşlemi) Cüzdana para yatırma sırasında oluşan cüzdan işlem kaydı |
Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.