Kullanıcı KYC Token'ını Sil
Kullanıcının cüzdanlarından birinde tutulan KYC token'ını geri çeker. KYC (cüzdan, ağ, KYC token) bazında tutulur; birden fazla cüzdanı olan bir kullanıcının geri çekilecek tek bir "KYC"si yoktur: wallet_id cüzdanı, setup_id ise KYC token'ı geri çekilecek setup'ı belirtir (bir ağda birden fazla KYC token olabilir; geri alınan, setup'ın kendi KYC token'ıdır).
Çağrı asenkrondur. 200, geri çekmenin kuyruğa alındığı anlamına gelir. İşlem, platform kök düğümünde 31 (RecallKycToken) tipinde bir düğüm işlemi olarak çalışır; Düğüm İşlemlerini Listele ile takip edin. Sonuçlandığında o token'ın KYC kaydı yalnızca bu cüzdandan kaldırılır; kullanıcının diğer cüzdanları kendi kayıtlarını korur. Deploy edilmiş bir KYC token'a çözümlenmeyen bir setup_id burada reddedilmez: hiçbir şey geri çekilmez.
Gerekli izin: user:update
İstek
DELETE /v2/users/{user_id}/kyc-token?setup_id={setup_id}&wallet_id={wallet_id}
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
user_id | string | path | Zorunlu. Kullanıcı ID'si |
setup_id | string | query | Zorunlu. KYC token'ı geri çekilecek setup |
wallet_id | string | query | Zorunlu. KYC token'ın alınacağı kullanıcı cüzdanı. Bu kullanıcıya ait olmalı ve en az bir KYC token tutmalı |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Örnek
curl --request DELETE \
--url '{{baseUrl}}/v2/users/6a87455ad5f439809d488ac3/kyc-token?setup_id=6a80f1c2d5f439809d488a10&wallet_id=6a8754e187be1d0e22aa6d83' \
--header 'Authorization: Bearer <access_token>'
Yanıt
Durum Kodu: 200 OK, boş gövde.
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Doğrulama hatası (setup_id ya da wallet_id eksik) — details alanına bakın |
| 400 | 10016 | wallet_id geçerli bir ID değil |
| 400 | 10001 | Domain 1: cüzdan yok ya da bu kullanıcıya ait değil (user not found) veya hiç KYC token tutmuyor (wallet has no kyc token to recall) |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.