API'niz yazar.
Paneliniz okur.
Uygulamanızın her kullanıcısı için bir emanet kullanıcısı oluşturun. Kalıcı yatırma adresleri alır, her yatırma bakiyesine eklenir ve hepsini panelden takip edersiniz.
Uygulamanızın her kullanıcısı için bir emanet kullanıcısı
Uygulamanız emanet kullanıcılarını kendi kullanıcı kimliğiyle (external_id) oluşturur ve dönen id'yi saklar. Her emanet kullanıcısının kalıcı yatırma adresleri ve ağ geçidinizde her coin için ayrı bir bakiyesi vardır. Panel onları listeler ancak oluşturamaz: bu API ile yapılır.
1. Kullanıcıyı oluşturun
Kullanıcı kimliğinizi ve isteğe bağlı olarak ad, e-posta ve metadata gönderin. Aynı external_id ile tekrar çağırmak aynı kullanıcıyı döndürür; tekrarlamak güvenlidir.
curl https://coino.live/api/v2/custody/users \
-H "Authorization: Bearer ck_live_..." \
-H "Content-Type: application/json" \
-d '{"external_id": "customer_1001", "name": "Sara", "email": "[email protected]"}'2. Kullanıcıya yatırma adreslerini gösterin
Yanıt, kullanıcının adreslerini, her adresin kabul ettiği coin ve ağları ve bakiyelerini listeler. Adresler hiç değişmez; uygulamanız onları kalıcı olarak, örneğin bir "Yatırma" sayfasında gösterebilir.
{"data": {
"id": "01m6…", "external_id": "customer_1001", "status": "active",
"addresses": [{"address": "TQ5x…", "networks": ["tron"], "assets": ["usdt-tron", "trx-tron"]}, …],
"balances": [{"asset": "usdt-tron", "balance": "125.5"}]
}}3. Yatırmalar otomatik olarak hesaba geçer
Bir kullanıcı adreslerinden birine coin gönderdiğinde custody.deposit.detected webhook'unu, onaylanıp bakiyesine eklendiğinde ise custody.deposit.credited webhook'unu göndeririz. Hesaba geçen yatırmaları istediğiniz zaman en yeniden başlayarak da listeleyebilirsiniz.
Kendi uygulamanızda kullanıcıyı custody.deposit.credited ile alacaklandırın ve aynı yatırmayı iki kez işlememek için yatırma id'sini kullanın.
4. Bakiyeleri ana bakiyenize aktarın
Bir emanet kullanıcısının bakiyesi, ağ geçidinizde o kullanıcıya aittir. Bunu API ile (tamamını veya bir tutarı), paneldeki kullanıcı sayfasındaki düğmeyle ya da ağ geçidi ayarıyla her yatırmada otomatik olarak ana bakiyenize aktarın. Para çekmeler ana bakiyenizden ödenir.
Durum yönetimi
| Panel durumu | Anlamı | Kullanılabilir bakiye |
|---|---|---|
| Onaylanıyor | Yatırma blokzincirde görüldü ve onay bekliyor. | Değişmedi |
| Hesaba geçti | Yatırma onaylandı ve (ücretler düşülerek) kullanıcının bakiyesine eklendi. | Hesaba geçen tutar kadar artar |
| İncelemede bekletiliyor | Ekibimiz yatırmayı hesaba geçirmeden önce kontrol eder. | Değişmedi |
Bir webhook iki kez iletilse bile bir yatırma tam olarak bir kez hesaba geçer.
Saklama (Custody) hizmetini keşfedin