Çekim

Müşteri sitenizden para çekmek istediğinde sunucunuz bir çekim talebi iletir. Ödeme yapıldığında ya da talep reddedildiğinde bildirim alırsınız.

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

İstek

{
  "auth": { "apiKey": "tlh_pk_…", "secKey": "tlh_sk_…" },
  "customer": {
    "fullName": "Ayşe Demir",
    "username": "aysed",
    "id": "48213"
  },
  "amount": 2500,
  "transactionId": "wd-2026-000091",
  "iban": "TR330006100519786457841326"
}

Alan	Tür	Zorunlu	Açıklama
auth	nesne	evet	Bkz. Kimlik doğrulama
customer.fullName	metin	evet	Alıcının adı soyadı. IBAN sahibiyle aynı olmalıdır.
customer.username	metin	evet	Sitenizdeki kullanıcı adı
customer.id	metin	evet	Sitenizdeki kullanıcı numarası
amount	tam sayı	evet	Tutar (TL)
transactionId	metin	evet	Sizin tarafınızdaki işlem numarası, tekil
iban	metin	evet	Alıcı IBAN'ı (TR ile başlar). Banka IBAN'dan otomatik bulunur.

Yanıt

{
  "status": true,
  "withdraw": {
    "_id": "6ad9f7e1a0…",
    "transactionId": "wd-2026-000091",
    "amount": 2500,
    "status": "PENDING",
    "created_at": "2026-10-22T10:02:44.091Z"
  }
}

Talep PENDING olarak sıraya alınır. Ödeme yapılınca CONFIRMED, yapılamazsa REJECTED bildirimi gelir.

Bakiyeyi ne zaman düşmelisiniz

Müşterinin bakiyesini talebi oluşturduğunuz anda düşüp (bloke edip) REJECTED veya sizin geri çekmeniz durumunda iade etmenizi öneririz. Böylece müşteri aynı parayı iki kez çekmeye çalışamaz.

Kurallar

Talep şu durumlarda oluşturulmaz:

• Sistem bakımda ya da çekimler geçici olarak kapalı.
• Tutar sitenize tanımlı alt/üst sınırın dışında.
• Aynı transactionId ile daha önce talep oluşturulmuş.
• Müşterinin sitenizde zaten açık bir çekim talebi var.
• IBAN'dan banka bulunamıyor ya da o banka şu an çekime kapalı.