13. Para Transferi (Wallet)

Cüzdanlar arası para transferi yapmak için bu servisi kullanabilirsiniz

Cüzdan 'Id' ile Para Transferi

POST {{WalletUrl}}/api/v1/wallet/transfer

Not: Bu servisin kullanılabilmesi için apikeypublic ve apiclientpublic parametrelerinin Header alanına eklenmiş olması zorunludur.

WalletAPI Adresi

Gerekli header ve istek parametreleri:

Zorunlu header parametreleri

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	Servisi kullanabilmek için gerekli olan genel API anahtarı.
apiclientpublic	string	Evet	Servis erişimi için gerekli olan istemci kimliği.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
SourceWalletId	Guid	Evet	Para'nın çıkacağı hesabın kimlik bilgisi
DestinationWalletId	Guid	Evet	Para'nın iletileceği hesabın kimlik bilgisi
Amount	decimal	Evet	Transfer edilecek tutar.
Description	string	Hayır	İşleme ait açıklama veya not. Opsiyoneldir.
ExternalReference	string	Evet	Kendi sisteminizdeki işleme ait benzersiz referans numarası. Aynı referansın tekrar gönderilmesi durumunda işlem reddedilebilir
ExternalTransactionTypeId	Guid	Hayır	Kendi sisteminizdeki işlem tipini UUID olarak belirtir. ExternalTransactionTypeEnum ile birlikte kullanılabilir, ikisi birbirinin alternatifidir.
ExternalTransactionTypeEnum	string	Hayır	Kendi sisteminizdeki işlem tipini string olarak belirtir. ExternalTransactionTypeId ile birlikte kullanılabilir, ikisi birbirinin alternatifidir.

İş Kuralları

• Kaynak ve hedef cüzdanların Merchant altında aktif olarak kayıtlı olması gerekmektedir.

• Kaynak ve hedef cüzdan farklı olmalıdır, aynı cüzdana transfer yapılamaz.

• Transfer yalnızca aynı para birimine sahip cüzdanlar arasında gerçekleştirilebilir.

• Silinmiş veya dondurulmuş kaynak ya da hedef cüzdanlar üzerinde işlem gerçekleştirilemez.

• Amount sıfırdan büyük olmalıdır.

• ExternalReference aynı Merchant kapsamında benzersiz olmalıdır.

• ExternalTransactionType gönderildiğinde sistemde tanımlı ve aktif olmalıdır. İlgili işlem tipine özel limitler uygulanır, genel transfer limitleri dikkate alınmaz.

• ExternalTransactionType gönderilmediğinde genel transfer limitleri uygulanır.

• İşlem öncesinde kaynak cüzdanın kullanılabilir bakiyesi, transfer tutarı ve varsa komisyon tutarını karşılamalıdır.

• Aynı kaynak cüzdana 2 saniye içinde tekrar gönderilen transfer istekleri reddedilir.

• Kaynak ve hedef cüzdanlar için ayrı komisyon hesaplanabilir; her komisyon ilgili cüzdanın bakiyesinden düşülür.

• Transfer işlemlerinde cashback veya bonus uygulanmaz.

Servise gönderilecek örnek bir JSON dosyası şu şekildedir :

JSON

{
    "SourceWalletId": "eb6d76b1-eddc-4ce4-8538-93696ff15fa2",
    "DestinationWalletId": "1fef5f3f-3c7b-4aa7-b0dd-713ba391765d",
    "Amount": 10.00,
    "Description": "transfer",
    "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
    "ExternalTransactionTypeId": null,
    "ExternalTransactionTypeEnum": null
}

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
IsFailure	bool	İşlemin başarısız olup olmadığını belirtir.
IsSuccess	bool	İşlemin başarılı olup olmadığını belirtir.
Errors	Array	İşlem sırasında oluşan hata mesajlarını içerir.
Value	Array<Items>	İşlem sonucu dönen veri kümesini içerir.
TransferId	Guid	Transfer işleminin kimlik bilgisi
SourceTransactionId	Guid	Kaynak cüzdan hesabı için üretilmiş işlemin kimlik bilgisi
DestinationTransactionId	Guid	Alıcı cüzdan hesabı için üretilmiş işlemin kimlik bilgisi
SourceWalletId	Guid	Kaynak cüzdan kimlik bilgisi
DestinationWalletId	Guid	Alıcı cüzdan kimlik bilgisi
SourceWalletBalanceAfterTransaction	decimal	Kaynak cüzdanın işlem sonrasındaki bakiyesi
DestinationWalletBalanceAfterTransaction	decimal	Alıcı cüzdanın işlem sonrasındaki bakiyesi

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "TransferId": "58b33aa2-815d-4e03-977d-a7ce72615988",
        "SourceTransactionId": "6077149a-6eb2-4a18-844b-54afcfd1346f",
        "DestinationTransactionId": "644f2da5-7404-40bf-9284-3a3800407a9d",
        "SourceWalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "DestinationWalletId": "2ea244d1-6ed2-4eca-a84b-273c62f64606",
        "SourceWalletBalanceAfterTransaction": 0.80,
        "DestinationWalletBalanceAfterTransaction": 2.00
    }
}