# 2. Oluştur (Alias)

## Cüzdan 'Alias' ile Hediye Bakiye Oluştur

<mark style="color:yellow;">`POST`</mark>`{{WalletUrl}}/api/v1/balance/gift/by/wallet/alias`&#x20;

{% hint style="info" %}
Not: Bu servisin kullanılabilmesi için **apikeypublic** ve **apiclientpublic** parametrelerinin Header alanına eklenmiş olması zorunludur.

\
[<mark style="color:green;">**WalletAPI Adresi**</mark>](https://developer.paywall.one/ortam)
{% endhint %}

**Servise gönderilmesi gereken parametreler şu şekildedir:**

<table><thead><tr><th width="162">Parametre</th><th width="79">Tip</th><th width="107">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Evet</td><td>API servislerine genel erişimi sağlayan ortak anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>İstemci uygulamayı tanımlayan açık istemci anahtar bilgisidir.</td></tr></tbody></table>

{% tabs %}
{% tab title="Servis İstek - Json" %}
{% code lineNumbers="true" %}

```json
{
    "Alias": "2816220769",
    "Amount": 100.00,
    "ExternalReference": "{{$guid}}",
    "ExpirationDate": null,
    "Description": "External Gift Balance"
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Servis İstek

| Parametre         | Tip       | Açıklama                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Alias             | string    | Hediye bakiyenin tanımlanacağı cüzdan numarası                                                                                                                                                                                                                                                                                                                                          |
| Amount            | decimal   | Tanımlanacak hediye bakiye                                                                                                                                                                                                                                                                                                                                                              |
| ExpirationDate    | DateTime? | <p>Eğer ilgili hediye bakiye belirli bir tarihe kadar geçerli olsun istiyorsanız. Tarih tanımı yapabilirsiniz.<br><br><mark style="color:purple;">Eğer tarih verirseniz,</mark> ilgili tutar o tarihe kadar harcanmazsa otomatik olarak kullanım dışı kalır.<br><br><mark style="color:orange;">Eğer tarih verilmezse,</mark> ilgili tutar kullanılana kadar cüzdanda tanımlı kalır</p> |
| Description       | string    | <p>Verilen hediye bakiyenin açıklaması<br><br>Örnek: "Doğum günü"</p>                                                                                                                                                                                                                                                                                                                   |
| ExternalReference | string    | İşlemin sisteminiz tarafından takip edilebilmesi için takip numarası                                                                                                                                                                                                                                                                                                                    |

{% tabs %}
{% tab title="Servis Cevap - Json" %}
{% code lineNumbers="true" %}

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "47c4ec69-58d2-415c-841e-c1144542181b",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "Amount": 100.00,
        "RemainingAmount": 100.00,
        "ExpirationDate": null,
        "IsUnlimited": true,
        "Description": "External Gift Balance",
        "LastTransactionId": null,
        "CreatedAt": "2025-08-20T14:33:15.741943Z",
        "UpdatedAt": null
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Servis Cevap

<table><thead><tr><th width="192">Parametre</th><th width="147.89192708333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>İşlem başarısızsa false, değilse true döner.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlem başarılıysa true, aksi halde false döner.</td></tr><tr><td>Errors</td><td>Array</td><td>Oluşan hata detaylarını içeren dizi yapısıdır.</td></tr><tr><td>Value</td><td>Array</td><td>Sonuç verilerini içeren öğe listesini barındırır.</td></tr></tbody></table>

## Servis Cevap (Value)

<table><thead><tr><th width="234.05859375">Parametre</th><th width="162.38671875">Tip</th><th width="348.94140625">Açıklama</th></tr></thead><tbody><tr><td>Id</td><td>Guid</td><td>Bu kayda özel sistem tarafından atanmış ID'dir.</td></tr><tr><td>WalletId</td><td>Guid</td><td>Hangi cüzdanla ilişkili olduğunu gösteren kimlik numarasıdır.</td></tr><tr><td>Amount</td><td>string</td><td>Kullanıcıya tanımlanan toplam tutar (örneğin: "100.00").</td></tr><tr><td>RemainingAmount</td><td>decimal</td><td>Kullanıcının harcayabileceği mevcut bakiye.</td></tr><tr><td>ExpirationDate</td><td>decimal</td><td>Bu tutarın geçerli olduğu son tarih.</td></tr><tr><td>IsUnlimited</td><td>string</td><td>Süresiz geçerliliğe sahip olup olmadığını belirtir.</td></tr><tr><td>Description</td><td>string</td><td>Bu tutarın amacı veya açıklayıcı notu.</td></tr><tr><td>IsUsed</td><td>DateTime</td><td>İlk harcama işleminin gerçekleştiği zaman.</td></tr><tr><td>IsFullyUsed</td><td>DateTime</td><td>Kullanıcının tüm tutarı kullandığı zaman.</td></tr><tr><td>IsPartiallyUsed</td><td>decimal</td><td>Harcanan kısmın miktarı (örneğin: 25.50).</td></tr><tr><td>LastTransactionId</td><td>Guid</td><td>Son işlemle ilişkili benzersiz ID numarası.</td></tr><tr><td>CreatedAt</td><td>Guid</td><td>Bu kayıt ne zaman oluşturuldu (tarih bilgisi olmalı).</td></tr><tr><td>UpdatedAt</td><td>int</td><td>Bilgilerin son kez güncellendiği zamanı belirtir.</td></tr></tbody></table>