Son Kullanıcı Oluşturma

POST /api/v1/wallet/end-users

Son kullanıcıyı oluşturur ve aynı işlemde varsayılan cüzdanını tek bir hesapla açar. Yanıt, kullanıcıyla birlikte bu cüzdanı ve hesabını döner.

Header'lar

Body alanları

Body yalnız aşağıdaki alanları içerebilir; listede olmayan bir alan 400 VALIDATION_ERROR ile reddedilir.

Telefon nasıl saklanır

Telefon numarası düz metin olarak saklanmaz. Normalize edilmiş rakamlardan tek yönlü bir özet (arama ve tekillik için) ve maskeli bir gösterim üretilir. Maskeli gösterim ilk 4 ve son 2 rakamı açık bırakır: +905321234567 → 9053******67. Yanıtlarda telefon yalnız phoneMasked olarak döner.

Görünen ad nasıl saklanır

displayName her kelimenin ilk harfi açık, kalan harfleri * olacak biçimde maskelenir (kelime başına en fazla 8 yıldız, toplam en fazla 64 karakter): Ayşe Yılmaz → A*** Y*****. Açık hâli saklanmaz ve geri okunamaz. Maskeli ad, cüzdan sorgulamada alıcı teyidi için gösterilir; göndermezseniz orada maskeli telefon gösterilir.

Açılış para birimi

Varsayılan cüzdan tek bir hesapla açılır. Para birimi şu sırayla belirlenir:

1. corporateAccountId verildiyse kurumsal hesabın fonlama para birimi. Bu durumda defaultCurrency gönderirseniz fonlama para birimiyle aynı olmalıdır; farklıysa istek 400 WALLET_VALIDATION ile reddedilir.
2. defaultCurrency verildiyse o para birimi.
3. Hiçbiri yoksa programınızın ana para birimi.

Programınızda ana para birimi tanımlı değilse ve defaultCurrency göndermediyseniz istek 409 WALLET_PROGRAM_CURRENCY_UNDESIGNATED ile reddedilir ve hiçbir kayıt oluşmaz. Programın para birimi listesinden tahmin yapılmaz. Başka para birimleri için sonradan hesap açın: Cüzdan ve Hesap Açma.

Idempotency

Idempotency-Key zorunludur ve isteği bir kez işlenecek şekilde bağlar:

• Aynı anahtarla aynı istek tekrarlanırsa ilk başarılı yanıt aynen döner; ikinci bir kullanıcı oluşmaz.
• Aynı anahtar farklı bir istekle kullanılırsa 409 WALLET_IDEMPOTENCY_CONFLICT döner. Karşılaştırmada programId, accountType, phone, externalCustomerId, corporateAccountId ve defaultCurrency dikkate alınır.
• İlk istek hata ile sonuçlandıysa anahtar serbest kalır; aynı anahtarla yeniden deneyebilirsiniz.

Tüm senaryolar ve önerilen entegrasyon deseni: Tekrar Oluşturma.

Örnek

curl -X POST "https://api-gateway.lunixi.com/api/v1/wallet/end-users" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: enduser-crm-88213" \
  -H "X-Key-Id: …" -H "X-Date: …" -H "X-Nonce: …" -H "Digest: …" -H "X-Signature: …" \
  -d '{"programId":"5b9e2f3a-7c41-4d8e-a6f2-9e1b3c4d5f60","accountType":"PERSONAL","phone":"+905321234567","externalCustomerId":"crm-88213","displayName":"Ayşe Yılmaz","defaultCurrency":"TRY"}'

{
  "status": "success",
  "code": "SUCCESS",
  "message": "…",
  "data": {
    "endUser": {
      "id": "8d4c2a1f-3b6e-4f7a-9c5d-2e8b1a0f6c34",
      "programId": "5b9e2f3a-7c41-4d8e-a6f2-9e1b3c4d5f60",
      "accountType": "PERSONAL",
      "externalCustomerId": "crm-88213",
      "corporateAccountId": null,
      "corporateOffboardedAt": null,
      "kycRef": null,
      "kycLevelCache": null,
      "kycLevelRefreshedAt": null,
      "phoneMasked": "9053******67",
      "displayNameMasked": "A*** Y*****",
      "merchantCategory": null,
      "status": "ACTIVE",
      "createdAt": "2026-10-11T09:15:02.418Z",
      "updatedAt": "2026-10-11T09:15:02.418Z"
    },
    "defaultWallet": {
      "id": "1e7f9a3b-5c2d-4a8e-b6f1-3d9c0e2a7b58",
      "endUserId": "8d4c2a1f-3b6e-4f7a-9c5d-2e8b1a0f6c34",
      "walletNo": "5810763412",
      "name": "Cüzdanım",
      "isDefault": true,
      "status": "ACTIVE",
      "accounts": [
        {
          "id": "c2a5e8f1-9d3b-4c7a-8e6f-5b1d2a9c0e47",
          "walletId": "1e7f9a3b-5c2d-4a8e-b6f1-3d9c0e2a7b58",
          "currency": "TRY",
          "accountCode": 5000,
          "fullWalletNo": "58107634125000",
          "status": "ACTIVE"
        }
      ],
      "createdAt": "2026-10-11T09:15:02.418Z"
    }
  },
  "requestId": "…"
}

endUser alanlarının anlamı Detay ve Arama sayfasındadır. Para hareketlerinde kaynak hesap olarak defaultWallet.accounts[].id değerini (walletAccountId) kullanırsınız. Varsayılan cüzdanın adı her zaman Cüzdanım'dır.

Hatalar