Yatırım

Müşteri sitenizde yatırım yapmak istediğinde sunucunuz bir yatırım talebi oluşturur, müşteri ödeme sayfasına yönlendirilir.

POSThttps://api.tlhavale.com/api/payment/deposit/with-partner

İstek

{
  "auth": { "apiKey": "tlh_pk_…", "secKey": "tlh_sk_…" },
  "customer": {
    "fullName": "Ayşe Demir",
    "username": "aysed",
    "id": "48213"
  },
  "amount": 1500,
  "transactionId": "dep-2026-000184",
  "returnUrl": "https://siteniz.com/hesabim"
}

Alan	Tür	Zorunlu	Açıklama
auth	nesne	evet	Bkz. Kimlik doğrulama
customer.fullName	metin	evet	Müşterinin adı soyadı. Havaleyi gönderecek kişiyle aynı olmalıdır; ekibimiz eşleştirmeyi bu adla yapar.
customer.username	metin	evet	Sitenizdeki kullanıcı adı
customer.id	metin	evet	Sitenizdeki kullanıcı numarası
amount	tam sayı	evet	Tutar (TL). Kuruş gönderilmez; ondalıklı değer tam sayıya çevrilir.
transactionId	metin	evet	Sizin tarafınızdaki işlem numarası. Her talep için tekil olmalıdır.
returnUrl	metin	hayır	Müşterinin işlem sonunda döneceği adres. Sitenizin alan adında (veya alt alan adında) olmalıdır; değilse müşteri sitenizin ana sayfasına döner.

Tabloda olmayan alanlar yok sayılır.

Yanıt

{
  "status": true,
  "token": "eyJhbGciOi…",
  "deposit": {
    "_id": "6ad9f4b2c1…",
    "transactionId": "dep-2026-000184",
    "amount": 1500,
    "status": "PROCESSING",
    "created_at": "2026-10-22T09:41:07.512Z"
  }
}

deposit nesnesinde başka alanlar da bulunabilir; entegrasyonunuz yalnızca yukarıdakilere güvenmelidir. Hata durumunda status: false ve Türkçe bir message döner (bkz. Hatalar).

Müşteriyi yönlendirme

https://pay.tlhavale.com/deposit?token=<token>

• Token 30 dakika geçerlidir ve yalnızca bu yatırıma aittir.
• Müşteriye ödeme sayfasında bir IBAN atanır; sayfayı yenilese de aynı IBAN'ı görür.
• Müşteri 10 dakika içinde "Ödemeyi yaptım" demezse talep TIMEOUT_REJECTED olur ve size bildirim gider.
• "Ödemeyi yaptım" denmiş talep ekibimiz onaylayana ya da reddedene kadar PENDING kalır; bu aşamada süre sınırı yoktur.

Kurallar

Talep şu durumlarda oluşturulmaz:

• Sistem bakımda ya da yatırımlar geçici olarak kapalı.
• Tutar sitenize tanımlı alt/üst sınırın dışında.
• Aynı transactionId ile daha önce talep oluşturulmuş (durumu ne olursa olsun).
• Müşterinin sitenizde zaten açık bir yatırım talebi var.
• Müşteri kısıtlı listede.
• O an tutarı karşılayabilecek uygun hesap yok.

Bu durumların her birinde yanıtta neden açıkça yazar; müşteriye gösterilebilecek bir dildedir.

Tutar değişebilir

Müşteri talepten farklı bir tutar gönderirse ekibimiz onaydan önce tutarı gönderilen tutara göre düzeltebilir. Bakiyeye her zaman bildirimdeki amount değerini ekleyin, talepte gönderdiğiniz tutarı değil.