# 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>](/ortam.md)
{% 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.paywall.one/cuzdan-servisleri/6.-hediye-bakiye/2.-olustur-alias.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.