Kullanıcı Cüzdanından Para Çekme

Kullanıcının saklama (custodial) cüzdanından harici bir adrese para çekme. Bu endpoint yalnızca saklama harici olarak yönetildiğinde (sistem tarafından değil) kullanılabilir.

Endpoint

POST /v2/users/users/{user_id}/withdraw

Başlıklar

Header	Değer
Content-Type	application/json
Authorization	Bearer {token}

Path Parametreleri

Parametre	Tip	Gerekli	Açıklama
user_id	string	Evet	Kullanıcının benzersiz tanımlayıcısı

İstek Gövdesi

{
    "address": "0x...",
    "amount": 100.5,
    "currency_token_id": "6913307ec95e268b239b2d8b"
}

Parametreler

Parametre	Tip	Gerekli	Açıklama
address	string	Evet	Para çekme için hedef cüzdan adresi
amount	number	Evet	Çekilecek miktar
currency_token_id	string	Hayır	Token çekimleri için para birimi token ID'si. Native token çekiminde atlayın

Örnek

İstek

curl --location 'https://test-integration-api.tokenizationtr.com/v2/users/users/6913872755654191dede37da/withdraw' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data '{
    "address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
    "amount": 10.5
}'

Yanıt

Asenkron işlem için transaction ID döner. Para çekme işlemi asenkron işlenir; durum sorgulamak için Kullanıcı İşlemlerini Getir endpoint'ini kullanın.

{
    "transaction_id": "6913872755654191dede37da"
}

Yanıt Alanları

Alan	Tip	Açıklama
transaction_id	string	Durum sorgulama için transaction ID - para çekme durumunu kontrol etmek için kullanın

Hata Yanıtları

400 Hatalı İstek

{
    "error": "Geçersiz parametreler",
    "details": "Adres ve miktar gerekli"
}

401 Yetkisiz

{
    "error": "Kimlik doğrulama gerekli"
}

403 Yasaklı

{
    "error": "Erişim reddedildi"
}

404 Bulunamadı

{
    "error": "Kullanıcı bulunamadı"
}

409 Çakışma

Saklama sistem tarafından yönetildiğinde döner (para çekme mevcut değil):

{
    "error": "para çekme yalnızca saklama harici yönetildiğinde kullanılabilir"
}

500 İç Sunucu Hatası

{
    "error": "İç sunucu hatası"
}

Önemli Notlar

• Saklama Gereksinimi: Para çekme yalnızca saklama harici yönetildiğinde kullanılabilir. Sistem saklamayı yönettiğinde API 409 Conflict döner.
• Asenkron İşleme: Para çekme asenkron işlenir; durum güncellemeleri için Kullanıcı İşlemlerini Getir endpoint'ini transaction_id ile sorgulayın.
• Native vs Token: Native token çekimlerinde currency_token_id atlayın. ERC-20 veya diğer para birimi token çekimleri için currency_token_id belirtin.
• Kullanıcı Cüzdanı: Para çekmeden önce kullanıcının cüzdan adresi ayarlanmış olmalıdır.