Genel bakış
Merchant API, sunucunuzun kripto yatırma ve çekim açmasını sağlar. Müşteriniz barındırılan ödeme sayfamızda öder; her değişikliği imzalı webhook’larla öğrenirsiniz ve güncel durumu her zaman API’den yeniden okuyabilirsiniz. Her durum, olay ve bekleme Yaşam döngüsü sekmesinde adım adım çizilidir.
Taban adres
| Ortam | Taban adres | API anahtarı |
|---|---|---|
| Canlı | https://api.cryptogon.dev | live_… |
| Sandbox (test ağları, gerçek para yok) | https://api-sandbox.cryptogon.dev | test_… |
Ağlar ve varlıklar
| Ağ | Canlı kodu | Varlıklar | Sandbox kodu | Sandbox varlıkları |
|---|---|---|---|---|
| TRON | tron | USDT, TRX | tron_nile | USDT, TRX |
| BNB Smart Chain | bsc | USDT, USDC, BNB | bsc_testnet | BNB |
| Ethereum | ethereum | USDT, USDC, ETH | ethereum_sepolia | USDC, ETH |
Hangi varlıkların açık olduğu ortama ve sözleşmenize bağlıdır. GET /v1/assets güncel listeyi ağ kodları, ondalık basamaklar ve kontrat adresleriyle döner: menülerinizi sabit yazmak yerine buradan kurun.
Yatırma akışı (önerilen: ödeme oturumu)
- Sunucunuz
POST /v1/deposit-sessionsile bir ödeme oturumu açar: tutar, para birimi (TRY,EUR,USDT…) ve kendi sipariş referansınız. - Müşteriyi dönen
checkout_url’e yönlendirin. Coini ve ağı orada seçer; sayfa tam tutarı, adresi ve QR kodu gösterir. - Müşteri ödemeyi gönderir. Zinciri izleriz ve transfer kesinleşene kadar bekleriz.
- Önce
payment.detected, sonrapayment.confirmedwebhook’u gelir. Her birine2xxile yanıt verin. - Ödemenin
order_value.valuetutarını müşterinizin hesabına geçirin (kurallar Webhook’lar sekmesinde). Sunucunuzpayment.confirmedolayına2xxdöndükten sonra Cryptogon bakiyeniz komisyon düşülmüş net tutar kadar artar.
Coini ve ağı kendiniz seçmek istiyorsanız POST /v1/deposits kullanın: aynı biçimde, sabit bir varlıkla çalışır ve deposit.* olayları gönderir.
Çekim akışı
- İsteğe bağlı:
POST /v1/withdrawals/quoteağ ücretini ve müşteriye gidecek en az tutarı gösterir. - Hedef adres ve tutarla
POST /v1/withdrawals. Yanıt201vestatus: processing’dir. Bakiyeniz yetmiyorsa çekim en çok 12 dakika (varsayılan) bakiye bekler; yineprocessinggörünür. - Onay: otomatik onay sınırınızın içindeyse ve bekletme yoksa kendiliğinden onaylanır. Değilse
pending_approvalolur (withdrawal.pending_approval) ve sizi ya da Cryptogon’u bekler. Bkz. Onay. - İmzalar ve ağa göndeririz:
tx_hashilewithdrawal.sent. - Zincirde kesinleşince
withdrawal.completed. Reddedilir, iptal edilir ya da başarısız olursawithdrawal.rejected,withdrawal.cancelledya dawithdrawal.failedgelir ve kilitli tutar bakiyenize döner.
Cryptogon bakiyeniz
- Yatırma: kesinleşen yatırma önce bekleyen olarak yazılır. Net tutarı (brüt eksi
commission.amount), webhook adresiniz kesinleşme olayına (deposit.confirmedya dapayment.confirmed)2xxdöndükten sonra kullanılabilir bakiyenize geçer; dakikada bir bakarız. Ne zaman geçtiğinicommission.credited_atgösterir. Webhook adresi yoksa geçiş bekler. - Çekim: tutar, çekim ücretimiz ve ağ ücreti için bir üst sınır çekim kabul edilince kilitlenir (TRON’da tutar ve çekim ücreti). Gerçek ağ ücreti gönderimden sonra alınır, kalanı serbest kalır. Reddedilen, iptal edilen ya da başarısız olan çekimin kilidi çözülür.
- Kasa yüklemesi (
site.funded) ve Cryptogon’un verdiği kredi (credit.approved) kullanılabilir bakiyeyi doğrudan, komisyonsuz artırır. - Henüz bakiye uç noktası yok; bakiyeyi merchant paneli gösterir.
Durumlar
| Ödeme oturumu | Anlamı |
|---|---|
awaiting_selection | Müşteri henüz coin ve ağ seçmedi |
awaiting_payment | Seçti; ödeme bekleniyor |
detected | Bir ödeme zincirde görüldü, kesinleşmedi |
confirmed | Ödeme kesinleşti; hesaba geçirin (kurallar Webhook’lar sekmesinde) |
expired | Süre doldu, ödeme gelmedi |
| Yatırma talebi | Anlamı |
|---|---|
pending | Ödeme bekleniyor |
detected | Transfer zincirde görüldü, kesinleşmedi |
confirmed | Kesinleşti; transfer.variance exact, under ya da over der |
expired | Süre doldu, ödeme gelmedi |
| Çekim | Anlamı |
|---|---|
processing | Kabul edildi, yolda: bakiye beklerken, onaydan sonra ve imzalanırken de |
pending_approval | Karar bekliyor: sizin (otomatik onay sınırınızın üstü ya da kurallarınızdan biri) ya da Cryptogon’un (kur yok, stablecoin sapmış, site etkin değil, kara listedeki adres ya da sitenizde onaylayıcı yok) |
sent | Ağa gönderildi; tx_hash dolu (bölünmüş çekimde parts’ta) |
completed | Zincirde kesinleşti |
partially_completed | Alıcı adresi çekim sürerken dolandırıcılık ya da yaptırım nedeniyle engellenen bölünmüş çekim: paid_amount ödendi, kalanı bakiyenize döndü. Son durum. Bölünmüş çekimin tam tutarla bitmediği tek durum |
rejected | Gönderilmeden reddedildi; kilit çözüldü (bakiye beklerken reddedilen çekimde nedeni rejection_reason söyler) |
cancelled | İmzadan önce sizin tarafınızdan iptal edildi |
failed | Gönderilemedi ya da zincirde başarısız oldu; kilit çözüldü (zincirde harcanmış ağ ücreti alınır) |
Temel kurallar
- Tutarlar ondalık metindir:
"100.5"; JSON sayısı (100.5) asla. - Para hareketi yaratan her istek
Idempotency-Keytaşır; aynı anahtar ve gövdeyle yeniden denemek her zaman güvenlidir. merchant_referencesizin işlem kimliğinizdir: 1–100 karakter, harf, rakam ve_ . : -; site başına tekil.player_idmüşteri için sizin kimliğinizdir: aynı karakterlerle 1–64 karakter.- İstek gövdeleri JSON nesnesidir. Bilinmeyen alan
400 INVALID_REQUESTile reddedilir; yazım hatası sessizce geçmez. - Webhook’lar birden fazla ve sırasız gelebilir. Her olayı
id’siyle bir kez işleyin ve olay türüne değildata.status’a güvenin. - v1 alan, durum ve olay türü ekleyebilir ama var olanların anlamını değiştirmez: tanımadığınızı yok sayın (tanımadığınız durum son durum değildir). Tarihli değişiklikler Değişiklik günlüğü sekmesinde.
Henüz yok
GET /v1/balances, POST /v1/settlements ve OpenAPI şeması sonraki sürümlerde gelir. Kredi talebi ve kasa yükleme adresleri bu API’de değil, merchant panelindedir.
Yaşam döngüsü
Her şema sunucunuzun her adımda ne gördüğünü gösterir: API’nin döndüğü status, gönderdiğimiz webhook (ya da hiçbiri) ve sizin yapacağınız. İç adımlar (bakiye bekleme, imza) ayrıca gösterilmez: API processing demeye devam eder. Her şemanın altında aynı içerikte bir tablo vardır.
- Bekleyin
- Hesaba geçirin
- Geri verin
- Yapılacak yok
- Tamam
Dar ekranda şemayı kendi çerçevesi içinde yana kaydırın. “Geri verin”: tutarı kendi sisteminizde müşterinize iade edin.
Yatırma
Kutular ödeme oturumunu (POST /v1/deposit-sessions) gösterir. Tablo her adımın yatırma talebi (POST /v1/deposits) karşılığını da verir; talepte seçim adımı ve ek ödeme yoktur.
| Adım | status | Webhook | Yatırma talebi | Ne zaman | Ne yaparsınız |
|---|---|---|---|---|---|
| Oturum açıldı | awaiting_selection | olay yok | pending · olay yok | Oturum var; müşteri henüz coin ve ağ seçmedi. Yatırma talebi (POST /v1/deposits) doğrudan ödeme beklemeyle başlar (pending). | Bekleyin Müşteriyi checkout_url’e gönderin. |
| Coin ve ağ seçildi | awaiting_payment | olay yok | yok | Ödeme sayfası tutarı, adresi ve QR kodu gösterir; kur 15 dakika kilitlenir. Müşteri en çok 8 kez değiştirebilir. | Bekleyin Bekleyin. |
| Zincirde görüldü | detected | payment.detected | detected · deposit.detected | Transfer zincirde ama henüz kesin değil. | Bekleyin Müşteriye beklemede gösterin; henüz hesaba geçirmeyin. |
| Kesinleşti | confirmed | payment.confirmed | confirmed · deposit.confirmed | Transfer kesin. Olaya 2xx döndükten sonra net tutar bakiyenize geçer. | Hesaba geçirin order_value.value’yu ödeme id’si başına bir kez hesaba geçirin (talepte: transfer.amount, talep id’si başına bir kez). |
| Süresi doldu | expired | payment.expired | expired · deposit.expired | Transfer görülmeden süre doldu: seçim süresi ve seçilen her adres (talepte: expires_at). | Yapılacak yok Hesaba geçirilecek bir şey yok. |
| Kesinleşmeden düştü | awaiting_payment | payment.dropped | pending · deposit.dropped | Görülen transfer zincirden düştü. Oturum ya da talep yeni bir transfer için açık kalır. | Bekleyin Hesaba geçirmeyin. |
| Ek ya da geç ödeme | confirmed | payment.extra | yok | İkinci bir ödeme ya da bu oturuma bağlanan geç ödeme; bekletilir. Oturumun durumu değişmez. | Yapılacak yok credit_status held iken hesaba geçirmeyin. |
| İncelenip serbest bırakıldı | confirmed | payment.released | yok | Cryptogon bekletilen ödemeyi inceleyip serbest bıraktı (credit_status: pending). | Hesaba geçirin Ödeme id’si başına bir kez hesaba geçirin; oturumun süresi dolmuş ya da daha önce geçirilmiş olsa da. |
- Müşteri ve varlık başına tek açık talep. Aynı varlıkta başka bir talep ya da bir oturumun seçilmiş adresi açıkken yeni yatırma talebi
409 OPEN_DEPOSIT_EXISTSalır. İstisna: ödeme süresi (pay_until) geçmiş ve transferi görülmemiş yatırma talebiexpiredkapanır (deposit.expired) ve yenisi açılır. Oturumda, müşterinin açık talebi olan varlık o talep kapanana kadar seçilemez. - Süre. Yatırma talebi 300–1800 saniye yaşar (
expires_in; varsayılan native coin’de 900, stablecoin’de 1800). Oturum müşteriye seçim için 300–1800 saniye verir (varsayılan 1800); sonra seçilen her adresin kendi ödeme süresi vardır (fiat oturumda 15 dakika). Süre dolduğunda görülmüş bir transfer varsa talep, transfer kesinleşene ya da düşene kadar açık kalır. - Eksik ve fazla ödeme. Tolerans yoktur: geleni hesaba geçirin. Oturumda
order_value.valuegelen tutarın oturum para birimindeki karşılığıdır, aşağı yuvarlanır; yatırma talebindetransfer.amountgelen tutardır vetransfer.varianceexact,underya daoverder. - Geç ödeme. Seçimin süresi dolduktan sonra, yanlış coinle ya da kardeş EVM ağından gelen ödeme, müşterinin o zincirde adres göstermiş, açık ya da son 24 saatte kapanmış tek oturumuna bağlanır. Bekletilmiş olarak (
late_payment)payment.extraile gelir ve kesinleştiği andaki kurla değerlenir (confirm_rate). Tam olarak bir oturuma bağlanamazsa talepsiz ödeme gibi işlenir. - Talepsiz ödeme. Müşterinin kalıcı adresine, açık yatırma talebi ve bağlanabileceği bir oturum yokken gelen transfer (zaten transferi olan bir talebe gelen ikinci transfer de) kaydedilir ama olay göndermez ve kullanılabilir bakiyenize geçmez. Ekibimiz inceler. Varlığın en küçük yatırma tutarının altındaki transfer oturuma bağlanmaz. v1’de böyle ödemeler kendiliğinden hesaba geçirilmez.
- Durdurmalar. Cryptogon adres göstermeyi durdurursa yeni yatırma talebi, oturum ve müşteri adresi
503 SERVICE_PAUSEDalır veaddressnullolur; gösterilmiş adreslere gelen ödemeler yine algılanır ve kesinleşir. Cryptogon bakiyeye geçişi durdurursa ya da stablecoin sabitinden saparsa olaylar yine gönderilir ama bakiyenize geçiş durdurma bitene kadar bekler. Sabitinden sapan stablecoin’de yeni yatırma talebi de reddedilir (503 ASSET_PAUSED).
Çekim
| Adım | status | Webhook | Ne zaman | Ne yaparsınız |
|---|---|---|---|---|
| Bakiye bekleniyor | processing | olay yok | Kullanılabilir bakiyeniz tutarı ve ücretleri karşılamıyor ya da aynı varlıkta daha önceki bir çekim hâlâ bekliyor. Hiçbir şey kilitlenmez; fees null. | Bekleyin Ödenmesini istiyorsanız bakiye yükleyin; iptal edebilirsiniz. |
| Kabul edildi, bakiye kilitlendi | processing | olay yok | Tutar ve ücretler kilitlenir; sizin sınırlarınız ve Cryptogon’un denetimleri çalışır. | Bekleyin Sonraki olayı bekleyin. |
| Onay bekleniyor | pending_approval | withdrawal.pending_approval | Sizin sınırlarınız ya da Cryptogon’un denetimleri bekletti. Onaydan sonra gönderilene kadar durum yine processing olur. | Bekleyin Sizi bekliyorsa merchant panelinde karar verin. |
| Ağa gönderildi | sent | withdrawal.sent | tx_hash dolu. Artık iptal edilemez. | Bekleyin Sonucu bekleyin. |
| Tamamlandı | completed | withdrawal.completed | Zincirde kesinleşti. | Tamam Ödemeyi ödendi olarak işaretleyin. |
| Bakiye beklemesi bitti | rejected | withdrawal.rejected | Süre yeterli bakiye olmadan doldu ya da beklerken bir kişi reddetti. Nedeni rejection_reason söyler. | Geri verin Tutarı müşterinize geri verin. Hiçbir şey kilitlenmemişti. |
| İptal ettiniz | cancelled | withdrawal.cancelled | İmza başlamadan iptal edildi (bakiye ya da onay beklerken de). | Geri verin Tutarı müşterinize geri verin. |
| Reddedildi | rejected | withdrawal.rejected | Kurallarınızdan biriyle, sizce, 72 saat kararsızlıktan sonra ya da gönderilmeden önce Cryptogon’ca. | Geri verin Tutarı müşterinize geri verin. Kilit çözülür. |
| Başarısız | failed | withdrawal.failed | Gönderilemedi ya da zincirde başarısız oldu. Kilit çözülür; harcanmış ağ ücreti alınır. | Geri verin Tutarı müşterinize geri verin. |
- İptal.
POST /v1/withdrawals/{id}/cancel, çekim bakiye beklerken, kabul edilmişken, onay beklerken ya da onaylanmış ama imzaya girmemişken çalışır. İmza başladıktan sonra ya da çekim kesinleşmişse yanıt409 INVALID_STATE’tir. - Onaydan sonra ret. İmzalanana kadar Cryptogon onaylanmış bir çekimi yine reddedebilir (ör. hedef adres onaydan sonra kara listeye girdi). Çekim
processing’denrejected’a geçer ve tutarın tamamı bakiyenize döner. - Çok büyük çekim. İşlem başı sınırın üstündeki çekimi Cryptogon onaylayıp birkaç zincir işlemiyle ödeyebilir (aşağıda "Bölünmüş çekim"). Siz yine tek çekim görürsünüz. Cryptogon tutarın tamamı için zincir likiditesini ayırmadan hiçbir parça gönderilmez; o zamana kadar çekim
processingkalır, büyük tutarda bu biraz sürebilir.withdrawal.sentilk parçada bir kez gelir, çekim tek bir son olayla biter;fees.network_feeparçaların toplamıdır. Cryptogon çekimi durdurursa kalan parçalar bekler, çekimprocessingkalır (bir parça gittiysesent) ve olay gönderilmez; gönderim sürünce çekim tam tutarda tamamlanır (withdrawal.completed). Bölünmüş çekim her zaman tam tutarla biter. Tek istisna: alıcı adres çekim sürerken dolandırıcılık ya da yaptırım nedeniyle engellenirse kalan gönderilmez:partially_completed(withdrawal.partially_completed), henüz hiçbir şey ödenmediysefailed, ve ödenmeyen kalan bakiyenize döner. Hiçbir parça imzalanmadan Cryptogon çekimi yine reddedebilir (failed). - Durdurmalar. Cryptogon gönderimi durdurursa çekimler yine kabul edilir ve onaylanır;
processing’de bekler ve gönderim açılınca sırayla gönderilir.
Onay
Kabul edilen her çekim önce sizin sınırlarınızdan, sonra Cryptogon’un denetimlerinden geçer. Cryptogon müşterilerinizi değerlendirmez ve 18 Ekim 2026’dan beri kendi tutar sınırını uygulamaz: hangi çekimin sizi bekleyeceğine otomatik onay sınırınız karar verir.
| Adım | status | Webhook | Ne zaman | Ne yaparsınız |
|---|---|---|---|---|
| Kabul edildi, denetlendi | processing | olay yok | Kabulden (ya da bakiye beklemesinden) hemen sonra önce sizin sınırlarınız, sonra Cryptogon’un denetimleri çalışır; çoğunlukla bir dakika içinde. | Bekleyin Sonraki olayı bekleyin. |
| Sizin kararınızı bekliyor | pending_approval | withdrawal.pending_approval | Otomatik onay sınırınıza eşit ya da üstünde (ya da USD karşılığı bilinmiyor), ya da bekletme kurallarınızdan biri tuttu. Sitenizde çekim onaylayabilecek kullanıcı yoksa bu adım atlanır: çekim Cryptogon’u bekler. | Bekleyin 72 saat içinde merchant panelinde onaylayın ya da reddedin. Cryptogon da sizin adınıza karar verebilir. |
| Cryptogon’un kararını bekliyor | pending_approval | withdrawal.pending_approval | Güncel kur yok, stablecoin sabitinden sapmış, site ya da hesap etkin değil, hedef kara listede ya da sitenizde onaylayıcı yokken sizin bekletmeniz. Sizin incelemenizden geliyorsa olay yeniden gönderilir. | Bekleyin Bekleyin; Cryptogon’da tek bir yetkili karar verir. |
| Onaylandı | processing | olay yok | Bekletme yok ya da onaylandı. Sırada gönderim var (withdrawal.sent). | Bekleyin withdrawal.sent’i bekleyin. |
| Kuralınızla reddedildi | rejected | withdrawal.rejected | Çekim başına en yüksek tutarınızın üstünde ya da reddetmeye ayarlı bir müşteri sınırı tuttu. | Geri verin Tutarı müşterinize geri verin (rejection_reason: null). |
| Reddedildi ya da süre doldu | rejected | withdrawal.rejected | Siz (ya da sizin adınıza Cryptogon) reddettiniz, 72 saatte kimse karar vermedi ya da Cryptogon kendi riski için reddetti. | Geri verin Tutarı müşterinize geri verin. |
| Cryptogon reddetti | rejected | withdrawal.rejected | Cryptogon beklettiği bir çekimi reddetti. | Geri verin Tutarı müşterinize geri verin. |
| Kural | Kim koyar | Sonuç |
|---|---|---|
| Otomatik onay sınırı: USD karşılığı sınıra eşit ya da üstünde, ya da karşılığı bilinmiyor | Siz, merchant panelinde (Limitler); orada en çok 5.000 USD, varsayılan 5.000 USD. Cryptogon daha yüksek bir sınır koyabilir ya da kapatabilir | Sizi bekler (pending_approval) |
| Çekim başına en yüksek tutar | Siz | Hemen reddedilir (withdrawal.rejected); USD karşılığı bilinmiyorsa sizi bekler |
| Müşteri başına günlük tutar, günlük sayı, saatlik sayı | Siz (varsayılan kapalı) | Seçiminize göre sizi bekler ya da reddedilir |
| İlk çekim, yeni adres, son N dakikada yatırma | Siz (varsayılan kapalı) | Sizi bekler |
| Sitenizde çekim onaylayabilecek kullanıcı yok | — | Bekletmeleriniz sizin yerinize Cryptogon’u bekler |
| Güncel kur yok, stablecoin sabitinden sapmış, site ya da hesap etkin değil, hedef Cryptogon’un kara listesinde | Cryptogon | Cryptogon’u bekler. Kara listedeki hedef onaylanamaz; etkin olmayan sitenin onaylı çekimi site yeniden etkinleşene kadar gönderilmez |
| 72 saat içinde kararınız yok | — | Reddedilir (withdrawal.rejected) |
| Hiçbiri | — | Kendiliğinden onaylanır |
- Kararı merchant panelinde (Çekimler) iki adımlı doğrulamayla verirsiniz; tek onay kesindir. Onayladığınızda Cryptogon’un denetimleri yeniden çalışır: çekim onaylanır ya da Cryptogon’a geçer ve
withdrawal.pending_approvaldaha yüksek birresource_versionile yeniden gönderilir. - Cryptogon sizi bekleyen bir çekimi sizin adınıza onaylayabilir ya da reddedebilir ve kendi riski için reddedebilir. Bakiye beklemesinden gelmeyen retlerde
rejection_reasonnull’dır. - Sınırınızı yükseltmek bekleyen çekimleri onaylamaz.
Bakiye bekleme
| Zaman | Adım | status | Webhook | Ne yaparsınız |
|---|---|---|---|---|
| 0 | İstek kabul edildi processing ve fees: null ile 201; olay yok. | processing | olay yok | Bekleyin Bekleyin. |
| her dakika | Bakiye denetimleri Varlık başına istek sırasıyla; sonraki istek öncekinin önüne hiçbir zaman geçmez. | processing | olay yok | Bekleyin Ödenmesini istiyorsanız bakiye yükleyin. |
| bakiyeniz yettiğinde | Bakiye geldi Tutar kilitlenir, ücretler sabitlenir; kabul edilmiş her çekim gibi sürer. | processing | olay yok | Bekleyin Sonraki olayı bekleyin. |
| beklerken her an | İptal ettiniz POST /v1/withdrawals/{id}/cancel. | cancelled | withdrawal.cancelled | Geri verin Tutarı müşterinize geri verin. |
| beklerken | Bir kişi reddetti rejection_reason: declined (Cryptogon ya da panelinizden bir kullanıcı; en az tutarı artık karşılamayan TRON çekimi de). | rejected | withdrawal.rejected | Geri verin Tutarı müşterinize geri verin. |
| 12 dakikadan sonra, çoğunlukla bir dakika içinde | Süre doldu rejection_reason: insufficient_funds, rate_unavailable, service_unavailable ya da internal_error. Sonradan hiçbir koşulda ödenmez. | rejected | withdrawal.rejected | Geri verin Tutarı müşterinize geri verin. |
- Kullanılabilir bakiyeniz tutarı ve ücretleri karşılamıyorsa ya da aynı varlıkta daha önceki bir çekim hâlâ bekliyorsa çekim bekler (istekler sırayla karşılanır). Beklerken hiçbir şey kilitlenmez ve
feesnull’dır. - Süre varsayılan 12 dakikadır; Cryptogon site başına ayarlar (0 beklemeyi kapatır; o zaman bakiyesi yetmeyen çekim hemen
422 INSUFFICIENT_NETWORK_BALANCEalır). - Süre dolduktan sonra
rejection_reason:insufficient_funds(son denetim bakiyeyi yetersiz gördü ve hâlâ yetersiz),rate_unavailable(çekim ücreti için güncel kur yok),service_unavailable(siteniz ya da varlık etkin değildi ya da bekleme zamanında işlenemedi; ör. süre dolduğunda bakiyeniz yetiyordu) ya dainternal_error. Böyle reddedilen çekim hiçbir koşulda ödenmez. rejection_reason: declined: beklerken bir kişi reddetti (Cryptogon ya da merchant panelinizden bir kullanıcı) ya da bakiye geldiğinde TRON çekimi en az tutar kuralını artık karşılamıyordu.
Kimlik doğrulama
API anahtarları
Anahtarları merchant panelinde API ve webhook sayfasında açın (iki adımlı doğrulama). Bir sitenin en çok 10 açık anahtarı olabilir. Her anahtar iki parçadır:
- Anahtar kimliği (
live_ya datest_ve ardından 30 harf ve rakam, 35 karakter): her istekte açık gider. Canlı ortam yalnızcalive_, sandbox yalnızcatest_anahtarlarını kabul eder. - Gizli anahtar (43 karakter): hiç gönderilmez, yalnızca imzada kullanılır. Bir kez gösterilir; bizde şifreli durur ve biz de yeniden gösteremeyiz. Sızarsa anahtarı hemen kapatıp yenisini açın.
| Yetki | İzin verdiği |
|---|---|
read | Yatırma talebi, ödeme oturumu, çekim ve para birimlerini okuma; çekim teklifi |
deposit | Yatırma talebi ve ödeme oturumu açma, müşteri adresleri; yatırma talebi, oturum ve para birimlerini okuma |
withdraw | Çekim açma, iptal etme ve okuma; çekim teklifi |
settlement | Hesaplaşma için ayrıldı (henüz yok) |
| her yetki | GET /v1/assets ve GET /v1/rates |
İzinli sunucu adresleri
Bir anahtarı sunucu adresi listesiyle sınırlayabilirsiniz; başka adresten gelen istek 403 IP_NOT_ALLOWED alır. Liste isteğe bağlıdır: yoksa anahtar her yerden çalışır. withdraw yetkili her anahtar için liste tanımlamanızı önemle öneririz.
- Öğeler tek adres ya da CIDR yazımıyla aralıktır; sürüm 4 ve sürüm 6 adresler yalnızca kendi türündeki öğelerle karşılaştırılır.
- Merchant panelinde açılan anahtar en çok 20 öğe alır; sürüm 4 aralığı /16’dan, sürüm 6 aralığı /48’den geniş olamaz.
- Anahtarın yetkileri ve adres listesi açıldıktan sonra değişmez: değiştirmek için yeni anahtar açıp eskisini kapatın.
Anahtar yenileme ve kapatma
Merchant panelinde bir anahtarı kapatırken nasıl kapanacağını seçersiniz:
- Hemen kapat (sızan anahtar için): anahtar o anda çalışmayı bırakır.
- N gün sonra kapat (N 1–7, panel 7 önerir): eski anahtar o zamana kadar olağan çalışır; sunucularınızı yeni anahtara geçirirsiniz. Kapanış zamanı anahtarın yanında görünür, ileri alınamaz ve geri alınamaz; ama anahtarı yine hemen kapatabilirsiniz.
- Örtüşme süresindeki anahtar 10 anahtar sınırına sayılır. Nasıl kapanmış olursa olsun kapanmış anahtar, her geçersiz anahtar gibi
401 UNAUTHORIZEDalır. - Anahtar, imza denetimimizle isteğinizin bitişi arasında kapanırsa istek
401 UNAUTHORIZEDalır ve hiçbir şey yazılmaz; yeni anahtarla yeniden deneyin.
İsteği imzalama
Her istekte üç başlık bulunur:
| Başlık | Değer |
|---|---|
X-Cryptogon-Key | Anahtar kimliğiniz |
X-Cryptogon-Timestamp | Unix zamanı, tam saniye; saatimizden en çok 5 dakika farklı olabilir |
X-Cryptogon-Signature | v1= + imzalanan metnin gizli anahtarla HMAC-SHA256’sı, küçük harfli onaltılık |
İmzalanan metin, aralarında \n (satır sonu) olan dört satırdır. HMAC anahtarı 43 karakterlik gizli anahtarın kendisidir (metin olarak).
<timestamp>
<METHOD>
<path including the query string, exactly as sent>
<hex SHA-256 of the request body (of the empty string when there is no body)>X-Cryptogon-Key: test_8f2aC71d0b5e4c39a6f1d2e7b8c90a1b4
X-Cryptogon-Timestamp: 1791975600
X-Cryptogon-Signature: v1=5f0c6b1e9a…
Idempotency-Key: order-1001
Content-Type: application/json- Gönderdiğiniz baytları birebir imzalayın. İmzadan sonra JSON’u yeniden biçimlendirmeyin.
- Gövdeli isteklerde
Content-Type: application/jsonzorunludur (değilse415); gövde en çok 64 KB olabilir (değilse413). - Yol, sorgu dahil gönderildiği gibidir:
/v1/deposits?merchant_reference=order-1001. - Anahtar, zaman damgası ya da imza hatalarının hepsi aynı yanıtı alır:
401 UNAUTHORIZED. Eksik başlık, biçimi yanlış anahtar kimliği, öteki ortamın anahtarı ve kapanmış anahtar da buna dahildir.
Denetim sırası
- Sunucu adı:
421 MISDIRECTED_REQUEST. - İstemci adresi başına istek sayısı (imza denetlenmeden önce):
429 RATE_LIMITED. - Gövde türü ve boyutu:
415ya da413, ikisi deINVALID_REQUESTkoduyla. - Başlıklar, anahtar ve imza:
401 UNAUTHORIZED. - Siteniz etkin:
403 SITE_NOT_ACTIVE. - Anahtarın yetkisi var:
403 INSUFFICIENT_SCOPE. - İstek izinli bir adresten geliyor:
403 IP_NOT_ALLOWED. - Gövde bir JSON nesnesi:
400 INVALID_REQUEST. - Site başına istek sayısı:
429 RATE_LIMITED. - Alanlar,
Idempotency-Keyve iş kuralları: Hatalar sekmesindeki kodlar.
Idempotency
POST /v1/deposits, POST /v1/deposit-sessions, POST /v1/withdrawals ve POST /v1/withdrawals/{id}/cancel Idempotency-Key başlığı ister: 8–100 karakter; harf, rakam ve _ . : -.
- Anahtar metot, yol (sorgusuz) ve gövdenin baytlarıyla eşleştirilir. Aynı anahtar ve aynı istek kaydı güncel hâliyle döner: ilk yanıt
201(iptalde200), tekrarlar200. - Aynı anahtar farklı bir istekle gelirse:
422 IDEMPOTENCY_KEY_REUSED. İstek başarısız olursa anahtar saklanmaz ve yeniden kullanılabilir. - Asıl tekillik
merchant_reference’tadır. Aynı referans aynı içerikle yeni bir anahtarla gelirse de var olan kayıt200ile döner; iki istek aynı anda gelse bile. Aynı referans farklı içerikle gelirse409 DUPLICATE_REFERENCE. Yatırma talepleri ve ödeme oturumları tek bir referans alanını paylaşır; çekimlerin kendi alanı vardır. - Aynı olması gereken içerik: yatırma talebinde
player_id,network,asset,amount; oturumdaplayer_id,currency,amount,options; çekimdeplayer_id,network,asset,address(sağlama toplamı biçimine çevrilmiş) veamount.expires_inkarşılaştırılmaz. - Zaman aşımında aynı anahtar ve aynı gövdeyle yeniden deneyin. Anahtarlar 7 gün saklanır.
Tutarlar
- Tutarlar her zaman ondalık metin olarak gider ve gelir:
"100.5". JSON sayısı kayan noktalı olduğu için reddedilir. Sıfır reddedilir. - Kripto tutarı varlığın ondalık basamağından fazlasını taşıyamaz (
GET /v1/assets,decimals). - Fiat tutarlar para biriminin küsuratıyla yazılır (
GET /v1/currencies,minor_units):"500.00"TRY,"5000"JPY. Sondaki sıfırlar serbesttir (JPY’de"500.00"= 500); fazla küsurat yuvarlanmaz, reddedilir.
İstek sınırları
| Sınır | Dakikada | Sayılan |
|---|---|---|
| İstemci adresi başına | 1.800 | Her istek, imza denetlenmeden önce. Sürüm 6 adresler /64 ağı başına sayılır |
| Site başına | 1.200 | Sitenizin imzalı her isteği |
| Site başına, açan istekler | 300 | POST /v1/deposits, POST /v1/deposit-sessions ve POST /v1/players/{player_id}/addresses (site sınırına da sayılır) |
Kısa patlamalara izin verilir: her sınır sürekli dolar. Sınır aşılırsa saniye cinsinden Retry-After başlığıyla 429 RATE_LIMITED döner; o kadar bekleyip aynı Idempotency-Key ile yeniden deneyin.
Uç noktalar
Bütün yollar taban adrese göredir. Başka sitenin kaydı, var olmayan kayıt ve UUID olmayan kimlik aynı yanıtı alır: 404 NOT_FOUND. merchant_reference ile arama sorgu parametresi ister (yoksa 400).
GET/v1/assets
Bu ortamda açık varlıklar.
{
"data": [
{
"network": "tron",
"asset": "USDT",
"name": "Tether USD",
"decimals": 6,
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"family": "tron",
"chain_id": null
}
]
}GET/v1/rates
Açık her varlığın güncel USD karşılığı: en az üç borsanın medyanı, dakikada bir yenilenir.
{
"data": [
{ "asset": "ETH", "usd": "2687.765", "pegged": false, "available": true, "updated_at": "2026-10-04T10:00:00.000Z" },
{ "asset": "USDT", "usd": "1", "pegged": true, "market_usd": "0.999825", "available": true, "updated_at": "2026-10-04T10:00:00.000Z" }
]
}- Stablecoin’ler (
pegged) 1 USD sayılır;market_usdborsa fiyatıdır. 1 USD’den %1 ya da daha fazla saparsaavailablefalseolur ve o varlıkta yeni yatırma503 ASSET_PAUSEDalır. - Native coin’in (ETH, BNB, TRX) güvenilir kuru yoksa
usdnullolur ve yeni istek503 RATE_UNAVAILABLEalır.
GET/v1/currencies
Sitenizin ödeme oturumunda kabul ettiği fiat para birimleri.
{
"data": [
{ "code": "TRY", "minor_units": 2, "available": true, "per_usd": "41.18", "updated_at": "2026-10-05T12:00:00.000Z", "max_amount": "100000.00" },
{ "code": "USD", "minor_units": 2, "available": true, "per_usd": "1", "updated_at": null, "max_amount": null }
]
}available: false iken şu an oturum açılamaz (kur yok ya da açık değil); per_usd yalnızca para birimi açıkken döner. max_amount o para birimindeki tek oturum sınırınızdır (null: sınır yok).
POST/v1/deposit-sessions
Ödeme oturumu açın: siz tutarı ve para birimini gönderirsiniz, müşteri coini ve ağı ödeme sayfasında seçer.
{
"merchant_reference": "order-7781234",
"player_id": "customer-42",
"amount": "500.00",
"currency": "TRY",
"options": [
{ "network": "tron", "asset": "USDT" },
{ "network": "bsc", "asset": "USDT" }
],
"expires_in": 1800
}| Alan | Kural |
|---|---|
merchant_reference | Zorunlu. İşlem kimliğiniz, site başına tekil (yatırma talepleriyle ortak) |
player_id | Zorunlu. Müşteri için sizin kimliğiniz; müşterinin yatırma adresleri bu kimlik için kalıcıdır |
currency | Zorunlu. ISO 4217 kodu (GET /v1/currencies) ya da açık bir kripto sembolü (USDT; o zaman yalnızca o coin sunulur, çevrim yapılmaz). Sitenizde açık değilse: 422 CURRENCY_NOT_SUPPORTED |
amount | İsteğe bağlı ondalık metin. Yoksa müşteri istediği tutarı gönderir. Sınırınızın üstünde: 422 AMOUNT_OUT_OF_RANGE |
options | İsteğe bağlı, 1–50 öğe, her biri yalnızca { "network", "asset" }. Yalnızca bunlar sunulur; yoksa sitenizin kabul ettiği her şey. Tekrar ya da bilinmeyen alan: 400; sitenizde ya da ortamda açık değilse: 422 ASSET_NOT_AVAILABLE |
expires_in | Müşterinin seçim süresi, saniye: 300–1800, varsayılan 1800 |
{
"id": "6f1c2a7e-3b4d-4e5f-8a9b-0c1d2e3f4a5b",
"merchant_reference": "order-7781234",
"player_id": "customer-42",
"status": "awaiting_selection",
"amount": { "value": "500.00", "currency": "TRY" },
"checkout_url": "https://cryptogon.app/p/b7mLw80n-qQJCa1eOqefaNH-Hzad0RoCNBYqA7poDVc",
"choose_until": "2026-10-05T12:30:00.000Z",
"created_at": "2026-10-05T12:00:00.000Z",
"selection": null,
"payment": null,
"extra_payments": []
}Müşteri seçince selection dolar (ağ değiştirirse son seçimi gösterir):
"selection": {
"network": "tron",
"asset": "USDT",
"address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7",
"crypto_amount": "12.15",
"quote": { "basis": "fx", "fx_per_usd": "41.18", "crypto_usd": "1", "locked_until": "2026-10-05T12:20:00.000Z" },
"pay_until": "2026-10-05T12:19:00.000Z",
"expires_at": "2026-10-05T12:20:00.000Z",
"selections": 2
}- Kur ve tutar. Fiat oturumda kur, müşteri seçtiği anda 15 dakika kilitlenir. Kripto tutarı yukarı yuvarlanır: sipariş tutarından azını hiçbir zaman almazsınız, makas yoktur. Kripto cinsinden oturumda
basisidentity’dir, çevrim yapılmaz. - Değiştirme. Müşteri ödemeden önce coini ya da ağı en çok 8 kez değiştirebilir (en çok 4 farklı adres). Önceki adresler süreleri dolana kadar ödeme almaya devam eder; iki ödeme gelirse yalnızca biri kazanır, öteki
extra_payments’ta bekletilir. Müşterinin açık yatırma talebi olan varlık seçilemez. - Ödeme süresi.
pay_until=expires_ateksi ağ payı (TRON ve BSC’de 1 dakika, Ethereum’da 3). Adres o ana kadar gösterilir;expires_at’ten önce görülen transfer yine sayılır. Adres göstermek durdurulmuşken, site etkin değilken ya da başka bir seçim ödendiğinde veya oturum ödendiğindeaddressnullolur.
payment oturumu ödeyen yatırmadır (kesinleşmeden önce görülen ilk ödeme); extra_payments aynı biçimdedir:
"payment": {
"id": "a1b2c3d4-0000-4000-8000-000000000004",
"network": "tron",
"asset": "USDT",
"tx_hash": "…",
"amount": "12.15",
"status": "confirmed",
"order_value": { "value": "500.00", "currency": "TRY", "basis": "locked" },
"variance": "exact",
"credit_status": "pending",
"hold_reason": null,
"detected_at": "2026-10-05T12:05:00.000Z",
"confirmed_at": "2026-10-05T12:06:00.000Z",
"commission": { "rate": "1.5", "amount": "0.18225", "net": "11.96775", "fixed_at": "2026-10-05T12:06:00.000Z", "credited_at": null }
}order_value: alınanın oturum para birimindeki karşılığı, aşağı yuvarlanmış. Hesaba bu tutarı geçirin, sipariş tutarını değil: eksik ödemede az, fazla ödemede fazla. Kesinleşmeden öncenull.basis:locked,identity(kripto oturum),confirm_rate(geç ödeme) ya daunavailable(değer yok; ödeme bekletilir).credit_status:pending(kesin, bekletilmemiş),credited(net tutar Cryptogon bakiyenizde),failed(kesinleşme olayı 24 saat teslim edilemedi; bkz. Webhook’lar) ya dahold_reasonileheld(extra_payment,late_payment,no_valuation).held’i asla hesaba geçirmeyin.commission: yatırma komisyonumuz, ödemenin kendi coininde alınır.order_valuebrüt kalır; bakiyeniznetkadar artar.
Para biriminin güncel kuru yoksa: 503 FX_UNAVAILABLE ve Retry-After: 60. Sunulabilecek bir şey yoksa (sitenizde varlık yok ya da tutar her coinin en küçük tutarının altında): 422 NO_PAYMENT_OPTION. Aynı isteğin tekrarı oturumu güncel hâliyle 200 ile döner.
GET/v1/deposit-sessions/{id} · /v1/deposit-sessions?merchant_reference=…
Ödeme oturumunu kimliğiyle ya da referansınızla okuyun. Biçim yukarıdakiyle aynıdır. Oturumun seçimleri GET /v1/deposits’te görünmez.
POST/v1/deposits
Sizin seçtiğiniz varlıkta yatırma talebi açın.
{
"merchant_reference": "order-1001",
"player_id": "customer-42",
"network": "bsc",
"asset": "USDT",
"amount": "100.5",
"expires_in": 1800
}amountisteğe bağlıdır (yoksa müşteri istediği tutarı gönderir).expires_in: 300–1800 saniye; varsayılan native coin’de 900 (kur kilidi süresi), stablecoin’de 1800.- Müşterinin adresi kalıcıdır: aynı müşteri ve ağ için her zaman aynı adres döner.
- Aynı varlıkta açık talep ya da oturum adresi varsa
409 OPEN_DEPOSIT_EXISTS; ancak ödeme süresi geçmiş ve transferi görülmemiş açık talepexpiredkapanır ve yenisi açılır. - Adres göstermek durdurulmuşken yeni talep de tekrarı da
503 SERVICE_PAUSEDalır.
{
"id": "f2f7dc13-a7c5-4869-b319-3802e5df44b4",
"merchant_reference": "order-1001",
"player_id": "customer-42",
"status": "pending",
"network": "bsc",
"asset": "USDT",
"address": "0x8BAE832C68d7c90C11bCA5EB8Bd0f14d49bd9e8F",
"amount": "100.5",
"rate": null,
"expires_at": "2026-10-03T21:47:43.622Z",
"created_at": "2026-10-03T21:17:43.622Z",
"checkout_url": "https://cryptogon.app/p/pRI-j9KWJeCjolfdZJJlUZ1fJHdoiaawqyeljswwBMA",
"transfer": null
}- Kur kilidi. Native coin’de güncel kur 15 dakika kilitlenir (
rate.usd,rate.locked_until), talebin süresini aşmadan. Açık talebi olmayan ödemeye kesinleştiği andaki kur uygulanır. Stablecoin’derate: null(1 USD). - Transfer. Bir transfer görülünce
transferalanıtx_hash,amount(gelen),status,variance,credit_status(pending,credited,failed),detected_at,confirmed_atvecommissiongösterir. - Komisyon. Yatırma kesinleşince
transfer.commissionkomisyonumuzu yatırmanın coininde gösterir; bakiyeniznetkadar artar.amountbrüt kalır. - Adres. Transferi olmayan açık talepte adres göstermek durdurulmuşken ya da site etkin değilken
addressnull’dır. Talep kapandıktan sonra ödeme linki 24 saat yalnızca durumu gösterir, sonra404döner.
"commission": {
"rate": "1.5",
"amount": "1.5",
"net": "98.5",
"fixed_at": "2026-10-07T10:06:00.000Z",
"credited_at": null
}GET/v1/deposits/{id} · /v1/deposits?merchant_reference=…
Yatırma talebini okuyun. Biçim yukarıdakiyle aynıdır.
POST/v1/players/{player_id}/addresses
Müşterinin bir ağdaki kalıcı yatırma adresi, mutabakat için. 200 döner; gerekirse müşteriyi oluşturur.
{ "network": "tron" }{ "player_id": "customer-42", "network": "tron", "address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7" }Bu adrese açık yatırma talebi ya da oturum yokken gelen transfer olay göndermez ve kendiliğinden hesaba geçmez (bkz. Yaşam döngüsü). Adres henüz hazır değilse: 503 ADDRESS_NOT_READY; adres göstermek durdurulmuşsa: 503 SERVICE_PAUSED.
POST/v1/withdrawals/quote
Çekimi açmadan ağ ücreti ve müşteriye gidecek en az tutar. 200 döner, kayıt açmaz, Idempotency-Key istemez.
{ "network": "tron", "asset": "USDT", "amount": "100" }{
"network": "tron",
"asset": "USDT",
"amount": "100",
"network_fee_payer": "player",
"network_fee_max": "6.12",
"net_min": "93.88",
"parts": 1,
"min_net": "0",
"min_amount": "10"
}network_fee_payer: TRON’da (TRC20) ağ ücreti müşteriye giden tutardan düşülür ("player"); öteki ağlarda bakiyenizden ayrıca alınır ("merchant",net_min=amount).network_fee_max: bütün parçalar için en çok ağ ücreti;net_min: müşteriye giden en az tutar. Gerçek ücret imzadan hemen önce hesaplanır ve çoğu zaman daha düşüktür.parts: tutarın kaç işlemle gönderileceği.min_amount: TRON’da en küçük çekim, brüt (ücret dahil 10 USD karşılığı; USD’ye sabit varlıkta 10 birim). Altında ya da bir parça ücret üst sınırını aşmıyorsa:422 AMOUNT_TOO_SMALL.min_nethep"0"’dır (eski istemciler için duruyor).- Teklif saklanmaz: ücret çekim kabul edilirken yeniden hesaplanır. Şu an hesaplanamıyorsa:
503 FEE_UNAVAILABLEveRetry-After.
POST/v1/withdrawals
Müşterinizin adresine kripto gönderin.
{
"merchant_reference": "payout-5001",
"player_id": "customer-42",
"network": "bsc",
"asset": "USDT",
"address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
"amount": "10"
}{
"id": "0d4b7a6e-1c2f-4e3a-9b8c-7d6e5f4a3b2c",
"merchant_reference": "payout-5001",
"player_id": "customer-42",
"status": "processing",
"network": "bsc",
"asset": "USDT",
"address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
"amount": "10",
"paid_amount": "0",
"tx_hash": null,
"parts": [],
"created_at": "2026-10-11T10:00:00.000Z",
"updated_at": "2026-10-11T10:00:00.000Z",
"fees": {
"withdrawal_fee": "1.5",
"network_fee_max": "3",
"network_fee": "0",
"charged": null,
"released": null,
"state": "held",
"fixed_at": "2026-10-11T10:00:00.000Z",
"closed_at": null,
"network_fee_payer": "merchant",
"player_network_fee_max": null,
"player_network_fee": null,
"net_amount": null
},
"rejection_reason": null
}- Yanıt her zaman
processing’dir (201; tekrarı200). Onay kararı sonra, çoğunlukla bir dakika içinde, olay olarak gelir: bkz. Onay. - Tutar kabul anında site bakiyenizden kilitlenir. Kullanılabilir bakiyeniz yetmiyorsa çekim bunun yerine bakiye bekler (aşağıda).
- Adres zincirin biçimine ve sağlama toplamına göre denetlenir; değilse
reasonile422 INVALID_ADDRESS(format,checksumya danetwork). Küçük harfli EVM adresi kabul edilir ve EIP-55 biçiminde saklanır. Kendi yatırma adreslerimiz ve token kontratlarıreasonolmadan422 INVALID_ADDRESSile reddedilir. merchant_referencecg:ile başlayamaz (ayrılmış):400 INVALID_REQUEST.- Yanıt alanları:
id,merchant_reference,player_id,status,network,asset,address,amount,tx_hash,created_at,updated_at(son durum değişikliği),fees,rejection_reason.
- Ücretler. Çekim ücretimiz ve ağ ücreti müşteriye gidenden düşülmez: çekilen varlıkta bakiyenizden alınır. Kabulde ağ ücreti için bir üst sınır tutulur; gerçek ücret gönderimden sonra alınır (bölünmüş çekimde parça parça), çekim kapanınca kalanı serbest kalır. Zincirde başarısız olursa çekim ücreti alınmaz, harcanan ağ ücreti alınır.
- TRON (TRC20): ağ ücretini müşteri öder. Tutardan düşülür (
net_amount=amount−player_network_fee) ve kabulde sabitlenen üst sınırı (player_network_fee_max) hiçbir zaman aşmaz. Ücret hesaplanamıyorsa çekim açılmaz (503 FEE_UNAVAILABLE). Gönderildikten sonra zincirde başarısız olursa bakiyenizeamount−player_network_feedöner.
"fees": {
"withdrawal_fee": "1.5",
"network_fee_max": "0",
"network_fee": "0",
"charged": null,
"released": null,
"state": "held",
"fixed_at": "2026-10-11T10:00:00.000Z",
"closed_at": null,
"network_fee_payer": "player",
"player_network_fee_max": "6.12",
"player_network_fee": "3.01",
"net_amount": "96.99"
}GET/v1/withdrawals/{id} · /v1/withdrawals?merchant_reference=…
Çekimi okuyun. Biçim yukarıdakiyle aynıdır.
Bölünmüş çekim. İşlem başına imza sınırımızın üstündeki çekim birkaç parça hâlinde gönderilebilir. parts parçaları sırasıyla listeler (amount, status, tx_hash); bölünmemiş çekimde boştur. Üst düzey tx_hash null kalır: parts’a bakın. paid_amount ödenen brüt tutardır, amount ile aynı terimlerle (müşterinin ağ ücreti düşülmeden; net için fees.net_amount); bölünmemiş çekimde completed olunca amount, öncesinde "0". withdrawal.sent ilk parça ağa gönderilince bir kez gelir; çekim tam olarak bir son olayla biter: withdrawal.completed, withdrawal.partially_completed, withdrawal.failed ya da withdrawal.cancelled. İlk parçadan önce Cryptogon tutarın tamamı için zincir likiditesi ayırır; bu rezervasyonu beklerken çekim processing, her parça processing ve tx_hash: null’dır ve çekimi hâlâ iptal edebilirsiniz. Cryptogon bölünmüş çekimi durdurursa gönderilmemiş parçalar processing kalır, rezervasyon tutulur ve olay gönderilmez; devam edilince kalan parçalar gider ve çekim tam tutarda completed biter. Durdurulmuşken ve hiçbir parçası imzalanmamışken çekimi iptal edebilirsiniz (withdrawal.cancelled). withdrawal.partially_completed yalnızca alıcı adres çekim sürerken dolandırıcılık ya da yaptırım nedeniyle engellendiğinde gelir.
{
"id": "5c2e8f1a-7b3d-4e6f-9a0b-1c2d3e4f5a6b",
"merchant_reference": "payout-5002",
"status": "partially_completed",
"amount": "25000",
"paid_amount": "8333.333334",
"tx_hash": null,
"parts": [
{ "amount": "8333.333334", "status": "completed", "tx_hash": "0x…" },
{ "amount": "8333.333333", "status": "failed", "tx_hash": "0x…" }
],
"…": "…"
}POST/v1/withdrawals/{id}/cancel
Çekimi imza başlamadan iptal edin (bakiye ya da onay beklerken de; bölünmüş çekimi Cryptogon durdurmuşken ve hiçbir parçası imzalanmamışken de). Gövde göndermeyin.
- Çekimi artık
cancelledolarak200ile döner vewithdrawal.cancelledgönderir. Kilit çözülür (bakiye bekleyen çekimin kilidi yoktu). - İmza başladıktan sonra, çekim kesinleşmişse ya da durumu aynı anda değiştiyse:
409 INVALID_STATE. Zaten iptal edilmiş çekime yeni anahtarla iptal de409alır. - Aynı
Idempotency-Keyile tekrarı güncel durumu200ile döner.
Webhook’lar
Bir şey değişince sitenizin webhook adresine POST göndeririz. Adresi merchant panelinde API ve webhook sayfasında girin; panel imza anahtarını (whsec_…) bir kez gösterir. Adres değişince yeni anahtar verilir ve teslim edilmemiş olaylar yeni adrese taşınır. Webhook’u kapatmak bekleyen teslimatları iptal eder.
Teslimat
- Adres varsayılan 443 portunda
httpsolmalı, en çok 500 karakter, kullanıcı adı, parola ve#içermemeli ve kamuya açık bir adrese çözülmelidir. Yönlendirme takip edilmez. - 10 saniye içinde
2xxdönün; öteki her durum kodu, yönlendirme, ağ hatası ve zaman aşımı başarısızlıktır. Olayı kuyruğa alıp hemen yanıt verin. - Adresinize istekleri birer birer göndeririz ve farklı bayilerin teslimatları sırayla gider; yavaş bir adres ötekileri geciktirmez.
- Art arda 3 zaman aşımından sonra adresiniz 60 saniye bekletilir: o sürede zamanı gelen teslimatlar gönderilmeden başarısız sayılır ve bir sonraki denemeye kalır. Bekleme bitince tek bir deneme gider; herhangi bir yanıt beklemeyi bitirir.
- Aynı olay birden çok gelebilir (
idaynı): bir kez işleyin. Olaylar sırasız gelebilir: aynı kaynak için daha önce işlediğinizden küçükresource_version’lı olayı yok sayın.
Yeniden denemeler
| Deneme | Önceki başarısızlıktan sonra bekleme | Olaydan yaklaşık bu kadar sonra |
|---|---|---|
| 1 | — | saniyeler içinde |
| 2 | 1 dakika | 1 dakika |
| 3 | 5 dakika | 6 dakika |
| 4 | 15 dakika | 21 dakika |
| 5 | 1 saat | 1 saat 21 dakika |
| 6 | 3 saat | 4 saat 21 dakika |
| 7, 8, 9 … | her biri 6 saat | 10 sa 21 dk, 16 sa 21 dk, 22 sa 21 dk … |
Olaydan 24 saatten fazla sonra başarısız olan teslimat bırakılır (failed). Cryptogon onu elle yeniden gönderebilir; gövde o zaman güncel durumdan kurulur.
İmzayı doğrulama
POST /your/webhook/path
Content-Type: application/json
User-Agent: Cryptogon-Webhook/1
X-Cryptogon-Event-Id: 0b8f5a52-2d1c-4c47-9a9b-6a3d2c1e0f11
X-Cryptogon-Timestamp: 1791975960
X-Cryptogon-Signature: v1=<hex HMAC-SHA256(whsec_…, "<timestamp>.<raw body>")>- HMAC anahtarı
whsec_…metninin kendisidir. İmzalanan metin<zaman damgası>.<ham gövde>’dir. - İmzayı gelen ham gövde üzerinde doğrulayın, sabit zamanlı karşılaştırın ve zaman damgası 5 dakikadan eski olayı reddedin.
Webhook doğrulama
import { createHmac, timingSafeEqual } from 'node:crypto';
// rawBody: the exact bytes you received. Do not parse and re-serialise the JSON first.
export function verifyWebhook(secret, headers, rawBody) {
const timestamp = String(headers['x-cryptogon-timestamp'] ?? '');
if (!/^\d+$/.test(timestamp) || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
const digest = createHmac('sha256', secret).update(`${timestamp}.${rawBody}`).digest('hex');
const expected = Buffer.from(`v1=${digest}`);
const given = Buffer.from(String(headers['x-cryptogon-signature'] ?? ''));
return given.length === expected.length && timingSafeEqual(given, expected);
}import hashlib, hmac, time
# raw_body: the exact bytes you received. Do not parse and re-serialise the JSON first.
def verify_webhook(secret: str, headers: dict, raw_body: bytes) -> bool:
timestamp = headers.get("X-Cryptogon-Timestamp", "")
if not timestamp.isdigit() or abs(time.time() - int(timestamp)) > 300:
return False
signed = timestamp.encode() + b"." + raw_body
expected = "v1=" + hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, headers.get("X-Cryptogon-Signature", ""))<?php
// $rawBody = file_get_contents('php://input'); — the exact bytes, not re-encoded JSON
function verifyWebhook(string $secret, string $timestamp, string $signature, string $rawBody): bool
{
if (!ctype_digit($timestamp) || abs(time() - (int) $timestamp) > 300) return false;
$expected = 'v1=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
return hash_equals($expected, $signature);
}
$ok = verifyWebhook(
getenv('CRYPTOGON_WEBHOOK_SECRET'),
$_SERVER['HTTP_X_CRYPTOGON_TIMESTAMP'] ?? '',
$_SERVER['HTTP_X_CRYPTOGON_SIGNATURE'] ?? '',
file_get_contents('php://input'),
);Gövde
{
"id": "0b8f5a52-2d1c-4c47-9a9b-6a3d2c1e0f11",
"type": "payment.confirmed",
"created_at": "2026-10-05T12:06:00.000Z",
"resource_version": 3,
"payment_id": "a1b2c3d4-0000-4000-8000-000000000004",
"data": { "id": "6f1c2a7e-…", "merchant_reference": "order-7781234", "status": "confirmed", "…": "…" }
}data, kaynağın olay gönderildiği andaki hâlidir ve API’deki görünümle aynıdır (GET /v1/deposits/{id}, GET /v1/deposit-sessions/{id}, GET /v1/withdrawals/{id}; ödeme linki hariç). Bu yüzden geç gelen olay da en yeni durumu taşır: kararı type’a göre değil data.status’a göre verin. resource_version bir kaynağın olaylarını 1’den başlayarak sayar. payment.* olaylarında payment_id de vardır: olayın yazıldığı ödeme (payment.expired’da null).
{
"id": "7c41d2e0-5b8a-4f3e-9d6c-2a1b0e9f8d7c",
"type": "withdrawal.rejected",
"created_at": "2026-10-14T10:13:20.000Z",
"resource_version": 1,
"data": {
"id": "0d4b7a6e-1c2f-4e3a-9b8c-7d6e5f4a3b2c",
"merchant_reference": "payout-5001",
"status": "rejected",
"tx_hash": null,
"fees": null,
"rejection_reason": "insufficient_funds",
"…": "…"
}
}Olaylar
| Tür | Ne zaman |
|---|---|
payment.detected | Oturuma bir ödeme zincirde görüldü, kesinleşmedi |
payment.confirmed | Oturumu ödeyen ödeme kesinleşti; kazanan data.payment’ta. Buna 2xx dönmeniz bakiyenize geçişi başlatır |
payment.extra | Bir ödeme kesinleşti ama bekletildi (oturum zaten ödenmişti, geç ödeme ya da değer alınamadı). Hesaba geçirmeyin |
payment.released | Ödenmiş ya da süresi dolmuş bir oturumun bekletilen ödemesini inceleyip serbest bıraktık: artık credit_status: pending. Ödemenin id’siyle hesaba geçirin. (Ödenmemiş oturumda serbest bırakılan ödeme oturumu öder ve bunun yerine payment.confirmed gelir) |
payment.dropped | Görülen ödeme kesinleşmeden düştü |
payment.expired | Oturumun süresi doldu, ödeme gelmedi |
deposit.detected | Yatırma talebine bir transfer zincirde görüldü |
deposit.confirmed | Kesinleşti. Tutar farkı data.transfer.variance’ta. Buna 2xx dönmeniz net tutarın bakiyenize geçişini başlatır |
deposit.dropped | Görülen transfer kesinleşmeden düştü; talep açık kalır |
deposit.expired | Talebin süresi doldu, ödeme gelmedi |
withdrawal.pending_approval | Karar bekliyor. Çekim sizin incelemenizden Cryptogon’a geçince yeniden gönderilir |
withdrawal.sent | Ağa gönderildi (data.tx_hash; bölünmüş çekimde ilk parçada bir kez, bkz. data.parts) |
withdrawal.completed | Zincirde kesinleşti |
withdrawal.partially_completed | Alıcı adresi dolandırıcılık ya da yaptırım nedeniyle engellenen bölünmüş çekim: data.paid_amount ödendi, kalanı döndü |
withdrawal.rejected | Gönderilmeden reddedildi (kuralla, sizce, 72 saat sonra, Cryptogon’ca ya da bakiye beklemesi bitince); kilit çözüldü. data.rejection_reason yalnızca bakiye beklerken reddedilen çekimde dolu |
withdrawal.failed | Gönderilemedi ya da zincirde başarısız oldu; kilit çözüldü |
withdrawal.cancelled | İmzadan önce sizin tarafınızdan iptal edildi |
site.funded | Site bakiyenize kasa yüklemesi kesinleşti ve yazıldı (komisyon yok) |
site.funding_held | Kasa yüklemesi kesinleşti ama bekletildi (data.hold_reason); neden değişirse yeniden gelir |
credit.requested … credit.written_off | Kredinin yaşam döngüsü: talep, onay, ret, iptal, talebin düşmesi, geri ödeme, kapanış, zarar yazma |
İç adımlar olay göndermez: bakiye bekleme, kurallarla onay, likidite rezervasyonunu bekleme, imza. Bölünmüş çekimin parçaları da göndermez; çekimin kendisi ilk parçada bir withdrawal.sent ve bir son olay gönderir.
Bakiyeye geçiş
- Dakikada bir, kesinleşme olayına (
deposit.confirmedya dapayment.confirmed) adresinizin2xxdöndüğü kesin yatırmaların net tutarını bakiyenize geçiririz. Sonracredit_statuscreditedolur vecommission.credited_atyazılır. Gövde gönderim anında kurulduğu için olayın kendisindecredited_at: nullgörünebilir; kesin durumu kaynağı okuyarak alın. - Webhook adresi yoksa geçiş bekler. Kesinleşme olayının bütün teslimatları 24 saat boyunca başarısız olduysa
credit_statusfailedolur ve Cryptogon inceler; olay yeniden teslim edilince geçiş yapılır. - Cryptogon bakiyeye geçişi durdurursa ya da ödemenin stablecoin’i sabitinden saparsa olaylar yine teslim edilir; geçiş durdurma bitene kadar bekler.
Ödeme oturumunda hesaba geçirme kuralları
Her payment.* gövdesi oturumun gönderim anındaki tam hâlidir ve olayın hangi ödeme için gönderildiğini söylemez. Hesaba geçirmeyi olay türüne değil, gövdedeki ödemelere bakarak yapın:
data.paymentvedata.extra_paymentsiçindeki her ödemeye bakın. Yalnızcastatus: confirmedvecredit_statusdeğeripendingya dacreditedolanı hesaba geçirin. Tutar sipariş tutarı değil, ödemeninorder_value.value’sudur.- Her ödemeyi
id’siyle (yatırma kimliği) tam bir kez hesaba geçirin, hangi olayla gelirse gelsin. Olay kimliğini değil ödeme kimliğini saklayın: aynı ödeme birden çok olayda görünür ve bakiyenize geçincecredit_statuspending’dencredited’a döner. Serbest bırakılan ek ödeme aynımerchant_referenceiçin ikinci bir hesaba geçirmedir. credit_status: heldolan ödemeyi asla hesaba geçirmeyin; tanımadığınız bir değeri de geçirmeyin.failedyalnızca olayımızın size ulaşmadığını söyler; yeniden teslim edilene kadar bekleyin.- Tanımadığınız olay türlerini ve alanları yok sayın.
payment.*olaylarını yalnızca ödeme oturumu açan siteler alır.
Yatırma talebinde data.status confirmed olduğunda transfer.amount’u talep id’si başına bir kez hesaba geçirin; bir talep yalnızca bir transfer alır.
Hatalar
Hataların hepsi aynı biçimdedir. Bazıları ek alan taşır (örneğin reason, required, min_amount). message metni insanlar içindir ve değişebilir: kararı code’a göre verin.
{ "error": { "code": "INVALID_ADDRESS", "message": "…", "reason": "checksum" } }| HTTP | code | Ne zaman |
|---|---|---|
| 400 | INVALID_REQUEST | Gövde bir JSON nesnesi değil; eksik, bilinmeyen ya da geçersiz alan; aralık dışı expires_in; cg: ile başlayan referans; merchant_reference sorgu parametresi yok |
| 400 | INVALID_AMOUNT | Sayı olarak, sıfır, fazla ondalıkla ya da (oturumda) para biriminin küsuratına uymayan tutar |
| 400 | IDEMPOTENCY_KEY_REQUIRED, INVALID_IDEMPOTENCY_KEY | Başlık yok ya da biçimi yanlış |
| 401 | UNAUTHORIZED | Eksik başlık, biçimi yanlış ya da bilinmeyen anahtar kimliği, öteki ortamın anahtarı, kapanmış anahtar, 5 dakika dışında zaman damgası, yanlış imza; istek sürerken kapanan anahtar da |
| 403 | SITE_NOT_ACTIVE | Siteniz etkin değil (askıda ya da kapalı) |
| 403 | INSUFFICIENT_SCOPE | Anahtarın bu uç noktaya yetkisi yok |
| 403 | IP_NOT_ALLOWED | İstek anahtarın listesinde olmayan bir adresten geldi |
| 404 | NOT_FOUND | Bilinmeyen yol, UUID olmayan kimlik, var olmayan ya da başka sitenin kaydı |
| 409 | DUPLICATE_REFERENCE | merchant_reference farklı içerikle (ya da yatırma talebi için bir oturumda, tersi de) zaten kullanılmış |
| 409 | OPEN_DEPOSIT_EXISTS | Müşterinin bu varlıkta açık talebi ya da oturum adresi var |
| 409 | INVALID_STATE | İptal mümkün değil: imza başladı, çekim kesinleşti ya da durumu aynı anda değişti |
| 413 | INVALID_REQUEST | Gövde 64 KB’tan büyük |
| 415 | INVALID_REQUEST | Content-Type application/json değil |
| 421 | MISDIRECTED_REQUEST | Sunucu adı API adreslerimizden biri değil |
| 422 | ASSET_NOT_AVAILABLE | Ağ ya da varlık bu ortamda ya da sitenizde açık değil |
| 422 | INVALID_ADDRESS | Hedef adres geçersiz (reason: format, checksum, network) ya da kendi adreslerimizden biri veya bir token kontratı (reason yok) |
| 422 | INSUFFICIENT_NETWORK_BALANCE | Çekim; yalnızca bakiye beklemesi kapalı sitede. required, available, fee, network_reserve taşır |
| 422 | AMOUNT_TOO_SMALL | TRON çekimi ya da teklifi brüt en az tutarın altında ya da bir parça ücret üst sınırını aşmıyor. network_fee_max, min_amount, min_net, parts taşır |
| 422 | CURRENCY_NOT_SUPPORTED, AMOUNT_OUT_OF_RANGE, NO_PAYMENT_OPTION | Ödeme oturumu: para birimi sitenizde açık değil, tutar sınırınızın üstünde ya da sunulacak bir şey yok |
| 422 | IDEMPOTENCY_KEY_REUSED | Idempotency-Key farklı bir istekle kullanılmış |
| 429 | RATE_LIMITED | Çok fazla istek; Retry-After saniye sonra yeniden deneyin |
| 500 | INTERNAL | Bizim tarafımızda beklenmeyen hata; hiçbir şey yazılmaz. Aynı Idempotency-Key ile yeniden deneyin |
| 503 | SERVICE_PAUSED | Cryptogon adres göstermeyi durdurdu: yatırma talebi, oturum ve müşteri adresi |
| 503 | ADDRESS_NOT_READY | Müşterinin adresi henüz hazır değil |
| 503 | RATE_UNAVAILABLE | Güncel kur yok: native coin yatırmasında ya da çekim ücreti için |
| 503 | ASSET_PAUSED | Stablecoin sabitinden saptı; o varlıkta yeni yatırma durduruldu |
| 503 | FEE_UNAVAILABLE, FX_UNAVAILABLE | TRON ağ ücreti ya da para biriminin kuru şu an hesaplanamıyor; Retry-After: 60 |
Kod örnekleri
Ödeme oturumu açan, eksiksiz imzalı bir istek; dört dilde. Her biri imza denetimimize karşı çalıştırıldı. CRYPTOGON_KEY_ID ve CRYPTOGON_SECRET değerlerini merchant panelinden alın; CRYPTOGON_API boşsa sandbox kullanılır.
İmzalı istek
import { createHash, createHmac } from 'node:crypto';
const API = process.env.CRYPTOGON_API ?? 'https://api-sandbox.cryptogon.dev';
const KEY_ID = process.env.CRYPTOGON_KEY_ID; // test_… in the sandbox, live_… in production
const SECRET = process.env.CRYPTOGON_SECRET; // 43 characters; used to sign, never sent
async function cryptogon(method, path, payload, idempotencyKey) {
const body = payload === undefined ? '' : JSON.stringify(payload);
const timestamp = String(Math.floor(Date.now() / 1000));
const bodyHash = createHash('sha256').update(body).digest('hex');
const signature = createHmac('sha256', SECRET)
.update([timestamp, method, path, bodyHash].join('\n'))
.digest('hex');
const headers = {
'X-Cryptogon-Key': KEY_ID,
'X-Cryptogon-Timestamp': timestamp,
'X-Cryptogon-Signature': `v1=${signature}`,
};
if (body) headers['Content-Type'] = 'application/json';
if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;
const res = await fetch(API + path, { method, headers, body: body || undefined });
const json = await res.json();
if (!res.ok) throw new Error(`${res.status} ${json.error?.code}`);
return json;
}
const session = await cryptogon(
'POST',
'/v1/deposit-sessions',
{ merchant_reference: 'order-1001', player_id: 'customer-42', amount: '500.00', currency: 'TRY' },
'order-1001',
);
console.log(session.checkout_url); // redirect your customer hereimport hashlib, hmac, json, os, time
import requests
API = os.environ.get("CRYPTOGON_API", "https://api-sandbox.cryptogon.dev")
KEY_ID = os.environ["CRYPTOGON_KEY_ID"] # test_… in the sandbox, live_… in production
SECRET = os.environ["CRYPTOGON_SECRET"].encode() # used to sign, never sent
def cryptogon(method, path, payload=None, idempotency_key=None):
body = b"" if payload is None else json.dumps(payload, separators=(",", ":")).encode()
timestamp = str(int(time.time()))
body_hash = hashlib.sha256(body).hexdigest()
text = "\n".join([timestamp, method, path, body_hash]).encode()
signature = hmac.new(SECRET, text, hashlib.sha256).hexdigest()
headers = {
"X-Cryptogon-Key": KEY_ID,
"X-Cryptogon-Timestamp": timestamp,
"X-Cryptogon-Signature": "v1=" + signature,
}
if body:
headers["Content-Type"] = "application/json"
if idempotency_key:
headers["Idempotency-Key"] = idempotency_key
res = requests.request(method, API + path, headers=headers, data=body or None, timeout=15)
res.raise_for_status()
return res.json()
session = cryptogon(
"POST",
"/v1/deposit-sessions",
{"merchant_reference": "order-1001", "player_id": "customer-42", "amount": "500.00", "currency": "TRY"},
idempotency_key="order-1001",
)
print(session["checkout_url"]) # redirect your customer here<?php
// test_… in the sandbox, live_… in production; the secret is used to sign and never sent
$api = getenv('CRYPTOGON_API') ?: 'https://api-sandbox.cryptogon.dev';
function cryptogon(string $method, string $path, ?array $payload = null, ?string $idempotencyKey = null): array
{
global $api;
$body = $payload === null ? '' : json_encode($payload, JSON_UNESCAPED_SLASHES);
$timestamp = (string) time();
$text = implode("\n", [$timestamp, $method, $path, hash('sha256', $body)]);
$headers = [
'X-Cryptogon-Key: ' . getenv('CRYPTOGON_KEY_ID'),
'X-Cryptogon-Timestamp: ' . $timestamp,
'X-Cryptogon-Signature: v1=' . hash_hmac('sha256', $text, getenv('CRYPTOGON_SECRET')),
];
if ($body !== '') $headers[] = 'Content-Type: application/json';
if ($idempotencyKey !== null) $headers[] = 'Idempotency-Key: ' . $idempotencyKey;
$ch = curl_init($api . $path);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 15,
]);
if ($body !== '') curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$json = json_decode((string) $response, true);
if ($status >= 400) throw new RuntimeException($status . ' ' . ($json['error']['code'] ?? ''));
return $json;
}
$session = cryptogon('POST', '/v1/deposit-sessions', [
'merchant_reference' => 'order-1001',
'player_id' => 'customer-42',
'amount' => '500.00',
'currency' => 'TRY',
], 'order-1001');
echo $session['checkout_url'], PHP_EOL; // redirect your customer hereAPI=${CRYPTOGON_API:-https://api-sandbox.cryptogon.dev}
BODY='{"merchant_reference":"order-1001","player_id":"customer-42","amount":"500.00","currency":"TRY"}'
TS=$(date +%s)
HASH=$(printf '%s' "$BODY" | sha256sum | cut -d' ' -f1)
SIG=$(printf '%s\nPOST\n/v1/deposit-sessions\n%s' "$TS" "$HASH" \
| openssl dgst -sha256 -hmac "$CRYPTOGON_SECRET" | sed 's/^.* //')
curl -sS "$API/v1/deposit-sessions" \
-H "X-Cryptogon-Key: $CRYPTOGON_KEY_ID" \
-H "X-Cryptogon-Timestamp: $TS" \
-H "X-Cryptogon-Signature: v1=$SIG" \
-H "Idempotency-Key: order-1001" \
-H "Content-Type: application/json" \
--data-raw "$BODY"Webhook imzasını doğrulama, üç dilde:
Webhook doğrulama
import { createHmac, timingSafeEqual } from 'node:crypto';
// rawBody: the exact bytes you received. Do not parse and re-serialise the JSON first.
export function verifyWebhook(secret, headers, rawBody) {
const timestamp = String(headers['x-cryptogon-timestamp'] ?? '');
if (!/^\d+$/.test(timestamp) || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
const digest = createHmac('sha256', secret).update(`${timestamp}.${rawBody}`).digest('hex');
const expected = Buffer.from(`v1=${digest}`);
const given = Buffer.from(String(headers['x-cryptogon-signature'] ?? ''));
return given.length === expected.length && timingSafeEqual(given, expected);
}import hashlib, hmac, time
# raw_body: the exact bytes you received. Do not parse and re-serialise the JSON first.
def verify_webhook(secret: str, headers: dict, raw_body: bytes) -> bool:
timestamp = headers.get("X-Cryptogon-Timestamp", "")
if not timestamp.isdigit() or abs(time.time() - int(timestamp)) > 300:
return False
signed = timestamp.encode() + b"." + raw_body
expected = "v1=" + hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, headers.get("X-Cryptogon-Signature", ""))<?php
// $rawBody = file_get_contents('php://input'); — the exact bytes, not re-encoded JSON
function verifyWebhook(string $secret, string $timestamp, string $signature, string $rawBody): bool
{
if (!ctype_digit($timestamp) || abs(time() - (int) $timestamp) > 300) return false;
$expected = 'v1=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
return hash_equals($expected, $signature);
}
$ok = verifyWebhook(
getenv('CRYPTOGON_WEBHOOK_SECRET'),
$_SERVER['HTTP_X_CRYPTOGON_TIMESTAMP'] ?? '',
$_SERVER['HTTP_X_CRYPTOGON_SIGNATURE'] ?? '',
file_get_contents('php://input'),
);Değişiklik günlüğü
Dışarıdan görünen değişiklikler, en yenisi önce. Tarih, değişikliğin canlıya çıktığı gündür (UTC). Alan ve olaylar yalnızca eklenir; var olanlar anlamını korur.
| Tarih | Değişiklik |
|---|---|
| 2026-10-19 | Bölünmüş çekim: durdurma artık çekimi eksik bitirmez. Durdurulan bölünmüş çekim bekler (processing, ilk parçadan sonra sent), rezervasyonu tutulur ve olay gönderilmez; devam edilince tam tutarda tamamlanır. Bölünmüş çekim her zaman tam tutarla biter; tek istisna alıcı adresin çekim sürerken dolandırıcılık ya da yaptırım nedeniyle engellenmesidir (partially_completed). Durdurulmuş ve hiçbir parçası imzalanmamış bölünmüş çekim iptal edilebilir. |
| 2026-10-18 | Bölünmüş çekim: Cryptogon tutarın tamamı için zincir likiditesini ayırmadan hiçbir parça gönderilmez. Beklerken çekim processing kalır ve iptal edilebilir. |
| 2026-10-18 | Belge koda göre düzeltildi: credit_status değeri pending ya da credited olan ödemeyi hesaba geçirin; failed iken bekleyin (teslim edilen ödeme yaklaşık bir dakika içinde credited olur, sonradan okumak yine geçerlidir). |
| 2026-10-18 | Anahtar kapatma 1–7 gün bekleyebilir; yeni anahtara kesintisiz geçersiniz. “Hemen kapat” durur (Anahtar yenileme ve kapatma). |
| 2026-10-18 | Adres başına istek sınırı sürüm 6 adresleri /64 ağı başına sayar. |
| 2026-10-18 | Cryptogon çekimlere kendi tutar sınırını uygulamaz: otomatik onay sınırınız karar verir (merchant panelinden en çok 5.000 USD). Onaylayıcısı olmayan sitede bekletmeleriniz atlanmaz, Cryptogon’u bekler. Cryptogon sizin adınıza karar verebilir (Onay). |
| 2026-10-16 | Her istek bitene kadar anahtarına bağlıdır: bu arada kapanan anahtar 401 UNAUTHORIZED alır ve hiçbir şey yazılmaz. |
| 2026-10-15 | Aynı merchant_reference ile aynı anda gelen iki çekim isteği: ikincisi var olan çekimi (200) ya da 409 DUPLICATE_REFERENCE döner, hiçbir zaman 500 değil. |
| 2026-10-14 | Bakiye bekleme: bakiyenizin karşılamadığı çekim 422 INSUFFICIENT_NETWORK_BALANCE yerine en çok 12 dakika (varsayılan) bekler; yeni alan rejection_reason; beklerken iptal. Süre dolumu nedenleri adil: süre dolduğunda bakiyeniz yetiyorsa service_unavailable. |
| 2026-10-14 | 429 RATE_LIMITED ve Retry-After ile istek sınırları. Webhook teslimatı: 10 saniye zaman aşımı, adres başına tek istek, art arda 3 zaman aşımından sonra 60 saniye bekleme. |
| 2026-10-10 | TRON çekimi: ağ ücretini müşteri öder (fees.network_fee_payer, player_network_fee_max, player_network_fee, net_amount); POST /v1/withdrawals/quote; 503 FEE_UNAVAILABLE; brüt en az 10 USD ile 422 AMOUNT_TOO_SMALL (min_amount; USD’ye sabit varlıkta 10 birim). |
| 2026-10-09 | Yatırmanın net tutarı, adresiniz kesinleşme olayına 2xx döndükten sonra kullanılabilir bakiyenize geçer. |
| 2026-10-08 | Çekim ücretleri: fees nesnesi; INSUFFICIENT_NETWORK_BALANCE required, available, fee, network_reserve taşır; çekim ücreti için 503 RATE_UNAVAILABLE. İzinli adres listesi her yetkide isteğe bağlı oldu. |
| 2026-10-07 | Yatırma komisyonu: transfer.commission ve her ödemenin commission’ı. Çekimde sizin onayınız (pending_approval sizi bekler; 72 saat kararsızlık reddeder; çekim Cryptogon’a geçince olay yeniden gönderilir). merchant_reference başında cg: ayrıldı. Geç ödemelerin oturuma bağlanması, payment.released ve payment_id. credit.* olayları. Anahtar ve webhook merchant panelinden yönetilir. |
| 2026-10-06 | Ödeme oturumu (/v1/deposit-sessions, payment.*) ve GET /v1/currencies. Kasa yüklemesi olayları site.funded ve site.funding_held. |
| 2026-10-05 | checkout_url ve ödeme süresiyle (pay_until) barındırılan ödeme sayfası. Çekim: tek onay kesindir; etkin olmayan site ve kara listedeki hedef için bekletme. |
| 2026-10-04 | Webhook’lar. GET /v1/rates, 15 dakikalık kur kilidi, 503 ASSET_PAUSED ve 503 RATE_UNAVAILABLE. |
| 2026-10-03 | İlk sürüm: imzalı istekler, yatırma talebi, çekim, müşteri adresi, GET /v1/assets. |
Bu sayfadaki örnek anahtar, imza, kimlik ve adresler uydurmadır. Sandbox anahtarları başlangıç sürecinde verilir.