Get User Transaction
Bir kullanıcının işlemlerinden birini okur — kullanıcı yüzeyindeki her yazmanın döndürdüğü transaction_id'nin sorgulanacağı yer.
İstek
GET /v2/users/{user_id}/transactions/{transaction_id}
Parametreler
| İsim | Tip | Konum | Açıklama |
|---|---|---|---|
user_id | string | path | Gerekli. İşlemin ait olduğu kullanıcı (24 karakterlik hex) |
transaction_id | string | path | Gerekli. İşlem ID'si (24 karakterlik hex) |
Başlıklar
| İsim | Tip | Açıklama |
|---|---|---|
Authorization | Gerekli. Kimlik doğrulama için Bearer token |
Örnek
curl --location '\{\{baseUrl\}\}/v2/users/680c02896d91ca0145cfeb81/transactions/6a8b5e13f9129816a6cc7a12' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
Yanıt
{
"id": "6a8b5e13f9129816a6cc7a12",
"user_id": "680c02896d91ca0145cfeb81",
"type": 5,
"status": 3,
"environment": 2,
"internal_id": "68ae06cfcccf4e8fc19362d1",
"wallet_id": "6a89b68e0c46ca4c941271aa",
"external_id": "",
"hash": "0x9f2c1b...",
"error": null,
"message": null,
"is_api": true,
"created_at": "2026-08-23T17:43:31.004Z",
"updated_at": "2026-08-23T17:44:01.220Z"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
id | string | İşlem ID'si |
user_id | string | İşlemin ait olduğu kullanıcı |
type | integer | İşlemin ne yaptığı — tip tablosu için Get User Transactions |
status | integer | 1 Started, 2 InProgress, 3 Done, 4 Error, 5 PendingReceipt |
environment | integer | İşlemin ait olduğu ortam |
internal_id | string | İşlemin üzerinde çalıştığı kayıt — ikincil piyasa ilanı, OTC teklifi, token |
wallet_id | string | İşlemin üzerinde çalıştığı ve imzaladığı custody cüzdanı. Cüzdan adlandırmayan işlemlerde boştur |
hash | string | Zincir üstü işlem hash'i; Done olunca dolar, öncesinde null |
error | string | Hata sebebi; Error olunca dolar, aksi hâlde null |
message | string | Verilmişse okunabilir açıklama |
is_api | boolean | Aksiyonun admin panelinden değil integration API'sinden gelip gelmediği |
Status enum
| Değer | İsim | Anlamı |
|---|---|---|
| 1 | Started | Kaydedildi, henüz alınmadı |
| 2 | InProgress | Zincire gönderildi |
| 3 | Done | Sonuçlandı; hash doludur |
| 4 | Error | Başarısız; error doludur |
| 5 | PendingReceipt | Gönderildi, zincir makbuzu bekleniyor |
Durum Kodları
| Durum Kodu | Açıklama |
|---|---|
| 200 | Başarılı - işlem alındı |
| 400 | Hatalı İstek - işlem bulunamadı ya da işlem ID'si ait olmadığı bir kullanıcı ile eşleştirildi |
| 401 | Yetkisiz - geçersiz veya eksik kimlik doğrulama token'ı |
| 500 | Sunucu Hatası |
Notlar
- Bu uç şu çağrıların döndürdüğü
transaction_idiçin sorgulama hedefidir: Sell On Secondary Market, Delist, Sell On OTC, Cancel OTC Deal, Buy On Primary Market, Buy On Secondary Market, Burn ve Withdraw. - Bu uç yokken o ID'leri çözmenin tek yolu Get User Transactions listesini sayfalayıp aramaktı.
- Kullanıcı anahtarın parçasıdır: başka bir kullanıcıyla eşleştirilen işlem ID'si "yok" cevabı alır, reddedilmez.