Geliştirici dokümanı

Geliştiriciler

API belgeleri

Kendi sunucunuzdan kripto yatırma almak ve çekim göndermek için gereken her şey: imzalı istekler, barındırılan ödeme sayfası ve imzalı webhook’lar.

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

OrtamTaban adresAPI anahtarı
Canlıhttps://api.cryptogon.devlive_…
Sandbox (test ağları, gerçek para yok)https://api-sandbox.cryptogon.devtest_…

Ağlar ve varlıklar

AğCanlı koduVarlıklarSandbox koduSandbox varlıkları
TRONtronUSDT, TRXtron_nileUSDT, TRX
BNB Smart ChainbscUSDT, USDC, BNBbsc_testnetBNB
EthereumethereumUSDT, USDC, ETHethereum_sepoliaUSDC, 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)

  1. Sunucunuz POST /v1/deposit-sessions ile bir ödeme oturumu açar: tutar, para birimi (TRY, EUR, USDT …) ve kendi sipariş referansınız.
  2. Müşteriyi dönen checkout_url’e yönlendirin. Coini ve ağı orada seçer; sayfa tam tutarı, adresi ve QR kodu gösterir.
  3. Müşteri ödemeyi gönderir. Zinciri izleriz ve transfer kesinleşene kadar bekleriz.
  4. Önce payment.detected, sonra payment.confirmed webhook’u gelir. Her birine 2xx ile yanıt verin.
  5. Ödemenin order_value.value tutarını müşterinizin hesabına geçirin (kurallar Webhook’lar sekmesinde). Sunucunuz payment.confirmed olayına 2xx dö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ışı

  1. İsteğe bağlı: POST /v1/withdrawals/quote ağ ücretini ve müşteriye gidecek en az tutarı gösterir.
  2. Hedef adres ve tutarla POST /v1/withdrawals. Yanıt 201 ve status: processing’dir. Bakiyeniz yetmiyorsa çekim en çok 12 dakika (varsayılan) bakiye bekler; yine processing görünür.
  3. Onay: otomatik onay sınırınızın içindeyse ve bekletme yoksa kendiliğinden onaylanır. Değilse pending_approval olur (withdrawal.pending_approval) ve sizi ya da Cryptogon’u bekler. Bkz. Onay.
  4. İmzalar ve ağa göndeririz: tx_hash ile withdrawal.sent.
  5. Zincirde kesinleşince withdrawal.completed. Reddedilir, iptal edilir ya da başarısız olursa withdrawal.rejected, withdrawal.cancelled ya da withdrawal.failed gelir 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.confirmed ya da payment.confirmed) 2xx döndükten sonra kullanılabilir bakiyenize geçer; dakikada bir bakarız. Ne zaman geçtiğini commission.credited_at gö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 oturumuAnlamı
awaiting_selectionMüşteri henüz coin ve ağ seçmedi
awaiting_paymentSeçti; ödeme bekleniyor
detectedBir ödeme zincirde görüldü, kesinleşmedi
confirmedÖdeme kesinleşti; hesaba geçirin (kurallar Webhook’lar sekmesinde)
expiredSüre doldu, ödeme gelmedi
Yatırma talebiAnlamı
pendingÖdeme bekleniyor
detectedTransfer zincirde görüldü, kesinleşmedi
confirmedKesinleşti; transfer.variance exact, under ya da over der
expiredSüre doldu, ödeme gelmedi
ÇekimAnlamı
processingKabul edildi, yolda: bakiye beklerken, onaydan sonra ve imzalanırken de
pending_approvalKarar 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)
sentAğa gönderildi; tx_hash dolu (bölünmüş çekimde parts’ta)
completedZincirde kesinleşti
partially_completedAlı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
rejectedGönderilmeden reddedildi; kilit çözüldü (bakiye beklerken reddedilen çekimde nedeni rejection_reason söyler)
cancelledİmzadan önce sizin tarafınızdan iptal edildi
failedGö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-Key taşır; aynı anahtar ve gövdeyle yeniden denemek her zaman güvenlidir.
  • merchant_reference sizin işlem kimliğinizdir: 1–100 karakter, harf, rakam ve _ . : -; site başına tekil. player_id müşteri için sizin kimliğinizdir: aynı karakterlerle 1–64 karakter.
  • İstek gövdeleri JSON nesnesidir. Bilinmeyen alan 400 INVALID_REQUEST ile 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ğil data.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.

Yatırmanın yaşam döngüsü (ödeme oturumu)Oturum açıldı: awaiting_selection, olay yok, Bekleyin. Coin ve ağ seçildi: awaiting_payment, olay yok, Bekleyin. Zincirde görüldü: detected, payment.detected, Bekleyin. Kesinleşti: confirmed, payment.confirmed, Hesaba geçirin. Süresi doldu: expired, payment.expired, Yapılacak yok. Kesinleşmeden düştü: awaiting_payment, payment.dropped, Bekleyin. Ek ya da geç ödeme: confirmed, payment.extra, Yapılacak yok. İncelenip serbest bırakıldı: confirmed, payment.released, Hesaba geçirin.Oturum açıldıawaiting_selectionolay yokBekleyinCoin ve ağ seçildiawaiting_paymentolay yokBekleyinZincirde görüldüdetectedpayment.detectedBekleyinKesinleşticonfirmedpayment.confirmedHesaba geçirinSüresi dolduexpiredpayment.expiredYapılacak yokKesinleşmeden düştüawaiting_paymentpayment.droppedBekleyinher zaman değilEk ya da geç ödemeconfirmedpayment.extraYapılacak yokher zaman değilİncelenip serbestbırakıldıconfirmedpayment.releasedHesaba geçirin
AdımstatusWebhookYatırma talebiNe zamanNe yaparsınız
Oturum açıldıawaiting_selectionolay yokpending · olay yokOturum 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çildiawaiting_paymentolay yokyokÖ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üdetectedpayment.detecteddetected · deposit.detectedTransfer zincirde ama henüz kesin değil.Bekleyin Müşteriye beklemede gösterin; henüz hesaba geçirmeyin.
Kesinleşticonfirmedpayment.confirmedconfirmed · deposit.confirmedTransfer 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 dolduexpiredpayment.expiredexpired · deposit.expiredTransfer 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_paymentpayment.droppedpending · deposit.droppedGö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ç ödemeconfirmedpayment.extrayokİ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ıconfirmedpayment.releasedyokCryptogon 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_EXISTS alır. İstisna: ödeme süresi (pay_until) geçmiş ve transferi görülmemiş yatırma talebi expired kapanı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.value gelen tutarın oturum para birimindeki karşılığıdır, aşağı yuvarlanır; yatırma talebinde transfer.amount gelen tutardır ve transfer.variance exact, under ya da over der.
  • 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.extra ile 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_PAUSED alır ve address null olur; 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

Çekimin yaşam döngüsüBakiye bekleniyor: processing, olay yok, Bekleyin. Kabul edildi, bakiye kilitlendi: processing, olay yok, Bekleyin. Onay bekleniyor: pending_approval, withdrawal.pending_approval, Bekleyin. Ağa gönderildi: sent, withdrawal.sent, Bekleyin. Tamamlandı: completed, withdrawal.completed, Tamam. Bakiye beklemesi bitti: rejected, withdrawal.rejected, Geri verin. İptal ettiniz: cancelled, withdrawal.cancelled, Geri verin. Reddedildi: rejected, withdrawal.rejected, Geri verin. Başarısız: failed, withdrawal.failed, Geri verin.her zaman değilBakiye bekleniyorprocessingolay yokBekleyinKabul edildi, bakiyekilitlendiprocessingolay yokBekleyinher zaman değilOnay bekleniyorpending_approvalwithdrawal.pending_approvalBekleyinAğa gönderildisentwithdrawal.sentBekleyinTamamlandıcompletedwithdrawal.completedTamamBakiye beklemesi bittirejectedwithdrawal.rejectedGeri verinİptal ettinizcancelledwithdrawal.cancelledGeri verinReddedildirejectedwithdrawal.rejectedGeri verinBaşarısızfailedwithdrawal.failedGeri verin
AdımstatusWebhookNe zamanNe yaparsınız
Bakiye bekleniyorprocessingolay yokKullanı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 kilitlendiprocessingolay yokTutar ve ücretler kilitlenir; sizin sınırlarınız ve Cryptogon’un denetimleri çalışır.Bekleyin Sonraki olayı bekleyin.
Onay bekleniyorpending_approvalwithdrawal.pending_approvalSizin 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önderildisentwithdrawal.senttx_hash dolu. Artık iptal edilemez.Bekleyin Sonucu bekleyin.
Tamamlandıcompletedwithdrawal.completedZincirde kesinleşti.Tamam Ödemeyi ödendi olarak işaretleyin.
Bakiye beklemesi bittirejectedwithdrawal.rejectedSü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 ettinizcancelledwithdrawal.cancelledİmza başlamadan iptal edildi (bakiye ya da onay beklerken de).Geri verin Tutarı müşterinize geri verin.
Reddedildirejectedwithdrawal.rejectedKuralları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ızfailedwithdrawal.failedGö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ıt 409 INVALID_STATE’tir.
  • Onaydan sonra ret. İmzalanana kadar Cryptogon onaylanmış bir çekimi yine reddedebilir (ör. hedef adres onaydan sonra kara listeye girdi). Çekim processing’den rejected’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 processing kalır, büyük tutarda bu biraz sürebilir. withdrawal.sent ilk parçada bir kez gelir, çekim tek bir son olayla biter; fees.network_fee parçaların toplamıdır. Cryptogon çekimi durdurursa kalan parçalar bekler, çekim processing kalır (bir parça gittiyse sent) 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 ödenmediyse failed, 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.

Çekim onayıKabul edildi, denetlendi: processing, olay yok, Bekleyin. Sizin kararınızı bekliyor: pending_approval, withdrawal.pending_approval, Bekleyin. Cryptogon’un kararını bekliyor: pending_approval, withdrawal.pending_approval, Bekleyin. Onaylandı: processing, olay yok, Bekleyin. Kuralınızla reddedildi: rejected, withdrawal.rejected, Geri verin. Reddedildi ya da süre doldu: rejected, withdrawal.rejected, Geri verin. Cryptogon reddetti: rejected, withdrawal.rejected, Geri verin.Kabul edildi,denetlendiprocessingolay yokBekleyinher zaman değilSizin kararınızıbekliyorpending_approvalwithdrawal.pending_approvalBekleyinher zaman değilCryptogon’un kararınıbekliyorpending_approvalwithdrawal.pending_approvalBekleyinOnaylandıprocessingolay yokBekleyinKuralınızla reddedildirejectedwithdrawal.rejectedGeri verinReddedildi ya da süredoldurejectedwithdrawal.rejectedGeri verinCryptogon reddettirejectedwithdrawal.rejectedGeri verin
AdımstatusWebhookNe zamanNe yaparsınız
Kabul edildi, denetlendiprocessingolay yokKabulden (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ı bekliyorpending_approvalwithdrawal.pending_approvalOtomatik 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ı bekliyorpending_approvalwithdrawal.pending_approvalGü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ıprocessingolay yokBekletme yok ya da onaylandı. Sırada gönderim var (withdrawal.sent).Bekleyin withdrawal.sent’i bekleyin.
Kuralınızla reddedildirejectedwithdrawal.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 doldurejectedwithdrawal.rejectedSiz (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 reddettirejectedwithdrawal.rejectedCryptogon beklettiği bir çekimi reddetti.Geri verin Tutarı müşterinize geri verin.
KuralKim koyarSonuç
Otomatik onay sınırı: USD karşılığı sınıra eşit ya da üstünde, ya da karşılığı bilinmiyorSiz, 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 kapatabilirSizi bekler (pending_approval)
Çekim başına en yüksek tutarSizHemen 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ırmaSiz (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 listesindeCryptogonCryptogon’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_approval daha yüksek bir resource_version ile 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_reason null’dır.
  • Sınırınızı yükseltmek bekleyen çekimleri onaylamaz.

Bakiye bekleme

Bakiye bekleme: zaman çizelgesi0. dakika: çekim kabul edilir ve olay olmadan processing döner. 12. dakikaya kadar her dakika bakiye istek sırasıyla denetlenir. Bakiye yeterse, örneğin 5. dakikada, tutar kilitlenir, ücretler sabitlenir ve çekim olağan akışla sürer. Yetmezse 12. dakikadan sonraki tur, çoğunlukla bir dakika içinde, çekimi reddeder: rejection_reason ile withdrawal.rejected.Bekleme süresi: varsayılan 12 dakika01234567891011121314dakikaİstek: processingher dakika bir bakiye denetimiBakiye yetti (burada: 5. dakika)Kilitlendi, ücret sabit, olağan akış:withdrawal.pending_approval ya da .sentSüre doldu: sonraki turda reddedilirwithdrawal.rejected, durum rejected,nedeni rejection_reason’da
ZamanAdımstatusWebhookNe yaparsınız
0İstek kabul edildi processing ve fees: null ile 201; olay yok.processingolay yokBekleyin Bekleyin.
her dakikaBakiye denetimleri Varlık başına istek sırasıyla; sonraki istek öncekinin önüne hiçbir zaman geçmez.processingolay yokBekleyin Ödenmesini istiyorsanız bakiye yükleyin.
bakiyeniz yettiğindeBakiye geldi Tutar kilitlenir, ücretler sabitlenir; kabul edilmiş her çekim gibi sürer.processingolay yokBekleyin Sonraki olayı bekleyin.
beklerken her anİptal ettiniz POST /v1/withdrawals/{id}/cancel.cancelledwithdrawal.cancelledGeri verin Tutarı müşterinize geri verin.
beklerkenBir kişi reddetti rejection_reason: declined (Cryptogon ya da panelinizden bir kullanıcı; en az tutarı artık karşılamayan TRON çekimi de).rejectedwithdrawal.rejectedGeri verin Tutarı müşterinize geri verin.
12 dakikadan sonra, çoğunlukla bir dakika içindeSüre doldu rejection_reason: insufficient_funds, rate_unavailable, service_unavailable ya da internal_error. Sonradan hiçbir koşulda ödenmez.rejectedwithdrawal.rejectedGeri 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 fees null’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_BALANCE alı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 da internal_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 da test_ ve ardından 30 harf ve rakam, 35 karakter): her istekte açık gider. Canlı ortam yalnızca live_, sandbox yalnızca test_ 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
readYatırma talebi, ödeme oturumu, çekim ve para birimlerini okuma; çekim teklifi
depositYatı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
settlementHesaplaşma için ayrıldı (henüz yok)
her yetkiGET /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 UNAUTHORIZED alır.
  • Anahtar, imza denetimimizle isteğinizin bitişi arasında kapanırsa istek 401 UNAUTHORIZED alır ve hiçbir şey yazılmaz; yeni anahtarla yeniden deneyin.

İsteği imzalama

Her istekte üç başlık bulunur:

BaşlıkDeğer
X-Cryptogon-KeyAnahtar kimliğiniz
X-Cryptogon-TimestampUnix zamanı, tam saniye; saatimizden en çok 5 dakika farklı olabilir
X-Cryptogon-Signaturev1= + 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).

İmzalanan metin
<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)>
İstek başlıkları
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/json zorunludur (değilse 415); gövde en çok 64 KB olabilir (değilse 413).
  • 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ı

  1. Sunucu adı: 421 MISDIRECTED_REQUEST.
  2. İstemci adresi başına istek sayısı (imza denetlenmeden önce): 429 RATE_LIMITED.
  3. Gövde türü ve boyutu: 415 ya da 413, ikisi de INVALID_REQUEST koduyla.
  4. Başlıklar, anahtar ve imza: 401 UNAUTHORIZED.
  5. Siteniz etkin: 403 SITE_NOT_ACTIVE.
  6. Anahtarın yetkisi var: 403 INSUFFICIENT_SCOPE.
  7. İstek izinli bir adresten geliyor: 403 IP_NOT_ALLOWED.
  8. Gövde bir JSON nesnesi: 400 INVALID_REQUEST.
  9. Site başına istek sayısı: 429 RATE_LIMITED.
  10. Alanlar, Idempotency-Key ve 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 (iptalde 200), tekrarlar 200.
  • 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ıt 200 ile döner; iki istek aynı anda gelse bile. Aynı referans farklı içerikle gelirse 409 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; oturumda player_id, currency, amount, options; çekimde player_id, network, asset, address (sağlama toplamı biçimine çevrilmiş) ve amount. expires_in karşı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ırDakikadaSayılan
İstemci adresi başına1.800Her istek, imza denetlenmeden önce. Sürüm 6 adresler /64 ağı başına sayılır
Site başına1.200Sitenizin imzalı her isteği
Site başına, açan istekler300POST /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.

Yetki
her anahtar
Yanıt
{
  "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.

Yetki
her anahtar
Yanıt
{
  "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_usd borsa fiyatıdır. 1 USD’den %1 ya da daha fazla saparsa available false olur ve o varlıkta yeni yatırma 503 ASSET_PAUSED alır.
  • Native coin’in (ETH, BNB, TRX) güvenilir kuru yoksa usd null olur ve yeni istek 503 RATE_UNAVAILABLE alır.

GET/v1/currencies

Sitenizin ödeme oturumunda kabul ettiği fiat para birimleri.

Yetki
read ya da deposit
Yanıt
{
  "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.

Yetki
deposit
İstek
{
  "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
}
AlanKural
merchant_referenceZorunlu. İşlem kimliğiniz, site başına tekil (yatırma talepleriyle ortak)
player_idZorunlu. Müşteri için sizin kimliğiniz; müşterinin yatırma adresleri bu kimlik için kalıcıdır
currencyZorunlu. 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_inMüşterinin seçim süresi, saniye: 300–1800, varsayılan 1800
Yanıt · 201 Created
{
  "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):

JSON
"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 basis identity’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_at eksi 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ğinde address null olur.

payment oturumu ödeyen yatırmadır (kesinleşmeden önce görülen ilk ödeme); extra_payments aynı biçimdedir:

JSON
"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 önce null. basis: locked, identity (kripto oturum), confirm_rate (geç ödeme) ya da unavailable (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 da hold_reason ile held (extra_payment, late_payment, no_valuation). held’i asla hesaba geçirmeyin.
  • commission: yatırma komisyonumuz, ödemenin kendi coininde alınır. order_value brüt kalır; bakiyeniz net kadar 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.

Yetki
read ya da deposit

POST/v1/deposits

Sizin seçtiğiniz varlıkta yatırma talebi açın.

Yetki
deposit
İstek
{
  "merchant_reference": "order-1001",
  "player_id": "customer-42",
  "network": "bsc",
  "asset": "USDT",
  "amount": "100.5",
  "expires_in": 1800
}
  • amount isteğ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 talep expired kapanır ve yenisi açılır.
  • Adres göstermek durdurulmuşken yeni talep de tekrarı da 503 SERVICE_PAUSED alır.
Yanıt · 201 Created
{
  "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’de rate: null (1 USD).
  • Transfer. Bir transfer görülünce transfer alanı tx_hash, amount (gelen), status, variance, credit_status (pending, credited, failed), detected_at, confirmed_at ve commission gösterir.
  • Komisyon. Yatırma kesinleşince transfer.commission komisyonumuzu yatırmanın coininde gösterir; bakiyeniz net kadar artar. amount brüt kalır.
  • Adres. Transferi olmayan açık talepte adres göstermek durdurulmuşken ya da site etkin değilken address null’dır. Talep kapandıktan sonra ödeme linki 24 saat yalnızca durumu gösterir, sonra 404 döner.
transfer.commission
"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.

Yetki
read ya da deposit

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.

Yetki
deposit
İstek
{ "network": "tron" }
Yanıt
{ "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.

Yetki
read ya da withdraw
İstek
{ "network": "tron", "asset": "USDT", "amount": "100" }
Yanıt
{
  "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_net hep "0"’dır (eski istemciler için duruyor).
  • Teklif saklanmaz: ücret çekim kabul edilirken yeniden hesaplanır. Şu an hesaplanamıyorsa: 503 FEE_UNAVAILABLE ve Retry-After.

POST/v1/withdrawals

Müşterinizin adresine kripto gönderin.

Yetki
withdraw
İstek
{
  "merchant_reference": "payout-5001",
  "player_id": "customer-42",
  "network": "bsc",
  "asset": "USDT",
  "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
  "amount": "10"
}
Yanıt · 201 Created
{
  "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 reason ile 422 INVALID_ADDRESS (format, checksum ya da network). Küçük harfli EVM adresi kabul edilir ve EIP-55 biçiminde saklanır. Kendi yatırma adreslerimiz ve token kontratları reason olmadan 422 INVALID_ADDRESS ile reddedilir.
  • merchant_reference cg: 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 bakiyenize amount − player_network_fee döner.
TRON’da fees
"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.

Yetki
read ya da withdraw

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.

Bölünmüş çekim, bir parçadan sonra alıcı adres engellendi
{
  "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.

Yetki
withdraw
  • Çekimi artık cancelled olarak 200 ile döner ve withdrawal.cancelled gö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 de 409 alır.
  • Aynı Idempotency-Key ile tekrarı güncel durumu 200 ile 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 https olmalı, 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 2xx dö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 (id aynı): bir kez işleyin. Olaylar sırasız gelebilir: aynı kaynak için daha önce işlediğinizden küçük resource_version’lı olayı yok sayın.

Yeniden denemeler

DenemeÖnceki başarısızlıktan sonra beklemeOlaydan yaklaşık bu kadar sonra
1—saniyeler içinde
21 dakika1 dakika
35 dakika6 dakika
415 dakika21 dakika
51 saat1 saat 21 dakika
63 saat4 saat 21 dakika
7, 8, 9 …her biri 6 saat10 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

Webhook isteği
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

Node.js
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);
}
Python
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
<?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

JSON
{
  "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).

bakiye beklemesinden sonra withdrawal.rejected
{
  "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ürNe zaman
payment.detectedOturuma bir ödeme zincirde görüldü, kesinleşmedi
payment.confirmedOturumu ödeyen ödeme kesinleşti; kazanan data.payment’ta. Buna 2xx dönmeniz bakiyenize geçişi başlatır
payment.extraBir ö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.droppedGörülen ödeme kesinleşmeden düştü
payment.expiredOturumun süresi doldu, ödeme gelmedi
deposit.detectedYatırma talebine bir transfer zincirde görüldü
deposit.confirmedKesinleşti. Tutar farkı data.transfer.variance’ta. Buna 2xx dönmeniz net tutarın bakiyenize geçişini başlatır
deposit.droppedGörülen transfer kesinleşmeden düştü; talep açık kalır
deposit.expiredTalebin süresi doldu, ödeme gelmedi
withdrawal.pending_approvalKarar bekliyor. Çekim sizin incelemenizden Cryptogon’a geçince yeniden gönderilir
withdrawal.sentAğa gönderildi (data.tx_hash; bölünmüş çekimde ilk parçada bir kez, bkz. data.parts)
withdrawal.completedZincirde kesinleşti
withdrawal.partially_completedAlı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.rejectedGö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.failedGönderilemedi ya da zincirde başarısız oldu; kilit çözüldü
withdrawal.cancelledİmzadan önce sizin tarafınızdan iptal edildi
site.fundedSite bakiyenize kasa yüklemesi kesinleşti ve yazıldı (komisyon yok)
site.funding_heldKasa yüklemesi kesinleşti ama bekletildi (data.hold_reason); neden değişirse yeniden gelir
credit.requested … credit.written_offKredinin 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.confirmed ya da payment.confirmed) adresinizin 2xx döndüğü kesin yatırmaların net tutarını bakiyenize geçiririz. Sonra credit_status credited olur ve commission.credited_at yazılır. Gövde gönderim anında kurulduğu için olayın kendisinde credited_at: null gö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_status failed olur 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:

  1. data.payment ve data.extra_payments içindeki her ödemeye bakın. Yalnızca status: confirmed ve credit_status değeri pending ya da credited olanı hesaba geçirin. Tutar sipariş tutarı değil, ödemenin order_value.value’sudur.
  2. 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çince credit_status pending’den credited’a döner. Serbest bırakılan ek ödeme aynı merchant_reference için ikinci bir hesaba geçirmedir.
  3. credit_status: held olan ödemeyi asla hesaba geçirmeyin; tanımadığınız bir değeri de geçirmeyin. failed yalnızca olayımızın size ulaşmadığını söyler; yeniden teslim edilene kadar bekleyin.
  4. 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.

JSON
{ "error": { "code": "INVALID_ADDRESS", "message": "…", "reason": "checksum" } }
HTTPcodeNe zaman
400INVALID_REQUESTGö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
400INVALID_AMOUNTSayı olarak, sıfır, fazla ondalıkla ya da (oturumda) para biriminin küsuratına uymayan tutar
400IDEMPOTENCY_KEY_REQUIRED, INVALID_IDEMPOTENCY_KEYBaşlık yok ya da biçimi yanlış
401UNAUTHORIZEDEksik 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
403SITE_NOT_ACTIVESiteniz etkin değil (askıda ya da kapalı)
403INSUFFICIENT_SCOPEAnahtarın bu uç noktaya yetkisi yok
403IP_NOT_ALLOWEDİstek anahtarın listesinde olmayan bir adresten geldi
404NOT_FOUNDBilinmeyen yol, UUID olmayan kimlik, var olmayan ya da başka sitenin kaydı
409DUPLICATE_REFERENCEmerchant_reference farklı içerikle (ya da yatırma talebi için bir oturumda, tersi de) zaten kullanılmış
409OPEN_DEPOSIT_EXISTSMüşterinin bu varlıkta açık talebi ya da oturum adresi var
409INVALID_STATEİptal mümkün değil: imza başladı, çekim kesinleşti ya da durumu aynı anda değişti
413INVALID_REQUESTGövde 64 KB’tan büyük
415INVALID_REQUESTContent-Type application/json değil
421MISDIRECTED_REQUESTSunucu adı API adreslerimizden biri değil
422ASSET_NOT_AVAILABLEAğ ya da varlık bu ortamda ya da sitenizde açık değil
422INVALID_ADDRESSHedef adres geçersiz (reason: format, checksum, network) ya da kendi adreslerimizden biri veya bir token kontratı (reason yok)
422INSUFFICIENT_NETWORK_BALANCEÇekim; yalnızca bakiye beklemesi kapalı sitede. required, available, fee, network_reserve taşır
422AMOUNT_TOO_SMALLTRON ç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
422CURRENCY_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
422IDEMPOTENCY_KEY_REUSEDIdempotency-Key farklı bir istekle kullanılmış
429RATE_LIMITEDÇok fazla istek; Retry-After saniye sonra yeniden deneyin
500INTERNALBizim tarafımızda beklenmeyen hata; hiçbir şey yazılmaz. Aynı Idempotency-Key ile yeniden deneyin
503SERVICE_PAUSEDCryptogon adres göstermeyi durdurdu: yatırma talebi, oturum ve müşteri adresi
503ADDRESS_NOT_READYMüşterinin adresi henüz hazır değil
503RATE_UNAVAILABLEGüncel kur yok: native coin yatırmasında ya da çekim ücreti için
503ASSET_PAUSEDStablecoin sabitinden saptı; o varlıkta yeni yatırma durduruldu
503FEE_UNAVAILABLE, FX_UNAVAILABLETRON 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

Node.js
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 here
Python
import 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
<?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 here
cURL
API=${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

Node.js
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);
}
Python
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
<?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.

TarihDeğişiklik
2026-10-19Bö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-18Bö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-18Belge 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-18Anahtar kapatma 1–7 gün bekleyebilir; yeni anahtara kesintisiz geçersiniz. “Hemen kapat” durur (Anahtar yenileme ve kapatma).
2026-10-18Adres başına istek sınırı sürüm 6 adresleri /64 ağı başına sayar.
2026-10-18Cryptogon ç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-16Her 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-15Aynı 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-14Bakiye 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-14429 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-10TRON ç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-09Yatı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-07Yatı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-05checkout_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-04Webhook’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.